@jsonapi-serde/integration-taxum 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2025-present, Ben Scholzen 'DASPRiD'
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,22 @@
+# JSON:API Serde - Taxum Integration
+
+[![Test](https://github.com/DASPRiD/jsonapi-serde-js/actions/workflows/test.yml/badge.svg)](https://github.com/DASPRiD/jsonapi-serde-js/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/DASPRiD/jsonapi-serde-js/graph/badge.svg?token=UfRUzGqiN3&component=integration_taxum)](https://codecov.io/gh/DASPRiD/jsonapi-serde-js)
+
+---
+
+[Taxum](https://taxum.js.org/) integration for [@jsonapi-serde/server](https://github.com/dasprid/jsonapi-serde-js).
+
+## Documentation
+
+To check out docs, visit [jsonapi-serde.js.org](https://jsonapi-serde.js.org).
+
+## Changelog
+
+Detailed changes for each release are documented in the [CHANGELOG](https://github.com/dasprid/jsonapi-serde-js/blob/main/packages/integration/taxum/CHANGELOG.md)
+
+## License
+
+[BSD-3-Clause](https://github.com/dasprid/jsonapi-serde-js/blob/main/LICENSE)
+
+Copyright (c) 2025-present, Ben Scholzen 'DASPRiD'

package/dist/augment.d.ts

@@ -0,0 +1,7 @@
+import { type ToHttpResponse } from "@taxum/core/http";
+declare module "@jsonapi-serde/server/common" {
+    interface JsonApiDocument extends ToHttpResponse {
+    }
+    interface JsonApiError extends ToHttpResponse {
+    }
+}

package/dist/augment.js

@@ -0,0 +1,19 @@
+import { JsonApiDocument, JsonApiError } from "@jsonapi-serde/server/common";
+import { HttpResponse, TO_HTTP_RESPONSE } from "@taxum/core/http";
+import { JSON_API_VERIFY_ACCEPT_MEDIA_TYPE } from "./layer.js";
+JsonApiDocument.prototype[TO_HTTP_RESPONSE] = function () {
+    const response = HttpResponse.builder()
+        .status(this.getStatus())
+        .header("content-type", this.getContentType())
+        .body(JSON.stringify(this.getBody()));
+    // We build a minimal new document here so that the GC can
+    // immediately dispose of the original document.
+    const miniDocument = new JsonApiDocument(EMPTY_TOP_LEVEL_MEMBERS, undefined, this.getMediaTypeOptions());
+    response.extensions.insert(JSON_API_VERIFY_ACCEPT_MEDIA_TYPE, miniDocument.verifyAcceptMediaType.bind(miniDocument));
+    return response;
+};
+JsonApiError.prototype[TO_HTTP_RESPONSE] = function () {
+    return this.toDocument()[TO_HTTP_RESPONSE]();
+};
+const EMPTY_TOP_LEVEL_MEMBERS = { meta: {} };
+//# sourceMappingURL=augment.js.map

package/dist/augment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment.js","sourceRoot":"","sources":["../src/augment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAwB,MAAM,8BAA8B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAuB,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAO9D,eAAe,CAAC,SAAuC,CAAC,gBAAgB,CAAC,GAAG;IAGzE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE;SAClC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;SACxB,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;SAC7C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAE1C,0DAA0D;IAC1D,gDAAgD;IAChD,MAAM,YAAY,GAAG,IAAI,eAAe,CACpC,uBAAuB,EACvB,SAAS,EACT,IAAI,CAAC,mBAAmB,EAAE,CAC7B,CAAC;IAEF,QAAQ,CAAC,UAAU,CAAC,MAAM,CACtB,iCAAiC,EACjC,YAAY,CAAC,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CACxD,CAAC;IAEF,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAED,YAAY,CAAC,SAAuC,CAAC,gBAAgB,CAAC,GAAG;IAGtE,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,uBAAuB,GAAoB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC"}

package/dist/error-handler.d.ts

@@ -0,0 +1,14 @@
+import "./augment.js";
+import { type ErrorHandler } from "@taxum/core/util";
+export type JsonApiErrorHandlerOptions = {
+    /**
+     * Optional error logger callback.
+     */
+    logError?: (error: unknown, exposed: boolean) => void;
+};
+/**
+ * Error handler which converts any error into a JSON:API error response.
+ *
+ * Supports optional error logging via the `logError` callback.
+ */
+export declare const jsonApiErrorHandler: (options?: JsonApiErrorHandlerOptions) => ErrorHandler;

package/dist/error-handler.js

@@ -0,0 +1,96 @@
+import "./augment.js";
+import { JsonApiError } from "@jsonapi-serde/server/common";
+import { ValidationError } from "@taxum/core/extract";
+import { TO_HTTP_RESPONSE } from "@taxum/core/http";
+import { ClientError } from "@taxum/core/util";
+/**
+ * Maps various error types to a JSON:API error object.
+ *
+ * Determines if the error details can be safely exposed to clients.
+ */
+const getJsonApiError = (error) => {
+    if (error instanceof ValidationError) {
+        return [
+            new JsonApiError(error.issues.map((issue) => {
+                return {
+                    status: error.source === "body" ? "422" : "400",
+                    code: "validation_failed",
+                    title: "Validation failed",
+                    detail: error.message,
+                    source: getStandardSchemaSource(error.source, issue.path),
+                };
+            })),
+            true,
+        ];
+    }
+    if (error instanceof ClientError) {
+        return [
+            new JsonApiError({
+                status: error.status.code.toString(),
+                code: error.status.phrase.toLowerCase().replace(/ /g, "_"),
+                title: error.status.phrase,
+                detail: error.message,
+            }),
+            true,
+        ];
+    }
+    if (error instanceof Error &&
+        "status" in error &&
+        typeof error.status === "number" &&
+        error.status >= 400 &&
+        error.status < 500) {
+        return [
+            new JsonApiError({
+                status: error.status.toString(),
+                code: error.name
+                    .replace(/Error$/, "")
+                    .replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)
+                    .replace(/^_+|_+$/g, ""),
+                title: error.message,
+            }),
+            true,
+        ];
+    }
+    if (error instanceof JsonApiError) {
+        return [error, error.status < 500];
+    }
+    return [
+        new JsonApiError({
+            status: "500",
+            code: "internal_server_error",
+            title: "Internal Server Error",
+        }),
+        false,
+    ];
+};
+const getStandardSchemaSource = (source, path) => {
+    if (!path || source === "path") {
+        return undefined;
+    }
+    if (source === "body") {
+        return { pointer: `/${path.join("/")}` };
+    }
+    if (path.length === 0) {
+        return undefined;
+    }
+    if (source === "header") {
+        return typeof path[0] === "string" ? { header: path[0] } : undefined;
+    }
+    return {
+        parameter: `${path[0].toString()}${path
+            .slice(1)
+            .map((element) => `[${element.toString()}]`)
+            .join()}`,
+    };
+};
+/**
+ * Error handler which converts any error into a JSON:API error response.
+ *
+ * Supports optional error logging via the `logError` callback.
+ */
+export const jsonApiErrorHandler = (options) => (error) => {
+    const [jsonApiError, exposed] = getJsonApiError(error);
+    options?.logError?.(error, exposed);
+    return jsonApiError[TO_HTTP_RESPONSE]();
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/extract.d.ts

@@ -0,0 +1,28 @@
+import { type AttributesSchema, type IncludedTypeSchemas, type ParseQueryResult, type ParseResourceRequestOptions, type ParseResourceRequestResult, type QueryParser, type RelationshipsSchema, type SparseFieldSets } from "@jsonapi-serde/server/request";
+import type { Extractor } from "@taxum/core/extract";
+import { z } from "zod";
+import type { $ZodType } from "zod/v4/core";
+/**
+ * Extractor which extracts query params based on a JSON:API query parser.
+ *
+ * @see {@link QueryParser}
+ */
+export declare const jsonApiQuery: <TInclude extends readonly string[] | undefined, TSortFields extends readonly string[] | undefined, TSparseFieldSets extends SparseFieldSets | undefined, TFilterSchema extends $ZodType | undefined, TPageSchema extends $ZodType | undefined>(parse: QueryParser<TInclude, TSortFields, TSparseFieldSets, TFilterSchema, TPageSchema>) => Extractor<ParseQueryResult<TInclude, TSortFields, TSparseFieldSets, TFilterSchema, TPageSchema>>;
+/**
+ * Extractor which extracts a JSON:API resource from the body.
+ *
+ * @see {@link parseResourceRequest}
+ */
+export declare const jsonApiResource: <TIdSchema extends $ZodType<string> | undefined, TType extends string, TAttributesSchema extends AttributesSchema | undefined, TRelationshipsSchema extends RelationshipsSchema | undefined, TIncludedTypeSchemas extends IncludedTypeSchemas | undefined>(options: ParseResourceRequestOptions<TIdSchema, TType, TAttributesSchema, TRelationshipsSchema, TIncludedTypeSchemas>, idPathParam?: string) => Extractor<ParseResourceRequestResult<NoInfer<TIdSchema>, NoInfer<TType>, NoInfer<TAttributesSchema>, NoInfer<TRelationshipsSchema>, NoInfer<TIncludedTypeSchemas>>>;
+/**
+ * Extractor which extracts a to-one JSON:API relationship from the body.
+ *
+ * @see {@link parseRelationshipRequest}
+ */
+export declare const jsonApiRelationship: <TIdSchema extends $ZodType<string | null> | undefined>(type: string, idSchema?: TIdSchema) => Extractor<TIdSchema extends $ZodType<string | null> ? z.output<NoInfer<TIdSchema>> : string>;
+/**
+ * Extractor which extracts to-many JSON:API relationships from the body.
+ *
+ * @see {@link parseRelationshipsRequest}
+ */
+export declare const jsonApiRelationships: (type: string, idSchema?: $ZodType<string>) => Extractor<string[]>;

package/dist/extract.js

@@ -0,0 +1,66 @@
+import assert from "node:assert/strict";
+import consumers from "node:stream/consumers";
+import { parseRelationshipRequest, parseRelationshipsRequest, parseResourceRequest, } from "@jsonapi-serde/server/request";
+import { PATH_PARAMS } from "@taxum/core/routing";
+import { z } from "zod";
+/**
+ * Extractor which extracts query params based on a JSON:API query parser.
+ *
+ * @see {@link QueryParser}
+ */
+export const jsonApiQuery = (parse) => (req) => {
+    return parse(req.uri.searchParams);
+};
+/**
+ * Extractor which extracts a JSON:API resource from the body.
+ *
+ * @see {@link parseResourceRequest}
+ */
+export const jsonApiResource = (options, idPathParam) => async (req) => {
+    let idSchema = options.idSchema;
+    if (idPathParam) {
+        const pathParams = req.extensions.get(PATH_PARAMS);
+        assert(pathParams, "Path parameters missing");
+        assert(idPathParam in pathParams, `Path parameter "${idPathParam}" missing`);
+        const pathId = pathParams[idPathParam];
+        // We have to apply some type hacks here to support this use-case.
+        // If no id schema was defined, it doesn't hurt to set one here.
+        // If one was supplied, we know that the input must be a string, so
+        // it's safe to pipe from a literal.
+        idSchema = (idSchema
+            ? z.literal(pathId).pipe(idSchema)
+            : z.literal(pathId));
+    }
+    const context = await createBodyContext(req);
+    return parseResourceRequest(context, { ...options, idSchema });
+};
+/**
+ * Extractor which extracts a to-one JSON:API relationship from the body.
+ *
+ * @see {@link parseRelationshipRequest}
+ */
+export const jsonApiRelationship = (type, idSchema) => async (req) => {
+    const context = await createBodyContext(req);
+    return parseRelationshipRequest(context, type, idSchema);
+};
+/**
+ * Extractor which extracts to-many JSON:API relationships from the body.
+ *
+ * @see {@link parseRelationshipsRequest}
+ */
+export const jsonApiRelationships = (type, idSchema) => async (req) => {
+    const context = await createBodyContext(req);
+    return parseRelationshipsRequest(context, type, idSchema);
+};
+/**
+ * Creates a {@link BodyContext} from an {@link HttpRequest}.
+ */
+const createBodyContext = async (req) => {
+    const body = await consumers.text(req.body);
+    return {
+        body: body,
+        /* node:coverage ignore next */
+        contentType: req.headers.get("content-type") ?? undefined,
+    };
+};
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAOH,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GAIvB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GACrB,CAOI,KAAuF,EAGzF,EAAE,CACJ,CACI,GAAgB,EACqE,EAAE;IACvF,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC,CAAC;AAEN;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GACxB,CAOI,OAMC,EACD,WAAoB,EAStB,EAAE,CACJ,KAAK,EACD,GAAgB,EASlB,EAAE;IACA,IAAI,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAEhC,IAAI,WAAW,EAAE,CAAC;QACd,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAC9C,MAAM,CAAC,WAAW,IAAI,UAAU,EAAE,mBAAmB,WAAW,WAAW,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAEvC,kEAAkE;QAClE,gEAAgE;QAChE,mEAAmE;QACnE,oCAAoC;QACpC,QAAQ,GAAG,CAAC,QAAQ;YAChB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAqC,CAAC;YAC/D,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAyB,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,oBAAoB,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AACnE,CAAC,CAAC;AAEN;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC5B,CACI,IAAY,EACZ,QAAoB,EAGtB,EAAE,CACJ,KAAK,EACD,GAAgB,EAGlB,EAAE;IACA,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,wBAAwB,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEN;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC7B,CAAC,IAAY,EAAE,QAA2B,EAAuB,EAAE,CACnE,KAAK,EAAE,GAAgB,EAAqB,EAAE;IAC1C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,yBAAyB,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEN;;GAEG;AACH,MAAM,iBAAiB,GAAG,KAAK,EAAE,GAAgB,EAAwB,EAAE;IACvE,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE5C,OAAO;QACH,IAAI,EAAE,IAAI;QACV,+BAA+B;QAC/B,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS;KAC5D,CAAC;AACN,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./error-handler.js";
+export * from "./extract.js";
+export * from "./layer.js";
+export * from "./layer.js";
+export * from "./router.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./error-handler.js";
+export * from "./extract.js";
+export * from "./layer.js";
+export * from "./layer.js";
+export * from "./router.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/layer.d.ts

@@ -0,0 +1,19 @@
+import "./augment.js";
+import { type JsonApiMediaType } from "@jsonapi-serde/server/http";
+import { ExtensionKey, type HttpRequest, type HttpResponse } from "@taxum/core/http";
+import type { HttpService } from "@taxum/core/service";
+export declare const JSON_API_MEDIA_TYPES: ExtensionKey<JsonApiMediaType[]>;
+export declare const JSON_API_VERIFY_ACCEPT_MEDIA_TYPE: ExtensionKey<(acceptableTypes: JsonApiMediaType[]) => void>;
+/**
+ * Layer that parses and validates the `Accept` header for JSON:API media types.
+ *
+ * On success, adds acceptable media types to the request extensions.
+ * On failure, responds with HTTP 400 and a JSON:API error document.
+ */
+export declare const jsonApiMediaTypesLayer: import("@taxum/core/layer").Layer<JsonApiMediaTypes, HttpService>;
+declare class JsonApiMediaTypes implements HttpService {
+    private readonly inner;
+    constructor(inner: HttpService);
+    invoke(req: HttpRequest): Promise<HttpResponse>;
+}
+export {};

package/dist/layer.js

@@ -0,0 +1,49 @@
+import "./augment.js";
+import { JsonApiError } from "@jsonapi-serde/server/common";
+import { getAcceptableMediaTypes, MediaTypeParserError, } from "@jsonapi-serde/server/http";
+import { ExtensionKey, TO_HTTP_RESPONSE, } from "@taxum/core/http";
+import { layerFn } from "@taxum/core/layer";
+export const JSON_API_MEDIA_TYPES = new ExtensionKey("JSON:API Media Types");
+export const JSON_API_VERIFY_ACCEPT_MEDIA_TYPE = new ExtensionKey("JSON:API Document");
+/**
+ * Layer that parses and validates the `Accept` header for JSON:API media types.
+ *
+ * On success, adds acceptable media types to the request extensions.
+ * On failure, responds with HTTP 400 and a JSON:API error document.
+ */
+export const jsonApiMediaTypesLayer = layerFn((inner) => new JsonApiMediaTypes(inner));
+class JsonApiMediaTypes {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    async invoke(req) {
+        let acceptableMediaTypes;
+        try {
+            acceptableMediaTypes = getAcceptableMediaTypes(req.headers.get("accept") ?? "");
+        }
+        catch (error) {
+            /* node:coverage disable */
+            if (!(error instanceof MediaTypeParserError)) {
+                throw error;
+            }
+            /* node:coverage enable */
+            return new JsonApiError({
+                status: "400",
+                code: "bad_request",
+                title: "Bad Request",
+                detail: error.message,
+                source: {
+                    header: "accept",
+                },
+            })[TO_HTTP_RESPONSE]();
+        }
+        req.extensions.insert(JSON_API_MEDIA_TYPES, acceptableMediaTypes);
+        const res = await this.inner.invoke(req);
+        if (res.status.isSuccess()) {
+            res.extensions.get(JSON_API_VERIFY_ACCEPT_MEDIA_TYPE)?.(acceptableMediaTypes);
+        }
+        return res;
+    }
+}
+//# sourceMappingURL=layer.js.map

package/dist/layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.js","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,OAAO,EAAwB,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EACH,uBAAuB,EAEvB,oBAAoB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,YAAY,EAGZ,gBAAgB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,YAAY,CAAqB,sBAAsB,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,YAAY,CAE/D,mBAAmB,CAAC,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC,CAAC,KAAkB,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;AAEpG,MAAM,iBAAiB;IACF,KAAK,CAAc;IAEpC,YAAmB,KAAkB;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAAgB;QAChC,IAAI,oBAAwC,CAAC;QAE7C,IAAI,CAAC;YACD,oBAAoB,GAAG,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,2BAA2B;YAC3B,IAAI,CAAC,CAAC,KAAK,YAAY,oBAAoB,CAAC,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,0BAA0B;YAE1B,OAAO,IAAI,YAAY,CAAC;gBACpB,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,aAAa;gBACpB,MAAM,EAAE,KAAK,CAAC,OAAO;gBACrB,MAAM,EAAE;oBACJ,MAAM,EAAE,QAAQ;iBACnB;aACJ,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC3B,CAAC;QAED,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;QAElE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YACzB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,iCAAiC,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC;QAClF,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC;CACJ"}

package/dist/router.d.ts

@@ -0,0 +1,4 @@
+import "./augment.js";
+import type { Handler } from "@taxum/core/routing";
+export declare const notFoundHandler: Handler;
+export declare const methodNotAllowedHandler: Handler;

package/dist/router.js

@@ -0,0 +1,18 @@
+import "./augment.js";
+import { JsonApiError } from "@jsonapi-serde/server/common";
+import { TO_HTTP_RESPONSE } from "@taxum/core/http";
+export const notFoundHandler = () => {
+    return new JsonApiError({
+        status: "404",
+        code: "not_found",
+        title: "Resource not found",
+    })[TO_HTTP_RESPONSE]();
+};
+export const methodNotAllowedHandler = () => {
+    return new JsonApiError({
+        status: "405",
+        code: "method_not_allowed",
+        title: "Method not allowed",
+    })[TO_HTTP_RESPONSE]();
+};
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAqB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGvE,MAAM,CAAC,MAAM,eAAe,GAAY,GAAiB,EAAE;IACvD,OAAO,IAAI,YAAY,CAAC;QACpB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,oBAAoB;KAC9B,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAY,GAAiB,EAAE;IAC/D,OAAO,IAAI,YAAY,CAAC;QACpB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,oBAAoB;KAC9B,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;AAC3B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@jsonapi-serde/integration-taxum",
+  "version": "1.0.0",
+  "description": "Taxum integration for @jsonapi-serde/server",
+  "type": "module",
+  "author": "Ben Scholzen 'DASPRiD'",
+  "license": "BSD-3-Clause",
+  "keywords": [
+    "jsonapi",
+    "typescript",
+    "zod",
+    "serializer",
+    "deserializer",
+    "parser",
+    "taxum"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dasprid/jsonapi-serde-js.git"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "exports": {
+    ".": {
+      "types": [
+        "./dist/index.d.ts",
+        "./src/index.ts"
+      ],
+      "@jsonapi-serde": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./augment": {
+      "types": [
+        "./dist/augment.d.ts",
+        "./src/augment.ts"
+      ],
+      "@jsonapi-serde": "./src/augment.ts",
+      "default": "./dist/augment.js"
+    }
+  },
+  "devDependencies": {
+    "@standard-schema/spec": "^1.0.0",
+    "@taxum/core": "^0.8.0",
+    "zod": "^4.0.17",
+    "@jsonapi-serde/server": "^1.2.0"
+  },
+  "peerDependencies": {
+    "@taxum/core": "^0.1.0",
+    "zod": "^4.0.14",
+    "@jsonapi-serde/server": "^1.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "tsx -C jsonapi-serde --test --test-reporter=spec  --experimental-test-module-mocks --no-warnings=ExperimentalWarning test/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "ci:test": "c8 --reporter=lcov pnpm test"
+  }
+}