@23blocks/jsonapi-codec 1.0.3 → 2.0.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./src/index";

package/dist/index.esm.js

@@ -0,0 +1,182 @@
+import { _ } from '@swc/helpers/_/_extends';
+import { BlockErrorException } from '@23blocks/contracts';
+
+/**
+ * Type guard for single resource document
+ */ function isSingleResourceDocument(doc) {
+    return doc.data !== null && doc.data !== undefined && !Array.isArray(doc.data);
+}
+/**
+ * Type guard for collection resource document
+ */ function isCollectionDocument(doc) {
+    return Array.isArray(doc.data);
+}
+/**
+ * Type guard for error document
+ */ function isErrorDocument(doc) {
+    return Array.isArray(doc.errors) && doc.errors.length > 0;
+}
+
+/**
+ * Create a key for the included map
+ */ function resourceKey(type, id) {
+    return `${type}:${id}`;
+}
+/**
+ * Build an included map from an array of resources
+ */ function buildIncludedMap(included = []) {
+    const map = new Map();
+    for (const resource of included){
+        map.set(resourceKey(resource.type, resource.id), resource);
+    }
+    return map;
+}
+/**
+ * Get a resource from the included map
+ */ function getIncluded(included, type, id) {
+    return included.get(resourceKey(type, id));
+}
+/**
+ * Resolve a relationship from included resources
+ */ function resolveRelationship(resource, relationshipName, included, mapper) {
+    var _resource_relationships;
+    const relationship = (_resource_relationships = resource.relationships) == null ? void 0 : _resource_relationships[relationshipName];
+    if (!(relationship == null ? void 0 : relationship.data)) {
+        return null;
+    }
+    const data = relationship.data;
+    if (Array.isArray(data)) {
+        throw new Error(`Expected single relationship for '${relationshipName}', got array. Use resolveRelationshipMany instead.`);
+    }
+    const related = getIncluded(included, data.type, data.id);
+    if (!related) {
+        return null;
+    }
+    return mapper.map(related, included);
+}
+/**
+ * Resolve a has-many relationship from included resources
+ */ function resolveRelationshipMany(resource, relationshipName, included, mapper) {
+    var _resource_relationships;
+    const relationship = (_resource_relationships = resource.relationships) == null ? void 0 : _resource_relationships[relationshipName];
+    if (!(relationship == null ? void 0 : relationship.data)) {
+        return [];
+    }
+    const data = relationship.data;
+    if (!Array.isArray(data)) {
+        throw new Error(`Expected array relationship for '${relationshipName}', got single. Use resolveRelationship instead.`);
+    }
+    return data.map((identifier)=>{
+        const related = getIncluded(included, identifier.type, identifier.id);
+        if (!related) {
+            return null;
+        }
+        return mapper.map(related, included);
+    }).filter((item)=>item !== null);
+}
+
+/**
+ * Decode a single resource from a JSON:API document
+ */ function decodeOne(document, mapper) {
+    if (!isSingleResourceDocument(document)) {
+        throw new Error('Expected single resource document');
+    }
+    const included = buildIncludedMap(document.included);
+    return mapper.map(document.data, included);
+}
+/**
+ * Decode a single resource from a JSON:API document, returning null if not found
+ */ function decodeOneOrNull(document, mapper) {
+    if (!document.data || Array.isArray(document.data)) {
+        return null;
+    }
+    const included = buildIncludedMap(document.included);
+    return mapper.map(document.data, included);
+}
+/**
+ * Decode multiple resources from a JSON:API document
+ */ function decodeMany(document, mapper) {
+    if (!isCollectionDocument(document)) {
+        throw new Error('Expected collection document');
+    }
+    const included = buildIncludedMap(document.included);
+    return document.data.map((resource)=>mapper.map(resource, included));
+}
+/**
+ * Extract pagination metadata from JSON:API meta
+ */ function extractPageMeta(meta) {
+    var _meta_current_page, _meta_total_pages, _meta_total_count, _meta_per_page;
+    return {
+        currentPage: (_meta_current_page = meta == null ? void 0 : meta.current_page) != null ? _meta_current_page : 1,
+        totalPages: (_meta_total_pages = meta == null ? void 0 : meta.total_pages) != null ? _meta_total_pages : 1,
+        totalCount: (_meta_total_count = meta == null ? void 0 : meta.total_count) != null ? _meta_total_count : 0,
+        perPage: (_meta_per_page = meta == null ? void 0 : meta.per_page) != null ? _meta_per_page : 0
+    };
+}
+/**
+ * Decode a paginated collection from a JSON:API document
+ */ function decodePageResult(document, mapper) {
+    const data = isCollectionDocument(document) ? decodeMany(document, mapper) : [];
+    return {
+        data,
+        meta: extractPageMeta(document.meta)
+    };
+}
+/**
+ * Decode with a custom decoder function
+ */ function decodeWith(document, decoder) {
+    const included = buildIncludedMap(document.included);
+    return decoder(document, included);
+}
+
+/**
+ * Convert a JSON:API error to a BlockError
+ */ function jsonApiErrorToBlockError(error) {
+    var _error_source, _error_source1;
+    var _error_code, _error_detail, _ref, _error_source_pointer;
+    return {
+        code: (_error_code = error.code) != null ? _error_code : 'unknown_error',
+        message: (_ref = (_error_detail = error.detail) != null ? _error_detail : error.title) != null ? _ref : 'An unknown error occurred',
+        status: error.status ? parseInt(error.status, 10) : 500,
+        source: (_error_source_pointer = (_error_source = error.source) == null ? void 0 : _error_source.pointer) != null ? _error_source_pointer : (_error_source1 = error.source) == null ? void 0 : _error_source1.parameter,
+        meta: error.meta
+    };
+}
+/**
+ * Convert multiple JSON:API errors to a single BlockError
+ * Uses the first error as the primary error, includes others in meta
+ */ function jsonApiErrorsToBlockError(errors) {
+    if (errors.length === 0) {
+        return {
+            code: 'unknown_error',
+            message: 'An unknown error occurred',
+            status: 500
+        };
+    }
+    const primary = jsonApiErrorToBlockError(errors[0]);
+    if (errors.length > 1) {
+        primary.meta = _({}, primary.meta, {
+            additionalErrors: errors.slice(1).map(jsonApiErrorToBlockError)
+        });
+    }
+    return primary;
+}
+/**
+ * Create a BlockErrorException from JSON:API errors
+ */ function blockErrorFromJsonApi(errors) {
+    return new BlockErrorException(jsonApiErrorsToBlockError(errors));
+}
+/**
+ * Check if a document is an error document and throw if so
+ */ function throwIfError(document) {
+    if (isErrorDocument(document)) {
+        throw blockErrorFromJsonApi(document.errors);
+    }
+}
+/**
+ * Assert that a document is not an error document
+ */ function assertNotError(document) {
+    throwIfError(document);
+}
+
+export { assertNotError, blockErrorFromJsonApi, buildIncludedMap, decodeMany, decodeOne, decodeOneOrNull, decodePageResult, decodeWith, extractPageMeta, getIncluded, isCollectionDocument, isErrorDocument, isSingleResourceDocument, jsonApiErrorToBlockError, jsonApiErrorsToBlockError, resolveRelationship, resolveRelationshipMany, resourceKey, throwIfError };

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export { type JsonApiResource, type JsonApiRelationship, type JsonApiResourceIdentifier, type JsonApiLinks, type JsonApiLink, type JsonApiError, type JsonApiDocument, type JsonApiMeta, isSingleResourceDocument, isCollectionDocument, isErrorDocument, } from './lib/types.js';
+export { type IncludedMap, type ResourceMapper, resourceKey, buildIncludedMap, getIncluded, resolveRelationship, resolveRelationshipMany, } from './lib/mapper.js';
+export { decodeOne, decodeOneOrNull, decodeMany, extractPageMeta, decodePageResult, decodeWith, } from './lib/decode.js';
+export { jsonApiErrorToBlockError, jsonApiErrorsToBlockError, blockErrorFromJsonApi, throwIfError, assertNotError, } from './lib/errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/src/lib/decode.d.ts

