@cleverbrush/server 4.5.0 → 5.1.0

package/dist/middlewares/Idempotency.d.ts

@@ -1,52 +1,31 @@
-/**
- * Server-side idempotency middleware.
- *
- * Ensures mutating requests with the same idempotency key produce the
- * same result exactly once — subsequent replays return the stored
- * response without re-executing the handler.
- *
- * @module
- */
 import type { RequestContext } from '../RequestContext.js';
 import type { Middleware } from '../types.js';
-/**
- * Configuration for {@link idempotency}.
- */
+/** Configuration for bounded, process-local mutation response replay. */
 export interface ServerIdempotencyOptions {
     /**
-     * TTL in milliseconds for stored responses.
-     * Defaults to `86_400_000` (24 hours).
+     * Explicit authorization/tenant scope. Run after authentication and
+     * authorization. Return undefined to skip; use a fixed string only for
+     * deliberately public operations. Never use an unverified identity header.
      */
+    scope: (ctx: RequestContext) => string | undefined;
+    /** Stored response lifetime in milliseconds. Default: 86,400,000. */
     ttl?: number;
-    /**
-     * Header name to read the idempotency key from.
-     * Defaults to `"x-idempotency-key"`.
-     */
+    /** Case-insensitive request header. Default: x-idempotency-key. */
     headerName?: string;
-    /**
-     * Predicate that decides whether a request should be skipped.
-     * Defaults to skipping non-mutating requests (GET, HEAD, OPTIONS).
-     */
+    /** Default: skip GET, HEAD, OPTIONS and other non-mutating methods. */
     skip?: (ctx: RequestContext) => boolean;
+    /** Maximum retained keys, including pending requests. Default: 1000. */
+    maxEntries?: number;
+    /** Maximum response body retained per key. Default: 65,536 bytes. */
+    maxResponseBytes?: number;
 }
 /**
- * Server-side idempotency middleware.
- *
- * Reads the `x-idempotency-key` header from mutating requests. If a
- * response has already been stored for that key, it is returned
- * immediately — the handler is never called. Otherwise the handler
- * executes and its response is stored for future replays.
- *
- * GET, HEAD, and OPTIONS requests pass through without checking.
- *
- * @param options - Configuration.
- * @returns A server-side {@link Middleware}.
- *
- * @example
- * ```ts
- * server.handle(CreateTodo, createHandler, {
- *     middlewares: [idempotency({ ttl: 86_400_000 })]
- * });
- * ```
+ * Replay completed mutations and coalesce concurrent requests within one
+ * middleware instance. Keys include explicit scope, method and full request URL.
+ * Reusing a key means retrying the same input; bodies are not fingerprinted.
+ * This is not durable exactly-once execution: restarts, expiry and thrown
+ * failures may permit another execution. Use database deduplication for that.
+ * Oversized/incomplete responses retain a non-replayable reservation (409).
+ * Capacity exhaustion returns 503 without executing the operation.
  */
-export declare function idempotency(options?: ServerIdempotencyOptions): Middleware;
+export declare function idempotency(options: ServerIdempotencyOptions): Middleware;

package/dist/middlewares/ResponseCache.d.ts

@@ -22,6 +22,10 @@ export interface ServerCacheOptions {
      * Per-tag TTL overrides: `{ [tagName]: ttlMs }`.
      */
     ttlByTag?: Record<string, number>;
+    /** Maximum retained cache keys. Default: 1000 (oldest keys are evicted). */
+    maxEntries?: number;
+    /** Maximum retained response body size. Default: 65,536 bytes. */
+    maxResponseBytes?: number;
 }
 /**
  * Server-side cache response middleware.
@@ -36,6 +40,9 @@ export interface ServerCacheOptions {
  * - **Mutation (POST/PUT/PATCH/DELETE)**: Lets the handler run, then
  *   invalidates all cache entries whose tag names start with any of the
  *   endpoint's cache tag names. Older in-flight reads cannot refill them.
+ * - By default, retain at most 1000 keys and bodies up to 65,536 bytes. Private/no-store and
+ *   Set-Cookie responses are not cached. Install after authorization and encode
+ *   every identity/tenant/representation dimension in tag properties.
  *
  * @param options - Cache configuration.
  * @returns A server-side {@link Middleware}.

package/dist/middlewares/ResponseSnapshot.d.ts

@@ -0,0 +1,9 @@
+import type { OutgoingHttpHeaders, ServerResponse } from 'node:http';
+/** @internal A complete, bounded response suitable for replay. */
+export interface ResponseSnapshot {
+    status: number;
+    headers: OutgoingHttpHeaders;
+    body: Buffer;
+}
+/** @internal Capture all write/end overloads without changing their behavior. */
+export declare function captureResponse(response: ServerResponse, next: () => Promise<void>, maxBytes: number): Promise<ResponseSnapshot | undefined>;

