{"version":3,"file":"jsonapi.cjs","sources":["../src/jsonapi/actions/context/enhancers/fieldsFor.ts","../src/jsonapi/actions/context/enhancers/fields.ts","../src/jsonapi/actions/context/enhancers/filterBy.ts","../src/jsonapi/actions/context/enhancers/paginate.ts","../src/jsonapi/actions/context/enhancers/sortBy.ts","../src/jsonapi/actions/context/enhancers/sortByDesc.ts","../src/jsonapi/actions/context/runners/usingDocument.ts","../src/jsonapi/jsonApiDeserializer.ts","../src/jsonapi/jsonApiSerializer.ts"],"sourcesContent":["import {\n  Action,\n  ActionParsedExtension,\n  makeEnhancersExtension,\n  Model,\n  ModelKey,\n  normalizeKey,\n} from '@/core';\nimport { param } from '@/http';\nimport consumePrevParams from '@/http/actions/context/consumers/consumePrevParams';\nimport { ArrayableVariadic, optionalJoin, uniqueValues, wrapVariadic } from '@/utilities';\n\n/**\n * [Select the given JSON:API fieldsets](https://jsonapi.org/format/#fetching-sparse-fieldsets)\n * for the given model. The new fieldsets will be merged with the previous ones.\n *\n * @param model\n * @param fieldset\n *\n * @category Enhancers\n */\nexport default function fieldsFor<C extends {}, M extends Model>(\n  model: M,\n  ...fieldset: ArrayableVariadic<ModelKey<M>>\n) {\n  return async (action: Action<C>) => {\n    const context = await action.useContext();\n    const prevFields = consumePrevParams(context, null)?.fields;\n    const nextFields = wrapVariadic(...fieldset).map((key) => normalizeKey(model, key));\n\n    return action.use(param('fields', {\n      ...prevFields,\n      [model.$type]: optionalJoin(uniqueValues([\n        ...(prevFields ?? {})[model.$type],\n        ...nextFields,\n      ]), ','),\n    }));\n  };\n}\n\ntype FieldsForEnhancerExtension = ActionParsedExtension<{\n  fieldsFor<C extends {}, E extends {}, M extends Model>(\n    this: Action<C, E>,\n    model: M,\n    ...fieldset: ArrayableVariadic<ModelKey<M>>\n  ): Action<C, E>;\n}>;\n\nfieldsFor.extension = makeEnhancersExtension({ fieldsFor }) as FieldsForEnhancerExtension;\n","import {\n  Action,\n  ActionParsedExtension,\n  ConsumeModel,\n  consumeModel,\n  makeEnhancersExtension,\n  Model,\n  ModelKey,\n} from '@/core';\nimport fieldsFor from '@/jsonapi/actions/context/enhancers/fieldsFor';\nimport { ArrayableVariadic } from '@/utilities';\n\n/**\n * [Select the given JSON:API fieldsets](https://jsonapi.org/format/#fetching-sparse-fieldsets)\n * for the current context's model.\n * The new fieldsets will be merged with the previous ones.\n *\n * @param fieldset\n *\n * @category Enhancers\n */\nexport default function fields<C extends {}, M extends Model>(\n  ...fieldset: ArrayableVariadic<ModelKey<M>>\n) {\n  return async (action: Action<C & ConsumeModel<M>>) => {\n    const model = consumeModel(await action.useContext());\n\n    return action.use(fieldsFor(model, ...fieldset));\n  };\n}\n\ntype FieldsEnhancerExtension = ActionParsedExtension<{\n  fields<C extends {}, E extends {}, M extends Model>(\n    this: Action<C, E>,\n    ...fieldset: ArrayableVariadic<ModelKey<M>>\n  ): Action<C, E>;\n}>;\n\nfields.extension = makeEnhancersExtension({ fields }) as FieldsEnhancerExtension;\n","import { Action, ActionParsedExtension, makeEnhancersExtension } from '@/core';\nimport { param } from '@/http';\nimport consumePrevParams from '@/http/actions/context/consumers/consumePrevParams';\nimport { Dictionary } from '@/utilities';\n\n/**\n * [Filter the JSON:API resource](https://jsonapi.org/format/#fetching-filtering)\n * by the given key and value.\n * When key is an object, it will spread the object as a filter values map.\n * The new filter will be merged with the previous ones.\n *\n * @param key\n * @param value\n *\n * @category Enhancers\n */\nexport default function filterBy(key: string | Dictionary, value?: unknown) {\n  return async <C extends {}>(action: Action<C>) => action.use(param('filter', {\n    ...consumePrevParams(await action.useContext(), null)?.filter,\n    ...(typeof key === 'string' ? { [key]: value } : key),\n  }));\n}\n\ntype FilterByEnhancerExtension = ActionParsedExtension<{\n  filterBy<C extends {}, E extends {}>(\n    this: Action<C, E>,\n    key: string | Dictionary,\n    value?: unknown,\n  ): Action<C, E>;\n}>;\n\nfilterBy.extension = makeEnhancersExtension({ filterBy }) as FilterByEnhancerExtension;\n","import { Action, ActionParsedExtension, makeEnhancersExtension } from '@/core';\nimport { param } from '@/http';\n\n/**\n * [Paginate the JSON:API resource](https://jsonapi.org/format/#fetching-pagination)\n * by the given params.\n * JSON:API specification on pagination is agnostic, so page params may be\n * anything used by your implementation.\n *\n * @param page\n *\n * @category Enhancers\n */\nexport default function paginate(page: unknown) {\n  return param('page', page);\n}\n\ntype PaginateEnhancerExtension = ActionParsedExtension<{\n  paginate<C extends {}, E extends {}>(\n    this: Action<C, E>,\n    page: unknown,\n  ): Action<C, E>;\n}>;\n\npaginate.extension = makeEnhancersExtension({ paginate }) as PaginateEnhancerExtension;\n","import { Action, ActionParsedExtension, makeEnhancersExtension } from '@/core';\nimport { param } from '@/http';\nimport consumePrevParams from '@/http/actions/context/consumers/consumePrevParams';\nimport { optionalJoin, uniqueValues, wrap } from '@/utilities';\n\n/**\n * [Sort the JSON:API resource](https://jsonapi.org/format/#fetching-sorting)\n * by the given key and direction.\n * The new sort will be merged with the previous ones.\n * Sorts priority are kept.\n *\n * @param key\n * @param direction\n *\n * @category Enhancers\n */\nexport default function sortBy(key: string | string[], direction: 'asc' | 'desc' = 'asc') {\n  return async <C extends {}>(action: Action<C>) => action.use(param(\n    'sort',\n    optionalJoin(uniqueValues([\n      consumePrevParams(await action.useContext(), null)?.sort,\n      ...wrap(key).map((k) => `${direction === 'desc' ? '-' : ''}${k}`),\n    ]), ','),\n  ));\n}\n\ntype SortByEnhancerExtension = ActionParsedExtension<{\n  sortBy<C extends {}, E extends {}>(\n    this: Action<C, E>,\n    key: string | string[],\n    direction?: 'asc' | 'desc',\n  ): Action<C, E>;\n}>;\n\nsortBy.extension = makeEnhancersExtension({ sortBy }) as SortByEnhancerExtension;\n","import { Action, ActionParsedExtension, makeEnhancersExtension } from '@/core';\nimport sortBy from '@/jsonapi/actions/context/enhancers/sortBy';\n\n/**\n * Shortcut for the {@link sortBy} function with a desc direction.\n *\n * @param key\n *\n * @category Enhancers\n */\nexport default function sortByDesc(key: string | string[]) {\n  return sortBy(key, 'desc');\n}\n\ntype SortByDescEnhancerExtension = ActionParsedExtension<{\n  sortByDesc<C extends {}, E extends {}>(\n    this: Action<C, E>,\n    key: string | string[],\n  ): Action<C, E>;\n}>;\n\nsortByDesc.extension = makeEnhancersExtension({ sortByDesc }) as SortByDescEnhancerExtension;\n","import { AllData, ModelInstance, OneData } from '@/core';\nimport { JsonApiDeserializedData } from '@/jsonapi/jsonApiDeserializer';\n\n/**\n * Append the JSON:API document object to data object.\n * Use it as the parameter of `allUsing` and `oneUsing` runners.\n *\n * @param data\n */\nexport default function usingDocument<\n  I extends ModelInstance,\n  DD extends JsonApiDeserializedData<I>,\n  D extends OneData<Response, DD, I> | AllData<Response, DD, I>,\n>(data: D) {\n  return {\n    ...data,\n    document: data.deserialized.document,\n  };\n}\n","import { DeserializedData, DeserializerError, ModelId, ModelInstance } from '@/core';\nimport { ObjectDeserializer, ObjectExtractedData } from '@/object';\nimport { JsonApiDocument, JsonApiNewResource, JsonApiResource, JsonApiResourceIdentifier } from '@/jsonapi/types';\nimport { IdentifiersMap, wrap } from '@/utilities';\n\n/**\n * Extracted data from a JSON:API backend Response object.\n */\nexport type JsonApiExtractedData = ObjectExtractedData<JsonApiNewResource> & {\n  included: IdentifiersMap<string, ModelId, JsonApiResource>;\n  document: JsonApiDocument;\n  response: Response;\n};\n\n/**\n * Deserialized data from a JSON:API backend Response object.\n */\nexport type JsonApiDeserializedData<I extends ModelInstance = ModelInstance> =\n  & DeserializedData<I>\n  & { document: JsonApiDocument; response: Response; };\n\n/**\n * Deserializer implementation for JSON:API.\n */\nexport default class JsonApiDeserializer extends ObjectDeserializer\n  <Response, JsonApiNewResource, JsonApiExtractedData, JsonApiDeserializedData> {\n  /**\n   * @inheritDoc\n   */\n  protected async makeDeserializedData(\n    instances: ModelInstance[],\n    extractedData: JsonApiExtractedData,\n  ) {\n    return {\n      instances,\n      document: extractedData.document,\n      response: extractedData.response,\n    };\n  }\n\n  /**\n   * @inheritDoc\n   */\n  protected async extractData(response: Response) {\n    const document: JsonApiDocument = response.status === 204 ? {} : await response.json();\n\n    const included = new IdentifiersMap<string, ModelId, JsonApiResource>();\n    document.included?.map((r) => included.set(r.type, r.id, r));\n\n    return {\n      resources: document.data,\n      included,\n      document,\n      response,\n    };\n  }\n\n  /**\n   * @inheritDoc\n   */\n  protected async extractOptionalIdentifier(resource: JsonApiNewResource) {\n    return resource;\n  }\n\n  /**\n   * @inheritDoc\n   */\n  protected async extractAttributeValue(\n    _extractedData: JsonApiExtractedData,\n    resource: JsonApiNewResource,\n    serializedKey: string,\n  ) {\n    return resource.attributes?.[serializedKey];\n  }\n\n  /**\n   * @inheritDoc\n   */\n  protected async extractRelationValue(\n    extractedData: JsonApiExtractedData,\n    resource: JsonApiNewResource,\n    serializedKey: string,\n  ) {\n    const relationRef = resource.relationships?.[serializedKey]?.data;\n    if (Array.isArray(relationRef)) {\n      return relationRef.map((r) => this.extractIncluded(extractedData, r));\n    }\n\n    if (relationRef) {\n      return this.extractIncluded(extractedData, relationRef);\n    }\n\n    return relationRef;\n  }\n\n  /**\n   * Extract an included JSON:API resource from extracted data.\n   *\n   * @param extractedData\n   * @param identifier\n   */\n  protected extractIncluded(\n    extractedData: JsonApiExtractedData,\n    identifier: JsonApiResourceIdentifier,\n  ) {\n    const includedResource = extractedData.included.get(identifier.type, identifier.id);\n    if (includedResource) {\n      return includedResource;\n    }\n\n    const rootResource = wrap(extractedData.resources).find(\n      (r) => (r.type === identifier.type && r.id === identifier.id),\n    );\n    if (rootResource) {\n      return rootResource;\n    }\n\n    throw new DeserializerError(\n      `Could not find included resource with type \\`${identifier.type}\\` and ID \\`${identifier.id}\\`. Your document seems malformed.`,\n    );\n  }\n}\n","import { ModelId, ModelInstance, ModelRelation } from '@/core';\nimport { JsonApiDocument, JsonApiNewResource } from '@/jsonapi/types';\nimport { ObjectSerializer } from '@/object';\nimport { isNil, Optional } from '@/utilities';\n\n/**\n * Serializer implementation for JSON:API.\n */\nexport default class JsonApiSerializer extends ObjectSerializer<JsonApiDocument> {\n  /**\n   * @inheritDoc\n   */\n  protected async makeResource(instance: ModelInstance) {\n    return {\n      data: {\n        ...this.serializeInstanceIdentifier(instance),\n        attributes: {},\n        relationships: {},\n      },\n    };\n  }\n\n  /**\n   * @inheritDoc\n   */\n  protected async hydrateAttributeInResource(\n    resource: JsonApiDocument,\n    serializedKey: string,\n    serializedValue: unknown,\n  ) {\n    Object.assign((resource.data as JsonApiNewResource)!.attributes!, {\n      [serializedKey]: serializedValue,\n    });\n  }\n\n  /**\n   * @inheritDoc\n   */\n  protected async hydrateRelationInResource(\n    resource: JsonApiDocument,\n    serializedKey: string,\n    serializedValue: unknown,\n  ) {\n    Object.assign((resource.data as JsonApiNewResource)!.relationships!, {\n      [serializedKey]: { data: serializedValue },\n    });\n  }\n\n  /**\n   * @inheritDoc\n   */\n  protected async serializeRelatedInstance(\n    _instance: ModelInstance,\n    _def: ModelRelation,\n    related: ModelInstance,\n  ) {\n    return this.serializeInstanceIdentifier(related);\n  }\n\n  /**\n   * Serialize an instance unique identifier object.\n   *\n   * @param instance\n   */\n  protected serializeInstanceIdentifier(instance: ModelInstance) {\n    return {\n      type: instance.$model.$type,\n      id: this.serializeId(instance.id),\n      lid: this.serializeId(instance.lid),\n    };\n  }\n\n  /**\n   * Serialize an instance's ID.\n   *\n   * @param id\n   */\n  protected serializeId(id?: Optional<ModelId>) {\n    return isNil(id) ? undefined : String(id);\n  }\n}\n"],"names":["consumePrevParams","wrapVariadic","normalizeKey","param","optionalJoin","uniqueValues","makeEnhancersExtension","consumeModel","wrap","ObjectDeserializer","IdentifiersMap","DeserializerError","ObjectSerializer","isNil"],"mappings":"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"}