@@ -0,0 +1,28 @@
+import type { PageResult, PageMeta } from '@23blocks/contracts';
+import type { JsonApiDocument, JsonApiMeta } from './types.js';
+import type { ResourceMapper, IncludedMap } from './mapper.js';
+/**
+ * Decode a single resource from a JSON:API document
+ */
+export declare function decodeOne<T>(document: JsonApiDocument, mapper: ResourceMapper<T>): T;
+/**
+ * Decode a single resource from a JSON:API document, returning null if not found
+ */
+export declare function decodeOneOrNull<T>(document: JsonApiDocument, mapper: ResourceMapper<T>): T | null;
+/**
+ * Decode multiple resources from a JSON:API document
+ */
+export declare function decodeMany<T>(document: JsonApiDocument, mapper: ResourceMapper<T>): T[];
+/**
+ * Extract pagination metadata from JSON:API meta
+ */
+export declare function extractPageMeta(meta?: JsonApiMeta): PageMeta;
+/**
+ * Decode a paginated collection from a JSON:API document
+ */
+export declare function decodePageResult<T>(document: JsonApiDocument, mapper: ResourceMapper<T>): PageResult<T>;
+/**
+ * Decode with a custom decoder function
+ */
+export declare function decodeWith<T>(document: JsonApiDocument, decoder: (doc: JsonApiDocument, included: IncludedMap) => T): T;
+//# sourceMappingURL=decode.d.ts.map

package/dist/src/lib/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../../src/lib/decode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/D;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,CAAC,CAOH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,CAAC,GAAG,IAAI,CAOV;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,CAAC,EAAE,CAOL;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,CAO5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,UAAU,CAAC,CAAC,CAAC,CASf;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,KAAK,CAAC,GAC1D,CAAC,CAGH"}

package/dist/src/lib/errors.d.ts

@@ -0,0 +1,24 @@
+import { BlockErrorException, type BlockError } from '@23blocks/contracts';
+import type { JsonApiDocument, JsonApiError } from './types.js';
+/**
+ * Convert a JSON:API error to a BlockError
+ */
+export declare function jsonApiErrorToBlockError(error: JsonApiError): BlockError;
+/**
+ * Convert multiple JSON:API errors to a single BlockError
+ * Uses the first error as the primary error, includes others in meta
+ */
+export declare function jsonApiErrorsToBlockError(errors: JsonApiError[]): BlockError;
+/**
+ * Create a BlockErrorException from JSON:API errors
+ */
+export declare function blockErrorFromJsonApi(errors: JsonApiError[]): BlockErrorException;
+/**
+ * Check if a document is an error document and throw if so
+ */
+export declare function throwIfError(document: JsonApiDocument): void;
+/**
+ * Assert that a document is not an error document
+ */
+export declare function assertNotError<T extends JsonApiDocument>(document: T): asserts document is T;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGhE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAQxE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,CAmB5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAEjF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAI5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,eAAe,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAE5F"}

package/dist/src/lib/mapper.d.ts

@@ -0,0 +1,40 @@
+import type { JsonApiResource } from './types.js';
+/**
+ * Included resources map for efficient relationship resolution
+ */
+export type IncludedMap = Map<string, JsonApiResource>;
+/**
+ * Resource mapper interface
+ * Each block provides mappers for its resource types
+ */
+export interface ResourceMapper<T> {
+    /** JSON:API resource type this mapper handles */
+    type: string;
+    /**
+     * Map a JSON:API resource to a domain object
+     * @param resource - The JSON:API resource to map
+     * @param included - Map of included resources for relationship resolution
+     */
+    map(resource: JsonApiResource, included: IncludedMap): T;
+}
+/**
+ * Create a key for the included map
+ */
+export declare function resourceKey(type: string, id: string): string;
+/**
+ * Build an included map from an array of resources
+ */
+export declare function buildIncludedMap(included?: JsonApiResource[]): IncludedMap;
+/**
+ * Get a resource from the included map
+ */
+export declare function getIncluded(included: IncludedMap, type: string, id: string): JsonApiResource | undefined;
+/**
+ * Resolve a relationship from included resources
+ */
+export declare function resolveRelationship<T>(resource: JsonApiResource, relationshipName: string, included: IncludedMap, mapper: ResourceMapper<T>): T | null;
+/**
+ * Resolve a has-many relationship from included resources
+ */
+export declare function resolveRelationshipMany<T>(resource: JsonApiResource, relationshipName: string, included: IncludedMap, mapper: ResourceMapper<T>): T[];
+//# sourceMappingURL=mapper.d.ts.map

package/dist/src/lib/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/lib/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,GAAG,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,eAAe,EAAO,GAAG,WAAW,CAM9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,eAAe,GAAG,SAAS,CAE7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,QAAQ,EAAE,eAAe,EACzB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,CAAC,GAAG,IAAI,CAmBV;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,QAAQ,EAAE,eAAe,EACzB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,CAAC,EAAE,CAsBL"}