package/dist/multipart.d.ts

@@ -0,0 +1,9 @@
+import type { IncomingMessage } from 'node:http';
+import type { FilePart, RejectedFile } from './types.js';
+import type { UploadConfiguration } from './upload.js';
+/** @internal Buffered multipart parsing with a bound on the entire wire body. */
+export declare function parseMultipart(req: IncomingMessage, options: UploadConfiguration, maxBodySize: number): Promise<{
+    fields: Record<string, string>;
+    files: Record<string, FilePart | FilePart[]>;
+    rejectedFiles: RejectedFile[];
+}>;

package/dist/types.d.ts

@@ -1,11 +1,12 @@
 import type { EndpointMetadata } from './Endpoint.js';
+import type { RuntimeEndpointOptions } from './EndpointOptions.js';
 import type { RequestContext } from './RequestContext.js';
 import type { SubscriptionMetadata } from './Subscription.js';
 /**
  * A registered endpoint pairing its metadata (method, path, schemas) with
  * the handler function and any per-endpoint middleware.
  */
-export interface EndpointRegistration {
+export interface EndpointRegistration extends RuntimeEndpointOptions {
     readonly endpoint: EndpointMetadata;
     readonly handler: (...args: any[]) => any;
     readonly middlewares?: readonly Middleware[];
@@ -100,6 +101,8 @@ export interface FilePart {
  * Describes a file that was rejected during multipart parsing.
  */
 export interface RejectedFile {
+    /** Multipart field name, when available. */
+    readonly fieldName?: string;
     /** Original filename as provided by the client. */
     readonly filename: string;
     /** MIME type of the file (e.g. `'application/xlsx'`). */
@@ -112,6 +115,14 @@ export interface RejectedFile {
  * `EndpointBuilder.upload()`.
  */
 export interface UploadOptions {
+    /** Maximum bytes per text field. Default: 1 MiB. */
+    maxFieldSize?: number;
+    /** Maximum text fields per request. Default: 100. */
+    maxFieldCount?: number;
+    /** Maximum UTF-8 bytes per field name. Default: 100. */
+    maxFieldNameSize?: number;
+    /** Maximum parts. Default: maxFileCount + maxFieldCount. */
+    maxPartCount?: number;
     /**
      * Maximum allowed file size per uploaded file in bytes.
      * @default 10_485_760 (10 MB)

package/dist/upload.d.ts

@@ -0,0 +1,16 @@
+import { type InferType, type ObjectSchemaBuilder, type SchemaBuilder } from '@cleverbrush/schema';
+import type { FilePart, UploadOptions } from './types.js';
+/** A buffered file in an upload contract. Safe to import in browser contracts. */
+export declare function file(): import("@cleverbrush/schema").AnySchemaBuilder<true, false, FilePart, false, {}, FilePart>;
+/** Flat object of file() and array(file()) fields. */
+export type UploadSchema = ObjectSchemaBuilder<any, any, any, any, any, any, any>;
+/** Upload metadata shared by the server, typed client, and OpenAPI generator. */
+export interface UploadConfiguration extends UploadOptions {
+    readonly schema?: UploadSchema;
+}
+/** The upload state carried through immutable endpoint chaining. */
+export type UploadContract = boolean | UploadSchema;
+/** Files received by a handler, inferred from the upload schema. */
+export type UploadFiles<T extends UploadContract> = T extends UploadSchema ? InferType<T> : Record<string, FilePart>;
+/** @internal Validate the supported multipart shape in either chaining order. */
+export declare function validateUploadConfiguration(upload: UploadConfiguration | null, body: SchemaBuilder<any, any, any, any, any> | null): void;

package/dist/withRequestSignal.d.ts

@@ -0,0 +1,29 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/** HTTP lifecycle fields required to cancel request-owned work. */
+export interface RequestSignalContext {
+    readonly request: Pick<IncomingMessage, 'aborted' | 'once' | 'off'>;
+    readonly response: Pick<ServerResponse, 'destroyed' | 'writableFinished' | 'once' | 'off'>;
+}
+/** Application-owned deadline and optional cancellation for request work. */
+export interface RequestSignalOptions {
+    /** Positive integer deadline in milliseconds, at most 2,147,483,647. */
+    timeoutMs: number;
+    /** Additional cancellation, such as application shutdown. */
+    signal?: AbortSignal;
+}
+/**
+ * Run cooperative work with cancellation on disconnect, deadline or caller abort.
+ *
+ * The visitor must observe its signal; this helper does not forcibly interrupt
+ * arbitrary promises. A normal response finish does not cancel the work. The
+ * deadline timer and all listeners are removed when work settles, including on
+ * failure. Already-aborted inputs reject without invoking the visitor.
+ *
+ * @example
+ * ```ts
+ * await withRequestSignal(context, signal => loadReport(signal), {
+ *     timeoutMs: 30_000
+ * });
+ * ```
+ */
+export declare function withRequestSignal<T>(context: RequestSignalContext, work: (signal: AbortSignal) => T | PromiseLike<T>, options: RequestSignalOptions): Promise<T>;

package/package.json

@@ -5,11 +5,11 @@
         "email": "andrew_zol@cleverbrush.com"
     },
     "dependencies": {
-        "@cleverbrush/auth": "^4.5.0",
-        "@cleverbrush/di": "^4.5.0",
-        "@cleverbrush/schema": "^4.5.0",
-        "@fastify/busboy": "^3.2.0",
-        "ws": "^8.20.0"
+        "@cleverbrush/auth": "^5.1.0",
+        "@cleverbrush/di": "^5.1.0",
+        "@cleverbrush/schema": "^5.1.0",
+        "@fastify/busboy": "^3.2.2",
+        "ws": "^8.22.0"
     },
     "devDependencies": {
         "@types/busboy": "1.5.4",
@@ -29,7 +29,7 @@
         "typescript",
         "cleverbrush"
     ],
-    "license": "BSD 3-Clause",
+    "license": "BSD-3-Clause",
     "main": "./dist/index.js",
     "exports": {
         ".": {
@@ -43,6 +43,9 @@
     },
     "sideEffects": false,
     "name": "@cleverbrush/server",
+    "engines": {
+        "node": ">=24"
+    },
     "readme": "https://github.com/cleverbrush/framework/tree/master/libs/server#readme",
     "repository": {
         "type": "git",
@@ -55,5 +58,5 @@
     },
     "type": "module",
     "types": "./dist/index.d.ts",
-    "version": "4.5.0"
+    "version": "5.1.0"
 }

package/dist/chunk-L2OPVEOF.js

@@ -1,2 +0,0 @@
-function f(n,e){if(n===null)return["null"];switch(typeof n){case"undefined":return["undefined"];case"string":case"boolean":return[typeof n,n];case"number":return["number",Object.is(n,-0)?"-0":String(n)];case"bigint":return["bigint",String(n)];case"object":{if(e.has(n))throw new TypeError("Cache tag values must not contain cycles.");if(n instanceof Date){if(!Number.isFinite(n.getTime()))throw new TypeError("Cache tag dates must be valid.");return["date",n.toISOString()]}let t=Object.getPrototypeOf(n);if(!Array.isArray(n)&&t!==Object.prototype&&t!==null)throw new TypeError("Unsupported cache tag object.");if(Object.getOwnPropertySymbols(n).length>0)throw new TypeError("Cache tag values cannot have symbol keys.");e.add(n);try{if(Array.isArray(n)){if(Object.keys(n).some(a=>!/^(0|[1-9]\d*)$/.test(a)||Number(a)>=n.length))throw new TypeError("Cache tag arrays cannot have named properties.");return["array",Array.from({length:n.length},(a,s)=>{let i=Object.getOwnPropertyDescriptor(n,s);if(i&&!("value"in i))throw new TypeError("Cache tag values cannot contain getters.");return f(i?.value,e)})]}return["object",Object.keys(n).sort().map(a=>{let s=Object.getOwnPropertyDescriptor(n,a);if(!("value"in s))throw new TypeError("Cache tag values cannot contain getters.");return[a,f(s.value,e)]})]}finally{e.delete(n)}}default:throw new TypeError(`Unsupported cache tag value: ${typeof n}.`)}}function B(n,e){let t=[];for(let a of Object.keys(n.properties).sort()){let s=n.properties[a].getValue(e);s.success&&s.value!==void 0&&t.push([a,f(s.value,new Set)])}return`ct2:${JSON.stringify([n.name,t])}`}import{object as b,SYMBOL_HAS_PROPERTIES as x,SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR as R}from"@cleverbrush/schema";function E(n){let e={};if(n.paramsSchema){let a=n.paramsSchema;typeof a.introspect=="function"&&a.introspect().objectSchema?e.params=a.introspect().objectSchema:a[x]===!0&&(e.params=a)}if(n.bodySchema){let a=n.bodySchema;(a[x]===!0||typeof a.introspect=="function")&&(e.body=a)}n.querySchema&&(e.query=n.querySchema),n.headerSchema&&(e.headers=n.headerSchema);let t=b(e);return b.getPropertiesFor(t)}function z(n){return n==null||typeof n!="object"?!1:typeof n[R]=="object"&&n[R]!==null}function O(n,e){let t={};for(let[a,s]of Object.entries(e)){if(!z(s))throw new Error(`Cache tag "${n}": property "${a}" is not a valid PropertyDescriptor. Make sure you select a leaf property from the tree (e.g. p.query.id, not p.query).`);let i=s[R];t[a]={getValue:o=>i.getValue(o)}}return{name:n,properties:t}}var P=Symbol.for("cleverbrush.tracked");function G(n,e){return{[P]:!0,id:n,data:e}}function ee(n){return n!==null&&typeof n=="object"&&P in n&&n[P]===!0}var u=class n{#s;#a;#n;#i;#r;#o;#l;#t;#d;#h;#c;#u;#p;#y;constructor(e,t="/",a=null,s=null,i=null,o=null,y=null,d=null,l=null,h=null,c=[],m=null,g=!1,S=null){this.#s=e,this.#a=t,this.#n=a,this.#i=s,this.#r=i,this.#o=o,this.#l=y,this.#t=d,this.#d=l,this.#h=h,this.#c=c,this.#u=m,this.#p=g,this.#y=S}#e(e){return new n(e.basePath??this.#s,e.pathTemplate??this.#a,e.incomingSchema!==void 0?e.incomingSchema:this.#n,e.outgoingSchema!==void 0?e.outgoingSchema:this.#i,e.querySchema!==void 0?e.querySchema:this.#r,e.headerSchema!==void 0?e.headerSchema:this.#o,e.serviceSchemas!==void 0?e.serviceSchemas:this.#l,e.authRoles!==void 0?e.authRoles:this.#t,e.summary!==void 0?e.summary:this.#d,e.description!==void 0?e.description:this.#h,e.tags??this.#c,e.operationId!==void 0?e.operationId:this.#u,e.deprecated??this.#p,e.externalDocs!==void 0?e.externalDocs:this.#y)}incoming(e){return this.#e({incomingSchema:e})}outgoing(e){return this.#e({outgoingSchema:e})}query(e){return this.#e({querySchema:e})}headers(e){return this.#e({headerSchema:e})}inject(e){return this.#e({serviceSchemas:e})}authorize(...e){let t;e.length>0&&typeof e[0]=="object"&&e[0]!==null&&"introspect"in e[0]?t=e.slice(1):t=e;let a=this.#t?[...this.#t,...t]:t;return this.#e({authRoles:a})}public(){return this.#e({authRoles:null})}summary(e){return this.#e({summary:e})}description(e){return this.#e({description:e})}tags(...e){return this.#e({tags:e})}operationId(e){return this.#e({operationId:e})}deprecated(){return this.#e({deprecated:!0})}externalDocs(e,t){return this.#e({externalDocs:{url:e,description:t}})}introspect(){return{protocol:"subscription",basePath:this.#s,pathTemplate:this.#a,incomingSchema:this.#n,outgoingSchema:this.#i,querySchema:this.#r,headerSchema:this.#o,serviceSchemas:this.#l,authRoles:this.#t,summary:this.#d,description:this.#h,tags:this.#c,operationId:this.#u,deprecated:this.#p,externalDocs:this.#y}}};function k(n,e){return new u(n,e??"/")}function w(n){return n instanceof u}function se(n,e){let t=[],a=[];for(let s of Object.keys(n)){let i=n[s],o=e[s];for(let y of Object.keys(i)){let d=i[y],l=o[y],h=typeof l=="function"?l:l.handler,c=typeof l=="function"?void 0:l.middlewares;w(d)?a.push({endpoint:d,handler:h,middlewares:c}):t.push({endpoint:d,handler:h,middlewares:c})}}return{_entries:t,_subscriptions:a}}var T=class n{#s;#a;#n;#i;#r;#o;#l;#t;#d;#h;#c;#u;#p;#y;#e;#m;#g;#S;#f;#R;#P;#B;#b;#x;#T;constructor(e,t,a,s,i,o,y=null,d=null,l=null,h=null,c=[],m=null,g=!1,S=null,C=null,A=null,v=null,I=null,D=null,Q=null,K=null,M=null,U=null,F=null,q=[]){this.#s=e,this.#a=t,this.#n=a,this.#i=s,this.#r=i,this.#o=o,this.#l=y,this.#t=d,this.#d=l,this.#h=h,this.#c=c,this.#u=m,this.#p=g,this.#y=S,this.#e=C,this.#m=A,this.#g=v,this.#S=I,this.#f=D,this.#R=Q,this.#P=K,this.#B=M,this.#b=U,this.#x=F,this.#T=q}body(e){return new n(this.#s,this.#a,this.#n,e,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}query(e){return new n(this.#s,this.#a,this.#n,this.#i,e,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}headers(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,e,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}inject(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,e,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}authorize(...e){let t;e.length>0&&typeof e[0]=="object"&&e[0]!==null&&"introspect"in e[0]?t=e.slice(1):t=e;let a=this.#t?[...this.#t,...t]:t;return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,a,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}public(){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,null,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}returns(e){let t=e!=null&&typeof e=="object"&&"introspect"in e?e:null;return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,t??this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}responses(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}summary(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,e,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}description(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,e,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}tags(...e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,e,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}operationId(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,e,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}deprecated(){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,!0,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}example(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,e,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}examples(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,e,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}producesFile(e,t){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,{contentType:e,description:t},this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}upload(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,{maxFileSize:e?.maxFileSize??10*1024*1024,allowedMimeTypes:e?.allowedMimeTypes,maxFileCount:e?.maxFileCount??10},this.#T)}get path(){let e=this.#a,t=this.#n,a;if(typeof t=="string")a=t;else{let{literals:s,segments:i}=t.introspect().templateDefinition,o="";for(let y=0;y<i.length;y++)o+=s[y]+`:${i[y].path}`;o+=s[i.length]??"",a=o}return a==="/"?e||"/":e+a}introspect(){return{method:this.#s,basePath:this.#a,pathTemplate:this.#n,bodySchema:this.#i,querySchema:this.#r,headerSchema:this.#o,serviceSchemas:this.#l,authRoles:this.#t,summary:this.#d,description:this.#h,tags:this.#c,operationId:this.#u,deprecated:this.#p,responseSchema:this.#y,responsesSchemas:this.#e,example:this.#m,examples:this.#g,producesFile:this.#S,produces:this.#f,responseHeaderSchema:this.#R,externalDocs:this.#P,links:this.#B,callbacks:this.#b,fileUpload:this.#x,cacheTags:this.#T}}produces(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,e,this.#R,this.#P,this.#B,this.#b,this.#x,this.#T)}responseHeaders(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,e,this.#P,this.#B,this.#b,this.#x,this.#T)}externalDocs(e,t){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,{url:e,description:t},this.#B,this.#b,this.#x,this.#T)}links(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,e,this.#b,this.#x,this.#T)}callbacks(e){return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,e,this.#x,this.#T)}cacheTag(e,t){return this.clearsCacheTag(e,t)}clearsCacheTag(e,t){if(!t)return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,[...this.#T,{name:e,properties:{}}]);let a=Y(this.#n),s=E({paramsSchema:a,bodySchema:this.#i,querySchema:this.#r,headerSchema:this.#o}),i=t(s);if(typeof i!="object"||i===null)throw new Error(`Cache tag "${e}": selector must return an object with property descriptors (e.g. { id: p.query.id }).`);let o=O(e,i);return new n(this.#s,this.#a,this.#n,this.#i,this.#r,this.#o,this.#l,this.#t,this.#d,this.#h,this.#c,this.#u,this.#p,this.#y,this.#e,this.#m,this.#g,this.#S,this.#f,this.#R,this.#P,this.#B,this.#b,this.#x,[...this.#T,o])}};function r(n,e,t,a,s){return new T(n,e,t??"/",null,null,null,null,a??null,s?.summary??null,s?.description??null,s?.tags??[],s?.operationId??null,s?.deprecated??!1,null,null,null,null,null,null,null)}function p(n,e){return{get:t=>r("GET",n,t,e),post:t=>r("POST",n,t,e),put:t=>r("PUT",n,t,e),patch:t=>r("PATCH",n,t,e),delete:t=>r("DELETE",n,t,e),head:t=>r("HEAD",n,t,e),options:t=>r("OPTIONS",n,t,e),public:()=>p(n,null)}}function L(n){return{...p(n,null),authorize(...e){let t;return e.length>0&&typeof e[0]=="object"&&e[0]!==null&&"introspect"in e[0]?t=e.slice(1):t=e,p(n,t)},public(){return p(n,null)}}}function Y(n){if(n&&typeof n!="string"&&typeof n.introspect=="function"){let e=n.introspect();if(e.objectSchema)return e.objectSchema}return null}function N(n){return H}var H={get:(n,e)=>r("GET",n,e),post:(n,e)=>r("POST",n,e),put:(n,e)=>r("PUT",n,e),patch:(n,e)=>r("PATCH",n,e),delete:(n,e)=>r("DELETE",n,e),head:(n,e)=>r("HEAD",n,e),options:(n,e)=>r("OPTIONS",n,e),resource:L,subscription:(n,e)=>k(n,e)};import{object as $,parseString as V}from"@cleverbrush/schema";function j(n){let e=$(n);return((t,...a)=>V(e,s=>s(t,...a)))}function J(n,...e){return n!=null&&Array.isArray(n.raw)?j({})(n):j(n??{})}function ye(n){for(let e of Object.values(n))Object.freeze(e);return Object.freeze(n)}function le(n,e){let t={};for(let a of Object.keys(n))t[a]={...n[a]};for(let a of Object.keys(e))Object.hasOwn(t,a)?t[a]={...t[a],...e[a]}:t[a]={...e[a]};for(let a of Object.values(t))Object.freeze(a);return Object.freeze(t)}function de(n,...e){let t={};for(let a of e)t[a]=n[a],Object.freeze(t[a]);return Object.freeze(t)}function he(n,...e){let t=new Set(e),a={};for(let s of Object.keys(n))t.has(s)||(a[s]=n[s],Object.freeze(a[s]));return Object.freeze(a)}export{B as a,E as b,O as c,G as d,ee as e,u as f,se as g,T as h,N as i,H as j,J as k,ye as l,le as m,de as n,he as o};
-//# sourceMappingURL=chunk-L2OPVEOF.js.map