package/dist/src/lib/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * JSON:API Resource Object
+ * @see https://jsonapi.org/format/#document-resource-objects
+ */
+export interface JsonApiResource<TAttributes = Record<string, unknown>> {
+    /** Resource type */
+    type: string;
+    /** Resource ID */
+    id: string;
+    /** Resource attributes */
+    attributes?: TAttributes;
+    /** Resource relationships */
+    relationships?: Record<string, JsonApiRelationship>;
+    /** Resource links */
+    links?: JsonApiLinks;
+    /** Resource meta */
+    meta?: Record<string, unknown>;
+}
+/**
+ * JSON:API Relationship Object
+ * @see https://jsonapi.org/format/#document-resource-object-relationships
+ */
+export interface JsonApiRelationship {
+    /** Relationship data */
+    data: JsonApiResourceIdentifier | JsonApiResourceIdentifier[] | null;
+    /** Relationship links */
+    links?: JsonApiLinks;
+    /** Relationship meta */
+    meta?: Record<string, unknown>;
+}
+/**
+ * JSON:API Resource Identifier Object
+ * @see https://jsonapi.org/format/#document-resource-identifier-objects
+ */
+export interface JsonApiResourceIdentifier {
+    /** Resource type */
+    type: string;
+    /** Resource ID */
+    id: string;
+    /** Identifier meta */
+    meta?: Record<string, unknown>;
+}
+/**
+ * JSON:API Links Object
+ * @see https://jsonapi.org/format/#document-links
+ */
+export interface JsonApiLinks {
+    self?: string | JsonApiLink;
+    related?: string | JsonApiLink;
+    first?: string | JsonApiLink | null;
+    last?: string | JsonApiLink | null;
+    prev?: string | JsonApiLink | null;
+    next?: string | JsonApiLink | null;
+    [key: string]: string | JsonApiLink | null | undefined;
+}
+/**
+ * JSON:API Link Object
+ * @see https://jsonapi.org/format/#document-links
+ */
+export interface JsonApiLink {
+    href: string;
+    rel?: string;
+    describedby?: string;
+    title?: string;
+    type?: string;
+    hreflang?: string | string[];
+    meta?: Record<string, unknown>;
+}
+/**
+ * JSON:API Error Object
+ * @see https://jsonapi.org/format/#error-objects
+ */
+export interface JsonApiError {
+    /** Unique identifier for this error */
+    id?: string;
+    /** Links related to the error */
+    links?: {
+        about?: string | JsonApiLink;
+        type?: string | JsonApiLink;
+    };
+    /** HTTP status code */
+    status?: string;
+    /** Application-specific error code */
+    code?: string;
+    /** Short summary of the error */
+    title?: string;
+    /** Detailed explanation of the error */
+    detail?: string;
+    /** Source of the error */
+    source?: {
+        pointer?: string;
+        parameter?: string;
+        header?: string;
+    };
+    /** Error meta */
+    meta?: Record<string, unknown>;
+}
+/**
+ * JSON:API Document
+ * @see https://jsonapi.org/format/#document-structure
+ */
+export interface JsonApiDocument<TAttributes = Record<string, unknown>> {
+    /** Primary data */
+    data?: JsonApiResource<TAttributes> | JsonApiResource<TAttributes>[] | null;
+    /** Included resources */
+    included?: JsonApiResource[];
+    /** Errors */
+    errors?: JsonApiError[];
+    /** Top-level meta */
+    meta?: JsonApiMeta;
+    /** Top-level links */
+    links?: JsonApiLinks;
+    /** JSON:API version info */
+    jsonapi?: {
+        version?: string;
+        ext?: string[];
+        profile?: string[];
+        meta?: Record<string, unknown>;
+    };
+}
+/**
+ * JSON:API Meta Object (commonly used for pagination)
+ */
+export interface JsonApiMeta {
+    /** Current page number */
+    current_page?: number;
+    /** Total number of pages */
+    total_pages?: number;
+    /** Total count of items */
+    total_count?: number;
+    /** Items per page */
+    per_page?: number;
+    /** Any additional meta fields */
+    [key: string]: unknown;
+}
+/**
+ * Type guard for single resource document
+ */
+export declare function isSingleResourceDocument<T>(doc: JsonApiDocument<T>): doc is JsonApiDocument<T> & {
+    data: JsonApiResource<T>;
+};
+/**
+ * Type guard for collection resource document
+ */
+export declare function isCollectionDocument<T>(doc: JsonApiDocument<T>): doc is JsonApiDocument<T> & {
+    data: JsonApiResource<T>[];
+};
+/**
+ * Type guard for error document
+ */
+export declare function isErrorDocument(doc: JsonApiDocument): doc is JsonApiDocument & {
+    errors: JsonApiError[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACpD,qBAAqB;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,yBAAyB,GAAG,yBAAyB,EAAE,GAAG,IAAI,CAAC;IACrE,yBAAyB;IACzB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;KAC7B,CAAC;IACF,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,mBAAmB;IACnB,IAAI,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,GAAG,eAAe,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC;IAC5E,yBAAyB;IACzB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,aAAa;IACb,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,qBAAqB;IACrB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,4BAA4B;IAC5B,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GACtB,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GACtB,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,eAAe,GACnB,GAAG,IAAI,eAAe,GAAG;IAAE,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAErD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@23blocks/jsonapi-codec",
-  "version": "1.0.3",
+  "version": "2.0.0",
   "description": "JSON:API v1.0 codec for encoding/decoding API responses",
   "license": "MIT",
   "author": "23blocks <hello@23blocks.com>",
@@ -22,15 +22,15 @@
     "parser"
   ],
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
+  "main": "./dist/index.esm.js",
+  "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "import": "./dist/index.esm.js",
+      "default": "./dist/index.esm.js"
     }
   },
   "files": [
@@ -41,7 +41,7 @@
     "sourceRoot": "packages/jsonapi-codec/src",
     "targets": {
       "build": {
-        "executor": "@nx/js:swc",
+        "executor": "@nx/rollup:rollup",
         "outputs": [
           "{options.outputPath}"
         ],
@@ -49,8 +49,10 @@
           "outputPath": "packages/jsonapi-codec/dist",
           "main": "packages/jsonapi-codec/src/index.ts",
           "tsConfig": "packages/jsonapi-codec/tsconfig.lib.json",
-          "skipTypeCheck": true,
-          "stripLeadingPaths": true
+          "compiler": "swc",
+          "format": [
+            "esm"
+          ]
         }
       }
     }

package/dist/index.js

@@ -1,10 +0,0 @@
-// JSON:API Types
-export { isSingleResourceDocument, isCollectionDocument, isErrorDocument } from './lib/types.js';
-// Resource Mapper
-export { resourceKey, buildIncludedMap, getIncluded, resolveRelationship, resolveRelationshipMany } from './lib/mapper.js';
-// Decoding
-export { decodeOne, decodeOneOrNull, decodeMany, extractPageMeta, decodePageResult, decodeWith } from './lib/decode.js';
-// Error Handling
-export { jsonApiErrorToBlockError, jsonApiErrorsToBlockError, blockErrorFromJsonApi, throwIfError, assertNotError } from './lib/errors.js';
-
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// JSON:API Types\nexport {\n  type JsonApiResource,\n  type JsonApiRelationship,\n  type JsonApiResourceIdentifier,\n  type JsonApiLinks,\n  type JsonApiLink,\n  type JsonApiError,\n  type JsonApiDocument,\n  type JsonApiMeta,\n  isSingleResourceDocument,\n  isCollectionDocument,\n  isErrorDocument,\n} from './lib/types.js';\n\n// Resource Mapper\nexport {\n  type IncludedMap,\n  type ResourceMapper,\n  resourceKey,\n  buildIncludedMap,\n  getIncluded,\n  resolveRelationship,\n  resolveRelationshipMany,\n} from './lib/mapper.js';\n\n// Decoding\nexport {\n  decodeOne,\n  decodeOneOrNull,\n  decodeMany,\n  extractPageMeta,\n  decodePageResult,\n  decodeWith,\n} from './lib/decode.js';\n\n// Error Handling\nexport {\n  jsonApiErrorToBlockError,\n  jsonApiErrorsToBlockError,\n  blockErrorFromJsonApi,\n  throwIfError,\n  assertNotError,\n} from './lib/errors.js';\n"],"names":["isSingleResourceDocument","isCollectionDocument","isErrorDocument","resourceKey","buildIncludedMap","getIncluded","resolveRelationship","resolveRelationshipMany","decodeOne","decodeOneOrNull","decodeMany","extractPageMeta","decodePageResult","decodeWith","jsonApiErrorToBlockError","jsonApiErrorsToBlockError","blockErrorFromJsonApi","throwIfError","assertNotError"],"rangeMappings":";;;;;;;","mappings":"AAAA,iBAAiB;AACjB,SASEA,wBAAwB,EACxBC,oBAAoB,EACpBC,eAAe,QACV,iBAAiB;AAExB,kBAAkB;AAClB,SAGEC,WAAW,EACXC,gBAAgB,EAChBC,WAAW,EACXC,mBAAmB,EACnBC,uBAAuB,QAClB,kBAAkB;AAEzB,WAAW;AACX,SACEC,SAAS,EACTC,eAAe,EACfC,UAAU,EACVC,eAAe,EACfC,gBAAgB,EAChBC,UAAU,QACL,kBAAkB;AAEzB,iBAAiB;AACjB,SACEC,wBAAwB,EACxBC,yBAAyB,EACzBC,qBAAqB,EACrBC,YAAY,EACZC,cAAc,QACT,kBAAkB"}

package/dist/lib/decode.js

@@ -1,57 +0,0 @@
-import { isSingleResourceDocument, isCollectionDocument } from './types.js';
-import { buildIncludedMap } from './mapper.js';
-/**
- * Decode a single resource from a JSON:API document
- */ export function decodeOne(document, mapper) {
-    if (!isSingleResourceDocument(document)) {
-        throw new Error('Expected single resource document');
-    }
-    const included = buildIncludedMap(document.included);
-    return mapper.map(document.data, included);
-}
-/**
- * Decode a single resource from a JSON:API document, returning null if not found
- */ export function decodeOneOrNull(document, mapper) {
-    if (!document.data || Array.isArray(document.data)) {
-        return null;
-    }
-    const included = buildIncludedMap(document.included);
-    return mapper.map(document.data, included);
-}
-/**
- * Decode multiple resources from a JSON:API document
- */ export function decodeMany(document, mapper) {
-    if (!isCollectionDocument(document)) {
-        throw new Error('Expected collection document');
-    }
-    const included = buildIncludedMap(document.included);
-    return document.data.map((resource)=>mapper.map(resource, included));
-}
-/**
- * Extract pagination metadata from JSON:API meta
- */ export function extractPageMeta(meta) {
-    var _meta_current_page, _meta_total_pages, _meta_total_count, _meta_per_page;
-    return {
-        currentPage: (_meta_current_page = meta == null ? void 0 : meta.current_page) != null ? _meta_current_page : 1,
-        totalPages: (_meta_total_pages = meta == null ? void 0 : meta.total_pages) != null ? _meta_total_pages : 1,
-        totalCount: (_meta_total_count = meta == null ? void 0 : meta.total_count) != null ? _meta_total_count : 0,
-        perPage: (_meta_per_page = meta == null ? void 0 : meta.per_page) != null ? _meta_per_page : 0
-    };
-}
-/**
- * Decode a paginated collection from a JSON:API document
- */ export function decodePageResult(document, mapper) {
-    const data = isCollectionDocument(document) ? decodeMany(document, mapper) : [];
-    return {
-        data,
-        meta: extractPageMeta(document.meta)
-    };
-}
-/**
- * Decode with a custom decoder function
- */ export function decodeWith(document, decoder) {
-    const included = buildIncludedMap(document.included);
-    return decoder(document, included);
-}
-
-//# sourceMappingURL=decode.js.map

package/dist/lib/decode.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/lib/decode.ts"],"sourcesContent":["import type { PageResult, PageMeta } from '@23blocks/contracts';\nimport type { JsonApiDocument, JsonApiMeta } from './types.js';\nimport { isSingleResourceDocument, isCollectionDocument } from './types.js';\nimport type { ResourceMapper, IncludedMap } from './mapper.js';\nimport { buildIncludedMap } from './mapper.js';\n\n/**\n * Decode a single resource from a JSON:API document\n */\nexport function decodeOne<T>(\n  document: JsonApiDocument,\n  mapper: ResourceMapper<T>\n): T {\n  if (!isSingleResourceDocument(document)) {\n    throw new Error('Expected single resource document');\n  }\n\n  const included = buildIncludedMap(document.included);\n  return mapper.map(document.data, included);\n}\n\n/**\n * Decode a single resource from a JSON:API document, returning null if not found\n */\nexport function decodeOneOrNull<T>(\n  document: JsonApiDocument,\n  mapper: ResourceMapper<T>\n): T | null {\n  if (!document.data || Array.isArray(document.data)) {\n    return null;\n  }\n\n  const included = buildIncludedMap(document.included);\n  return mapper.map(document.data, included);\n}\n\n/**\n * Decode multiple resources from a JSON:API document\n */\nexport function decodeMany<T>(\n  document: JsonApiDocument,\n  mapper: ResourceMapper<T>\n): T[] {\n  if (!isCollectionDocument(document)) {\n    throw new Error('Expected collection document');\n  }\n\n  const included = buildIncludedMap(document.included);\n  return document.data.map((resource) => mapper.map(resource, included));\n}\n\n/**\n * Extract pagination metadata from JSON:API meta\n */\nexport function extractPageMeta(meta?: JsonApiMeta): PageMeta {\n  return {\n    currentPage: meta?.current_page ?? 1,\n    totalPages: meta?.total_pages ?? 1,\n    totalCount: meta?.total_count ?? 0,\n    perPage: meta?.per_page ?? 0,\n  };\n}\n\n/**\n * Decode a paginated collection from a JSON:API document\n */\nexport function decodePageResult<T>(\n  document: JsonApiDocument,\n  mapper: ResourceMapper<T>\n): PageResult<T> {\n  const data = isCollectionDocument(document)\n    ? decodeMany(document, mapper)\n    : [];\n\n  return {\n    data,\n    meta: extractPageMeta(document.meta),\n  };\n}\n\n/**\n * Decode with a custom decoder function\n */\nexport function decodeWith<T>(\n  document: JsonApiDocument,\n  decoder: (doc: JsonApiDocument, included: IncludedMap) => T\n): T {\n  const included = buildIncludedMap(document.included);\n  return decoder(document, included);\n}\n"],"names":["isSingleResourceDocument","isCollectionDocument","buildIncludedMap","decodeOne","document","mapper","Error","included","map","data","decodeOneOrNull","Array","isArray","decodeMany","resource","extractPageMeta","meta","currentPage","current_page","totalPages","total_pages","totalCount","total_count","perPage","per_page","decodePageResult","decodeWith","decoder"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAEA,SAASA,wBAAwB,EAAEC,oBAAoB,QAAQ,aAAa;AAE5E,SAASC,gBAAgB,QAAQ,cAAc;AAE/C;;CAEC,GACD,OAAO,SAASC,UACdC,QAAyB,EACzBC,MAAyB;IAEzB,IAAI,CAACL,yBAAyBI,WAAW;QACvC,MAAM,IAAIE,MAAM;IAClB;IAEA,MAAMC,WAAWL,iBAAiBE,SAASG,QAAQ;IACnD,OAAOF,OAAOG,GAAG,CAACJ,SAASK,IAAI,EAAEF;AACnC;AAEA;;CAEC,GACD,OAAO,SAASG,gBACdN,QAAyB,EACzBC,MAAyB;IAEzB,IAAI,CAACD,SAASK,IAAI,IAAIE,MAAMC,OAAO,CAACR,SAASK,IAAI,GAAG;QAClD,OAAO;IACT;IAEA,MAAMF,WAAWL,iBAAiBE,SAASG,QAAQ;IACnD,OAAOF,OAAOG,GAAG,CAACJ,SAASK,IAAI,EAAEF;AACnC;AAEA;;CAEC,GACD,OAAO,SAASM,WACdT,QAAyB,EACzBC,MAAyB;IAEzB,IAAI,CAACJ,qBAAqBG,WAAW;QACnC,MAAM,IAAIE,MAAM;IAClB;IAEA,MAAMC,WAAWL,iBAAiBE,SAASG,QAAQ;IACnD,OAAOH,SAASK,IAAI,CAACD,GAAG,CAAC,CAACM,WAAaT,OAAOG,GAAG,CAACM,UAAUP;AAC9D;AAEA;;CAEC,GACD,OAAO,SAASQ,gBAAgBC,IAAkB;QAEjCA,oBACDA,mBACAA,mBACHA;IAJX,OAAO;QACLC,aAAaD,CAAAA,qBAAAA,wBAAAA,KAAME,YAAY,YAAlBF,qBAAsB;QACnCG,YAAYH,CAAAA,oBAAAA,wBAAAA,KAAMI,WAAW,YAAjBJ,oBAAqB;QACjCK,YAAYL,CAAAA,oBAAAA,wBAAAA,KAAMM,WAAW,YAAjBN,oBAAqB;QACjCO,SAASP,CAAAA,iBAAAA,wBAAAA,KAAMQ,QAAQ,YAAdR,iBAAkB;IAC7B;AACF;AAEA;;CAEC,GACD,OAAO,SAASS,iBACdrB,QAAyB,EACzBC,MAAyB;IAEzB,MAAMI,OAAOR,qBAAqBG,YAC9BS,WAAWT,UAAUC,UACrB,EAAE;IAEN,OAAO;QACLI;QACAO,MAAMD,gBAAgBX,SAASY,IAAI;IACrC;AACF;AAEA;;CAEC,GACD,OAAO,SAASU,WACdtB,QAAyB,EACzBuB,OAA2D;IAE3D,MAAMpB,WAAWL,iBAAiBE,SAASG,QAAQ;IACnD,OAAOoB,QAAQvB,UAAUG;AAC3B"}

package/dist/lib/errors.js

@@ -1,54 +0,0 @@
-import { _ as _extends } from "@swc/helpers/_/_extends";
-import { BlockErrorException } from '@23blocks/contracts';
-import { isErrorDocument } from './types.js';
-/**
- * Convert a JSON:API error to a BlockError
- */ export function jsonApiErrorToBlockError(error) {
-    var _error_source, _error_source1;
-    var _error_code, _error_detail, _ref, _error_source_pointer;
-    return {
-        code: (_error_code = error.code) != null ? _error_code : 'unknown_error',
-        message: (_ref = (_error_detail = error.detail) != null ? _error_detail : error.title) != null ? _ref : 'An unknown error occurred',
-        status: error.status ? parseInt(error.status, 10) : 500,
-        source: (_error_source_pointer = (_error_source = error.source) == null ? void 0 : _error_source.pointer) != null ? _error_source_pointer : (_error_source1 = error.source) == null ? void 0 : _error_source1.parameter,
-        meta: error.meta
-    };
-}
-/**
- * Convert multiple JSON:API errors to a single BlockError
- * Uses the first error as the primary error, includes others in meta
- */ export function jsonApiErrorsToBlockError(errors) {
-    if (errors.length === 0) {
-        return {
-            code: 'unknown_error',
-            message: 'An unknown error occurred',
-            status: 500
-        };
-    }
-    const primary = jsonApiErrorToBlockError(errors[0]);
-    if (errors.length > 1) {
-        primary.meta = _extends({}, primary.meta, {
-            additionalErrors: errors.slice(1).map(jsonApiErrorToBlockError)
-        });
-    }
-    return primary;
-}
-/**
- * Create a BlockErrorException from JSON:API errors
- */ export function blockErrorFromJsonApi(errors) {
-    return new BlockErrorException(jsonApiErrorsToBlockError(errors));
-}
-/**
- * Check if a document is an error document and throw if so
- */ export function throwIfError(document) {
-    if (isErrorDocument(document)) {
-        throw blockErrorFromJsonApi(document.errors);
-    }
-}
-/**
- * Assert that a document is not an error document
- */ export function assertNotError(document) {
-    throwIfError(document);
-}
-
-//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/lib/errors.ts"],"sourcesContent":["import { BlockErrorException, type BlockError } from '@23blocks/contracts';\nimport type { JsonApiDocument, JsonApiError } from './types.js';\nimport { isErrorDocument } from './types.js';\n\n/**\n * Convert a JSON:API error to a BlockError\n */\nexport function jsonApiErrorToBlockError(error: JsonApiError): BlockError {\n  return {\n    code: error.code ?? 'unknown_error',\n    message: error.detail ?? error.title ?? 'An unknown error occurred',\n    status: error.status ? parseInt(error.status, 10) : 500,\n    source: error.source?.pointer ?? error.source?.parameter,\n    meta: error.meta,\n  };\n}\n\n/**\n * Convert multiple JSON:API errors to a single BlockError\n * Uses the first error as the primary error, includes others in meta\n */\nexport function jsonApiErrorsToBlockError(errors: JsonApiError[]): BlockError {\n  if (errors.length === 0) {\n    return {\n      code: 'unknown_error',\n      message: 'An unknown error occurred',\n      status: 500,\n    };\n  }\n\n  const primary = jsonApiErrorToBlockError(errors[0]);\n\n  if (errors.length > 1) {\n    primary.meta = {\n      ...primary.meta,\n      additionalErrors: errors.slice(1).map(jsonApiErrorToBlockError),\n    };\n  }\n\n  return primary;\n}\n\n/**\n * Create a BlockErrorException from JSON:API errors\n */\nexport function blockErrorFromJsonApi(errors: JsonApiError[]): BlockErrorException {\n  return new BlockErrorException(jsonApiErrorsToBlockError(errors));\n}\n\n/**\n * Check if a document is an error document and throw if so\n */\nexport function throwIfError(document: JsonApiDocument): void {\n  if (isErrorDocument(document)) {\n    throw blockErrorFromJsonApi(document.errors);\n  }\n}\n\n/**\n * Assert that a document is not an error document\n */\nexport function assertNotError<T extends JsonApiDocument>(document: T): asserts document is T {\n  throwIfError(document);\n}\n"],"names":["BlockErrorException","isErrorDocument","jsonApiErrorToBlockError","error","code","message","detail","title","status","parseInt","source","pointer","parameter","meta","jsonApiErrorsToBlockError","errors","length","primary","additionalErrors","slice","map","blockErrorFromJsonApi","throwIfError","document","assertNotError"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":";AAAA,SAASA,mBAAmB,QAAyB,sBAAsB;AAE3E,SAASC,eAAe,QAAQ,aAAa;AAE7C;;CAEC,GACD,OAAO,SAASC,yBAAyBC,KAAmB;QAKhDA,eAAyBA;QAH3BA,aACGA,eAAAA,MAEDA;IAJV,OAAO;QACLC,MAAMD,CAAAA,cAAAA,MAAMC,IAAI,YAAVD,cAAc;QACpBE,SAASF,CAAAA,OAAAA,CAAAA,gBAAAA,MAAMG,MAAM,YAAZH,gBAAgBA,MAAMI,KAAK,YAA3BJ,OAA+B;QACxCK,QAAQL,MAAMK,MAAM,GAAGC,SAASN,MAAMK,MAAM,EAAE,MAAM;QACpDE,QAAQP,CAAAA,yBAAAA,gBAAAA,MAAMO,MAAM,qBAAZP,cAAcQ,OAAO,YAArBR,yBAAyBA,iBAAAA,MAAMO,MAAM,qBAAZP,eAAcS,SAAS;QACxDC,MAAMV,MAAMU,IAAI;IAClB;AACF;AAEA;;;CAGC,GACD,OAAO,SAASC,0BAA0BC,MAAsB;IAC9D,IAAIA,OAAOC,MAAM,KAAK,GAAG;QACvB,OAAO;YACLZ,MAAM;YACNC,SAAS;YACTG,QAAQ;QACV;IACF;IAEA,MAAMS,UAAUf,yBAAyBa,MAAM,CAAC,EAAE;IAElD,IAAIA,OAAOC,MAAM,GAAG,GAAG;QACrBC,QAAQJ,IAAI,GAAG,aACVI,QAAQJ,IAAI;YACfK,kBAAkBH,OAAOI,KAAK,CAAC,GAAGC,GAAG,CAAClB;;IAE1C;IAEA,OAAOe;AACT;AAEA;;CAEC,GACD,OAAO,SAASI,sBAAsBN,MAAsB;IAC1D,OAAO,IAAIf,oBAAoBc,0BAA0BC;AAC3D;AAEA;;CAEC,GACD,OAAO,SAASO,aAAaC,QAAyB;IACpD,IAAItB,gBAAgBsB,WAAW;QAC7B,MAAMF,sBAAsBE,SAASR,MAAM;IAC7C;AACF;AAEA;;CAEC,GACD,OAAO,SAASS,eAA0CD,QAAW;IACnED,aAAaC;AACf"}

package/dist/lib/mapper.js

@@ -1,59 +0,0 @@
-/**
- * Create a key for the included map
- */ export function resourceKey(type, id) {
-    return `${type}:${id}`;
-}
-/**
- * Build an included map from an array of resources
- */ export function buildIncludedMap(included = []) {
-    const map = new Map();
-    for (const resource of included){
-        map.set(resourceKey(resource.type, resource.id), resource);
-    }
-    return map;
-}
-/**
- * Get a resource from the included map
- */ export function getIncluded(included, type, id) {
-    return included.get(resourceKey(type, id));
-}
-/**
- * Resolve a relationship from included resources
- */ export function resolveRelationship(resource, relationshipName, included, mapper) {
-    var _resource_relationships;
-    const relationship = (_resource_relationships = resource.relationships) == null ? void 0 : _resource_relationships[relationshipName];
-    if (!(relationship == null ? void 0 : relationship.data)) {
-        return null;
-    }
-    const data = relationship.data;
-    if (Array.isArray(data)) {
-        throw new Error(`Expected single relationship for '${relationshipName}', got array. Use resolveRelationshipMany instead.`);
-    }
-    const related = getIncluded(included, data.type, data.id);
-    if (!related) {
-        return null;
-    }
-    return mapper.map(related, included);
-}
-/**
- * Resolve a has-many relationship from included resources
- */ export function resolveRelationshipMany(resource, relationshipName, included, mapper) {
-    var _resource_relationships;
-    const relationship = (_resource_relationships = resource.relationships) == null ? void 0 : _resource_relationships[relationshipName];
-    if (!(relationship == null ? void 0 : relationship.data)) {
-        return [];
-    }
-    const data = relationship.data;
-    if (!Array.isArray(data)) {
-        throw new Error(`Expected array relationship for '${relationshipName}', got single. Use resolveRelationship instead.`);
-    }
-    return data.map((identifier)=>{
-        const related = getIncluded(included, identifier.type, identifier.id);
-        if (!related) {
-            return null;
-        }
-        return mapper.map(related, included);
-    }).filter((item)=>item !== null);
-}
-
-//# sourceMappingURL=mapper.js.map

package/dist/lib/mapper.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/lib/mapper.ts"],"sourcesContent":["import type { JsonApiResource } from './types.js';\n\n/**\n * Included resources map for efficient relationship resolution\n */\nexport type IncludedMap = Map<string, JsonApiResource>;\n\n/**\n * Resource mapper interface\n * Each block provides mappers for its resource types\n */\nexport interface ResourceMapper<T> {\n  /** JSON:API resource type this mapper handles */\n  type: string;\n\n  /**\n   * Map a JSON:API resource to a domain object\n   * @param resource - The JSON:API resource to map\n   * @param included - Map of included resources for relationship resolution\n   */\n  map(resource: JsonApiResource, included: IncludedMap): T;\n}\n\n/**\n * Create a key for the included map\n */\nexport function resourceKey(type: string, id: string): string {\n  return `${type}:${id}`;\n}\n\n/**\n * Build an included map from an array of resources\n */\nexport function buildIncludedMap(included: JsonApiResource[] = []): IncludedMap {\n  const map = new Map<string, JsonApiResource>();\n  for (const resource of included) {\n    map.set(resourceKey(resource.type, resource.id), resource);\n  }\n  return map;\n}\n\n/**\n * Get a resource from the included map\n */\nexport function getIncluded(\n  included: IncludedMap,\n  type: string,\n  id: string\n): JsonApiResource | undefined {\n  return included.get(resourceKey(type, id));\n}\n\n/**\n * Resolve a relationship from included resources\n */\nexport function resolveRelationship<T>(\n  resource: JsonApiResource,\n  relationshipName: string,\n  included: IncludedMap,\n  mapper: ResourceMapper<T>\n): T | null {\n  const relationship = resource.relationships?.[relationshipName];\n  if (!relationship?.data) {\n    return null;\n  }\n\n  const data = relationship.data;\n  if (Array.isArray(data)) {\n    throw new Error(\n      `Expected single relationship for '${relationshipName}', got array. Use resolveRelationshipMany instead.`\n    );\n  }\n\n  const related = getIncluded(included, data.type, data.id);\n  if (!related) {\n    return null;\n  }\n\n  return mapper.map(related, included);\n}\n\n/**\n * Resolve a has-many relationship from included resources\n */\nexport function resolveRelationshipMany<T>(\n  resource: JsonApiResource,\n  relationshipName: string,\n  included: IncludedMap,\n  mapper: ResourceMapper<T>\n): T[] {\n  const relationship = resource.relationships?.[relationshipName];\n  if (!relationship?.data) {\n    return [];\n  }\n\n  const data = relationship.data;\n  if (!Array.isArray(data)) {\n    throw new Error(\n      `Expected array relationship for '${relationshipName}', got single. Use resolveRelationship instead.`\n    );\n  }\n\n  return data\n    .map((identifier) => {\n      const related = getIncluded(included, identifier.type, identifier.id);\n      if (!related) {\n        return null;\n      }\n      return mapper.map(related, included);\n    })\n    .filter((item): item is T => item !== null);\n}\n"],"names":["resourceKey","type","id","buildIncludedMap","included","map","Map","resource","set","getIncluded","get","resolveRelationship","relationshipName","mapper","relationship","relationships","data","Array","isArray","Error","related","resolveRelationshipMany","identifier","filter","item"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAuBA;;CAEC,GACD,OAAO,SAASA,YAAYC,IAAY,EAAEC,EAAU;IAClD,OAAO,CAAC,EAAED,KAAK,CAAC,EAAEC,GAAG,CAAC;AACxB;AAEA;;CAEC,GACD,OAAO,SAASC,iBAAiBC,WAA8B,EAAE;IAC/D,MAAMC,MAAM,IAAIC;IAChB,KAAK,MAAMC,YAAYH,SAAU;QAC/BC,IAAIG,GAAG,CAACR,YAAYO,SAASN,IAAI,EAAEM,SAASL,EAAE,GAAGK;IACnD;IACA,OAAOF;AACT;AAEA;;CAEC,GACD,OAAO,SAASI,YACdL,QAAqB,EACrBH,IAAY,EACZC,EAAU;IAEV,OAAOE,SAASM,GAAG,CAACV,YAAYC,MAAMC;AACxC;AAEA;;CAEC,GACD,OAAO,SAASS,oBACdJ,QAAyB,EACzBK,gBAAwB,EACxBR,QAAqB,EACrBS,MAAyB;QAEJN;IAArB,MAAMO,gBAAeP,0BAAAA,SAASQ,aAAa,qBAAtBR,uBAAwB,CAACK,iBAAiB;IAC/D,IAAI,EAACE,gCAAAA,aAAcE,IAAI,GAAE;QACvB,OAAO;IACT;IAEA,MAAMA,OAAOF,aAAaE,IAAI;IAC9B,IAAIC,MAAMC,OAAO,CAACF,OAAO;QACvB,MAAM,IAAIG,MACR,CAAC,kCAAkC,EAAEP,iBAAiB,kDAAkD,CAAC;IAE7G;IAEA,MAAMQ,UAAUX,YAAYL,UAAUY,KAAKf,IAAI,EAAEe,KAAKd,EAAE;IACxD,IAAI,CAACkB,SAAS;QACZ,OAAO;IACT;IAEA,OAAOP,OAAOR,GAAG,CAACe,SAAShB;AAC7B;AAEA;;CAEC,GACD,OAAO,SAASiB,wBACdd,QAAyB,EACzBK,gBAAwB,EACxBR,QAAqB,EACrBS,MAAyB;QAEJN;IAArB,MAAMO,gBAAeP,0BAAAA,SAASQ,aAAa,qBAAtBR,uBAAwB,CAACK,iBAAiB;IAC/D,IAAI,EAACE,gCAAAA,aAAcE,IAAI,GAAE;QACvB,OAAO,EAAE;IACX;IAEA,MAAMA,OAAOF,aAAaE,IAAI;IAC9B,IAAI,CAACC,MAAMC,OAAO,CAACF,OAAO;QACxB,MAAM,IAAIG,MACR,CAAC,iCAAiC,EAAEP,iBAAiB,+CAA+C,CAAC;IAEzG;IAEA,OAAOI,KACJX,GAAG,CAAC,CAACiB;QACJ,MAAMF,UAAUX,YAAYL,UAAUkB,WAAWrB,IAAI,EAAEqB,WAAWpB,EAAE;QACpE,IAAI,CAACkB,SAAS;YACZ,OAAO;QACT;QACA,OAAOP,OAAOR,GAAG,CAACe,SAAShB;IAC7B,GACCmB,MAAM,CAAC,CAACC,OAAoBA,SAAS;AAC1C"}

package/dist/lib/types.js

@@ -1,20 +0,0 @@
-/**
- * JSON:API Resource Object
- * @see https://jsonapi.org/format/#document-resource-objects
- */ /**
- * Type guard for single resource document
- */ export function isSingleResourceDocument(doc) {
-    return doc.data !== null && doc.data !== undefined && !Array.isArray(doc.data);
-}
-/**
- * Type guard for collection resource document
- */ export function isCollectionDocument(doc) {
-    return Array.isArray(doc.data);
-}
-/**
- * Type guard for error document
- */ export function isErrorDocument(doc) {
-    return Array.isArray(doc.errors) && doc.errors.length > 0;
-}
-
-//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/lib/types.ts"],"sourcesContent":["/**\n * JSON:API Resource Object\n * @see https://jsonapi.org/format/#document-resource-objects\n */\nexport interface JsonApiResource<TAttributes = Record<string, unknown>> {\n  /** Resource type */\n  type: string;\n  /** Resource ID */\n  id: string;\n  /** Resource attributes */\n  attributes?: TAttributes;\n  /** Resource relationships */\n  relationships?: Record<string, JsonApiRelationship>;\n  /** Resource links */\n  links?: JsonApiLinks;\n  /** Resource meta */\n  meta?: Record<string, unknown>;\n}\n\n/**\n * JSON:API Relationship Object\n * @see https://jsonapi.org/format/#document-resource-object-relationships\n */\nexport interface JsonApiRelationship {\n  /** Relationship data */\n  data: JsonApiResourceIdentifier | JsonApiResourceIdentifier[] | null;\n  /** Relationship links */\n  links?: JsonApiLinks;\n  /** Relationship meta */\n  meta?: Record<string, unknown>;\n}\n\n/**\n * JSON:API Resource Identifier Object\n * @see https://jsonapi.org/format/#document-resource-identifier-objects\n */\nexport interface JsonApiResourceIdentifier {\n  /** Resource type */\n  type: string;\n  /** Resource ID */\n  id: string;\n  /** Identifier meta */\n  meta?: Record<string, unknown>;\n}\n\n/**\n * JSON:API Links Object\n * @see https://jsonapi.org/format/#document-links\n */\nexport interface JsonApiLinks {\n  self?: string | JsonApiLink;\n  related?: string | JsonApiLink;\n  first?: string | JsonApiLink | null;\n  last?: string | JsonApiLink | null;\n  prev?: string | JsonApiLink | null;\n  next?: string | JsonApiLink | null;\n  [key: string]: string | JsonApiLink | null | undefined;\n}\n\n/**\n * JSON:API Link Object\n * @see https://jsonapi.org/format/#document-links\n */\nexport interface JsonApiLink {\n  href: string;\n  rel?: string;\n  describedby?: string;\n  title?: string;\n  type?: string;\n  hreflang?: string | string[];\n  meta?: Record<string, unknown>;\n}\n\n/**\n * JSON:API Error Object\n * @see https://jsonapi.org/format/#error-objects\n */\nexport interface JsonApiError {\n  /** Unique identifier for this error */\n  id?: string;\n  /** Links related to the error */\n  links?: {\n    about?: string | JsonApiLink;\n    type?: string | JsonApiLink;\n  };\n  /** HTTP status code */\n  status?: string;\n  /** Application-specific error code */\n  code?: string;\n  /** Short summary of the error */\n  title?: string;\n  /** Detailed explanation of the error */\n  detail?: string;\n  /** Source of the error */\n  source?: {\n    pointer?: string;\n    parameter?: string;\n    header?: string;\n  };\n  /** Error meta */\n  meta?: Record<string, unknown>;\n}\n\n/**\n * JSON:API Document\n * @see https://jsonapi.org/format/#document-structure\n */\nexport interface JsonApiDocument<TAttributes = Record<string, unknown>> {\n  /** Primary data */\n  data?: JsonApiResource<TAttributes> | JsonApiResource<TAttributes>[] | null;\n  /** Included resources */\n  included?: JsonApiResource[];\n  /** Errors */\n  errors?: JsonApiError[];\n  /** Top-level meta */\n  meta?: JsonApiMeta;\n  /** Top-level links */\n  links?: JsonApiLinks;\n  /** JSON:API version info */\n  jsonapi?: {\n    version?: string;\n    ext?: string[];\n    profile?: string[];\n    meta?: Record<string, unknown>;\n  };\n}\n\n/**\n * JSON:API Meta Object (commonly used for pagination)\n */\nexport interface JsonApiMeta {\n  /** Current page number */\n  current_page?: number;\n  /** Total number of pages */\n  total_pages?: number;\n  /** Total count of items */\n  total_count?: number;\n  /** Items per page */\n  per_page?: number;\n  /** Any additional meta fields */\n  [key: string]: unknown;\n}\n\n/**\n * Type guard for single resource document\n */\nexport function isSingleResourceDocument<T>(\n  doc: JsonApiDocument<T>\n): doc is JsonApiDocument<T> & { data: JsonApiResource<T> } {\n  return doc.data !== null && doc.data !== undefined && !Array.isArray(doc.data);\n}\n\n/**\n * Type guard for collection resource document\n */\nexport function isCollectionDocument<T>(\n  doc: JsonApiDocument<T>\n): doc is JsonApiDocument<T> & { data: JsonApiResource<T>[] } {\n  return Array.isArray(doc.data);\n}\n\n/**\n * Type guard for error document\n */\nexport function isErrorDocument(\n  doc: JsonApiDocument\n): doc is JsonApiDocument & { errors: JsonApiError[] } {\n  return Array.isArray(doc.errors) && doc.errors.length > 0;\n}\n"],"names":["isSingleResourceDocument","doc","data","undefined","Array","isArray","isCollectionDocument","isErrorDocument","errors","length"],"rangeMappings":";;;;;;;;;;;;;;;;;","mappings":"AAAA;;;CAGC,GA4ID;;CAEC,GACD,OAAO,SAASA,yBACdC,GAAuB;IAEvB,OAAOA,IAAIC,IAAI,KAAK,QAAQD,IAAIC,IAAI,KAAKC,aAAa,CAACC,MAAMC,OAAO,CAACJ,IAAIC,IAAI;AAC/E;AAEA;;CAEC,GACD,OAAO,SAASI,qBACdL,GAAuB;IAEvB,OAAOG,MAAMC,OAAO,CAACJ,IAAIC,IAAI;AAC/B;AAEA;;CAEC,GACD,OAAO,SAASK,gBACdN,GAAoB;IAEpB,OAAOG,MAAMC,OAAO,CAACJ,IAAIO,MAAM,KAAKP,IAAIO,MAAM,CAACC,MAAM,GAAG;AAC1D"}