@modularizer/plat 0.1.0

package/dist/server/tools.js

@@ -0,0 +1,225 @@
+/**
+ * Tool Definition Generation for AI Integrations (Claude, OpenAI, etc)
+ *
+ * Generates standardized tool definitions from controller metadata
+ * Supports multiple formats: Anthropic (Claude), OpenAI, generic JSON Schema
+ */
+/**
+ * Convert a Zod schema to JSON Schema
+ */
+export function zodToJsonSchema(schema) {
+    if (!schema) {
+        return { type: 'object', properties: {} };
+    }
+    // Handle different Zod types
+    const schemaAny = schema;
+    // For object schemas
+    if (schemaAny._def?.shape) {
+        const shape = schemaAny._def.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, field] of Object.entries(shape)) {
+            const fieldSchema = field;
+            const fieldAny = fieldSchema;
+            // Check if required
+            if (fieldAny._def?.innerType === undefined && fieldAny._def?.t !== 'ZodOptional') {
+                required.push(key);
+            }
+            // Get the type
+            properties[key] = zodTypeToJsonType(fieldSchema);
+        }
+        return {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+        };
+    }
+    // Fallback
+    return { type: 'object', properties: {} };
+}
+/**
+ * Convert a single Zod type to JSON Schema type
+ */
+function zodTypeToJsonType(schema) {
+    const schemaAny = schema;
+    const typeName = schemaAny._def?.t;
+    switch (typeName) {
+        case 'ZodString':
+            return { type: 'string' };
+        case 'ZodNumber':
+            return { type: 'number' };
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodArray': {
+            const elementSchema = schemaAny._def?.type;
+            return {
+                type: 'array',
+                items: elementSchema ? zodTypeToJsonType(elementSchema) : { type: 'object' },
+            };
+        }
+        case 'ZodObject':
+            return zodToJsonSchema(schema);
+        case 'ZodOptional':
+            return zodTypeToJsonType(schemaAny._def?.innerType);
+        case 'ZodEnum':
+            return {
+                type: 'string',
+                enum: schemaAny._def?.values || [],
+            };
+        case 'ZodUnion':
+            return { type: 'string' }; // Simplified
+        default:
+            return { type: 'string' };
+    }
+}
+function emptyInputSchema() {
+    return { type: 'object', properties: {}, required: [] };
+}
+function normalizeInputSchema(schema) {
+    return {
+        type: 'object',
+        properties: schema?.properties ?? {},
+        required: schema?.required ?? [],
+    };
+}
+/**
+ * Create a tool definition from controller method metadata
+ */
+export function createToolDefinition(initOrMethodName, httpMethod, path, description, inputSchema, responseSchema, controller) {
+    if (typeof initOrMethodName === 'object') {
+        return {
+            name: initOrMethodName.name,
+            summary: initOrMethodName.summary,
+            description: initOrMethodName.description || `${initOrMethodName.method.toUpperCase()} ${initOrMethodName.path}`,
+            method: initOrMethodName.method.toUpperCase(),
+            path: initOrMethodName.path,
+            controller: initOrMethodName.controller,
+            tags: initOrMethodName.tags,
+            examples: initOrMethodName.examples,
+            hidden: initOrMethodName.hidden,
+            safe: initOrMethodName.safe,
+            idempotent: initOrMethodName.idempotent,
+            longRunning: initOrMethodName.longRunning,
+            input_schema: normalizeInputSchema(initOrMethodName.input_schema),
+            response_schema: initOrMethodName.response_schema,
+        };
+    }
+    const methodName = initOrMethodName;
+    const normalizedMethod = (httpMethod || 'GET').toUpperCase();
+    const normalizedPath = path || `/${methodName}`;
+    const jsonInputSchema = inputSchema ? zodToJsonSchema(inputSchema) : emptyInputSchema();
+    return {
+        name: methodName,
+        description: description || `${normalizedMethod} ${normalizedPath}`,
+        method: normalizedMethod,
+        path: normalizedPath,
+        controller,
+        input_schema: normalizeInputSchema(jsonInputSchema),
+        response_schema: responseSchema ? zodToJsonSchema(responseSchema) : undefined,
+    };
+}
+export function buildInputSchemaFromOpenAPIOperation(operation) {
+    const properties = {};
+    const required = new Set();
+    if (Array.isArray(operation?.parameters)) {
+        for (const param of operation.parameters) {
+            if (!param?.name || !param?.schema)
+                continue;
+            properties[param.name] = { ...param.schema };
+            if (param.description)
+                properties[param.name].description = param.description;
+            if (param.required)
+                required.add(param.name);
+        }
+    }
+    const bodySchema = operation?.requestBody?.content?.['application/json']?.schema;
+    if (bodySchema?.type === 'object' && bodySchema.properties) {
+        Object.assign(properties, bodySchema.properties);
+        for (const name of bodySchema.required ?? [])
+            required.add(name);
+    }
+    return {
+        type: 'object',
+        properties,
+        required: Array.from(required),
+    };
+}
+export function buildResponseSchemaFromOpenAPIOperation(operation) {
+    const responses = operation?.responses;
+    if (!responses || typeof responses !== 'object')
+        return undefined;
+    for (const status of ['200', '201', '202', 'default']) {
+        const schema = responses[status]?.content?.['application/json']?.schema;
+        if (schema)
+            return schema;
+    }
+    for (const response of Object.values(responses)) {
+        const schema = response?.content?.['application/json']?.schema;
+        if (schema)
+            return schema;
+    }
+    return undefined;
+}
+export function toolDefinitionFromOpenAPIOperation(path, method, operation) {
+    if (!operation?.operationId)
+        return null;
+    return createToolDefinition({
+        name: operation.operationId,
+        summary: operation.summary,
+        description: operation.description || operation.summary || `${method.toUpperCase()} ${path}`,
+        method: method.toUpperCase(),
+        path,
+        controller: operation.tags?.[0],
+        tags: Array.isArray(operation.tags) ? operation.tags : undefined,
+        input_schema: buildInputSchemaFromOpenAPIOperation(operation),
+        response_schema: buildResponseSchemaFromOpenAPIOperation(operation),
+    });
+}
+/**
+ * Convert tool definition to Claude/Anthropic format
+ */
+export function toAnthropicFormat(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.input_schema,
+    };
+}
+/**
+ * Convert tool definition to OpenAI format
+ */
+export function toOpenAIFormat(tool) {
+    return {
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: {
+                type: 'object',
+                properties: tool.input_schema.properties,
+                required: tool.input_schema.required,
+            },
+        },
+    };
+}
+/**
+ * Convert tool definition to generic format (with metadata)
+ */
+export function toSchemaFormat(tool) {
+    return tool;
+}
+/**
+ * Convert tool definition to requested format
+ */
+export function formatTool(tool, format) {
+    switch (format) {
+        case 'claude':
+            return toAnthropicFormat(tool);
+        case 'openai':
+            return toOpenAIFormat(tool);
+        case 'schema':
+        default:
+            return toSchemaFormat(tool);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/server/tools.js.map

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

package/dist/server/transports.d.ts

@@ -0,0 +1,25 @@
+import type { RouteContext } from '../types';
+export interface PLATServerResolvedOperation {
+    method: string;
+    path: string;
+    methodName: string;
+    boundMethod: Function;
+    controllerTag: string;
+    routeMeta: any;
+    controllerMeta: any;
+}
+export interface PLATServerCallEnvelope {
+    protocol: string;
+    method: string;
+    path: string;
+    headers: Record<string, string>;
+    input: Record<string, any>;
+    ctx: RouteContext;
+    operationId?: string;
+    requestId?: string;
+    req?: unknown;
+    res?: unknown;
+    allowHelp: boolean;
+    helpRequested?: boolean;
+}
+//# sourceMappingURL=transports.d.ts.map

package/dist/server/transports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../../src/server/transports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,QAAQ,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,GAAG,CAAA;IACd,cAAc,EAAE,GAAG,CAAA;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1B,GAAG,EAAE,YAAY,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB"}

package/dist/server/transports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transports.js.map

package/dist/server/transports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.js","sourceRoot":"","sources":["../../src/server/transports.ts"],"names":[],"mappings":""}

package/dist/spec/decorators.d.ts

@@ -0,0 +1,41 @@
+import { HttpMethod } from "../types";
+import type { AuthMode } from "../types/endpoints";
+import type { RateLimitMeta, TokenLimitMeta, CacheMeta } from "../types/plugins";
+export declare const ROUTE_METADATA_KEY: unique symbol;
+export interface ControllerOpts {
+    tag?: string;
+    auth?: AuthMode;
+    rateLimit?: RateLimitMeta;
+    tokenLimit?: TokenLimitMeta;
+    cache?: CacheMeta;
+    [key: string]: any;
+}
+export interface RouteOpts {
+    auth?: AuthMode;
+    rateLimit?: RateLimitMeta;
+    tokenLimit?: TokenLimitMeta;
+    cache?: CacheMeta;
+    [key: string]: any;
+}
+export declare const pendingRoutes: Map<any, {
+    key: string | symbol;
+    method: HttpMethod;
+    opts?: RouteOpts;
+}[]>;
+/**
+ * Controller decorator
+ * Registers a controller class. No base path routing - all methods become flat routes named after the method.
+ * The controller name is used only for OpenAPI tagging and documentation.
+ *
+ * @param controllerName - Name for documentation/OpenAPI tags (e.g., "orders", "users")
+ * @param opts - Controller-level options (auth, rate limiting, etc.)
+ */
+export declare function Controller(controllerName?: string, opts?: ControllerOpts): ClassDecorator;
+type RouteDecorator = (opts?: RouteOpts) => MethodDecorator;
+export declare const GET: RouteDecorator;
+export declare const POST: RouteDecorator;
+export declare const PUT: RouteDecorator;
+export declare const PATCH: RouteDecorator;
+export declare const DELETE: RouteDecorator;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/spec/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/spec/decorators.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEhF,eAAO,MAAM,kBAAkB,eAAuB,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAA;IAEjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACrB;AAID,eAAO,MAAM,aAAa;SAA6B,MAAM,GAAG,MAAM;YAAU,UAAU;WAAS,SAAS;IAAM,CAAA;AAElH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACtB,cAAc,CAAC,EAAE,MAAM,EACvB,IAAI,GAAE,cAAmB,GAC1B,cAAc,CA0BhB;AA4DD,KAAK,cAAc,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,KAAK,eAAe,CAAA;AAE3D,eAAO,MAAM,GAAG,EAAE,cAAsD,CAAA;AACxE,eAAO,MAAM,IAAI,EAAE,cAAuD,CAAA;AAC1E,eAAO,MAAM,GAAG,EAAE,cAAsD,CAAA;AACxE,eAAO,MAAM,KAAK,EAAE,cAAwD,CAAA;AAC5E,eAAO,MAAM,MAAM,EAAE,cAAyD,CAAA"}

package/dist/spec/decorators.js

@@ -0,0 +1,93 @@
+import { ensureControllerMeta, ensureRouteMeta, } from './metadata';
+export const ROUTE_METADATA_KEY = Symbol('plat:route');
+// Store pending routes for the new decorator proposal (Stage 3)
+// Exported so that register() can process them after instance creation
+export const pendingRoutes = new Map();
+/**
+ * Controller decorator
+ * Registers a controller class. No base path routing - all methods become flat routes named after the method.
+ * The controller name is used only for OpenAPI tagging and documentation.
+ *
+ * @param controllerName - Name for documentation/OpenAPI tags (e.g., "orders", "users")
+ * @param opts - Controller-level options (auth, rate limiting, etc.)
+ */
+export function Controller(controllerName, opts = {}) {
+    return (target) => {
+        const meta = ensureControllerMeta(target);
+        // Use provided name or fall back to class name
+        meta.basePath = controllerName || target.name;
+        meta.tag = opts.tag || controllerName || target.name;
+        meta.auth = opts.auth;
+        meta.rateLimit = opts.rateLimit;
+        meta.tokenLimit = opts.tokenLimit;
+        meta.cache = opts.cache;
+        // Scan methods for old decorator proposal (metadata on methods)
+        for (const key of Object.getOwnPropertyNames(target.prototype)) {
+            const method = target.prototype[key];
+            if (typeof method === 'function' && method[ROUTE_METADATA_KEY]) {
+                const { httpMethod, auth } = method[ROUTE_METADATA_KEY];
+                const routeMeta = ensureRouteMeta(target, key);
+                routeMeta.method = httpMethod;
+                routeMeta.path = '/' + String(key);
+                routeMeta.auth = auth;
+            }
+        }
+        // Note: Stage 3 decorator addInitializers will be processed in register()
+        // after instance creation, since addInitializers run at that time
+    };
+}
+function routeDecorator(method, opts) {
+    return (target, propertyKey) => {
+        // Handle new decorator proposal (Stage 3)
+        // In the new proposal, propertyKey is a context object with kind === 'method'
+        if (propertyKey && typeof propertyKey === 'object' && propertyKey.kind === 'method') {
+            const methodName = propertyKey.name;
+            // Mark the method with route metadata through a different mechanism
+            // Use addInitializer to register routes with the class metadata
+            if (propertyKey.addInitializer) {
+                propertyKey.addInitializer(function () {
+                    const ctor = this.constructor;
+                    if (!pendingRoutes.has(ctor)) {
+                        pendingRoutes.set(ctor, []);
+                    }
+                    pendingRoutes.get(ctor).push({
+                        key: methodName,
+                        method,
+                        opts,
+                    });
+                });
+            }
+            return;
+        }
+        // Handle old decorator proposal (Stage 1/2)
+        if (target && typeof target === 'object' && target.constructor) {
+            const ctor = target.constructor;
+            const key = propertyKey;
+            const method_fn = target[key];
+            if (typeof method_fn === 'function') {
+                method_fn[ROUTE_METADATA_KEY] = { httpMethod: method, auth: opts?.auth };
+            }
+            const meta = ensureRouteMeta(ctor, key);
+            if (!meta.method) {
+                meta.method = method;
+                meta.path = '/' + String(key);
+                meta.auth = opts?.auth;
+                meta.rateLimit = opts?.rateLimit;
+                meta.tokenLimit = opts?.tokenLimit;
+                meta.cache = opts?.cache;
+                meta.summary = opts?.summary;
+                meta.description = opts?.description;
+                // Store full opts for extensibility
+                if (opts) {
+                    meta.opts = opts;
+                }
+            }
+        }
+    };
+}
+export const GET = (opts) => routeDecorator('GET', opts);
+export const POST = (opts) => routeDecorator('POST', opts);
+export const PUT = (opts) => routeDecorator('PUT', opts);
+export const PATCH = (opts) => routeDecorator('PATCH', opts);
+export const DELETE = (opts) => routeDecorator('DELETE', opts);
+//# sourceMappingURL=decorators.js.map

package/dist/spec/decorators.js.map

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

package/dist/spec/index.d.ts

@@ -0,0 +1,3 @@
+export * from './decorators';
+export * from './metadata';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/spec/index.js

@@ -0,0 +1,3 @@
+export * from './decorators';
+export * from './metadata';
+//# sourceMappingURL=index.js.map

package/dist/spec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/spec/metadata.d.ts

@@ -0,0 +1,5 @@
+import { ControllerMeta, RouteMeta } from '../types/endpoints';
+export declare function getControllerMeta(ctor: Function): ControllerMeta | undefined;
+export declare function ensureControllerMeta(ctor: Function): ControllerMeta;
+export declare function ensureRouteMeta(ctor: Function, key: string | symbol): RouteMeta;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/spec/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/spec/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAK9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAc5E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAYnE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GAAG,MAAM,GACnB,SAAS,CAUX"}

package/dist/spec/metadata.js

@@ -0,0 +1,37 @@
+const controllers = new WeakMap();
+const METADATA_KEY = Symbol('plat:controller');
+export function getControllerMeta(ctor) {
+    // Try WeakMap first
+    let meta = controllers.get(ctor);
+    if (meta) {
+        return meta;
+    }
+    // Fall back to property on the class
+    meta = ctor[METADATA_KEY];
+    if (meta) {
+        return meta;
+    }
+    return undefined;
+}
+export function ensureControllerMeta(ctor) {
+    let meta = controllers.get(ctor);
+    if (!meta) {
+        meta = {
+            basePath: '',
+            routes: new Map(),
+        };
+        controllers.set(ctor, meta);
+        ctor[METADATA_KEY] = meta;
+    }
+    return meta;
+}
+export function ensureRouteMeta(ctor, key) {
+    const ctrl = ensureControllerMeta(ctor);
+    let route = ctrl.routes.get(key);
+    if (!route) {
+        route = { name: String(key) };
+        ctrl.routes.set(key, route);
+    }
+    return route;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/spec/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/spec/metadata.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,IAAI,OAAO,EAA4B,CAAA;AAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAA;AAE9C,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,oBAAoB;IACpB,IAAI,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qCAAqC;IACrC,IAAI,GAAI,IAAY,CAAC,YAAY,CAAC,CAAA;IAClC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAc;IACjD,IAAI,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG;YACL,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,IAAI,GAAG,EAAE;SAClB,CAAA;QACD,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAE1B;QAAC,IAAY,CAAC,YAAY,CAAC,GAAG,IAAI,CAAA;IACrC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAc,EACd,GAAoB;IAEpB,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAEvC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/types/client.d.ts

@@ -0,0 +1,81 @@
+import { EndpointDef } from "./endpoints";
+import { ClientError, ServerError } from "./errors";
+import type { PLATRPCEventKind } from "../rpc";
+export type ApiClass<T> = abstract new (...args: any[]) => T;
+export interface BuiltRequest {
+    url: string;
+    headers: HeadersInit;
+    body?: string;
+}
+export interface RetryContext {
+    attempt: number;
+    maxAttempts: number;
+    error?: unknown;
+    response?: Response;
+    route: EndpointDef;
+}
+export interface ClientProxyConfig {
+    baseUrl: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    timeoutMs?: number;
+    retry?: false | {
+        maxAttempts?: number;
+        retryDelayMs?: number | ((ctx: RetryContext) => number);
+        shouldRetry?: (ctx: RetryContext) => boolean;
+    };
+    onUnauthorized?: (error: ClientError) => void | Promise<void>;
+    onForbidden?: (error: ClientError) => void | Promise<void>;
+    onRateLimited?: (error: ClientError) => void | Promise<void>;
+    onServerError?: (error: ServerError) => void | Promise<void>;
+}
+export type Clientified<T> = {
+    [K in keyof T as T[K] extends (...args: any[]) => any ? K : never]: T[K] extends (input: infer I, ctx: any) => Promise<infer O> ? (input: I, opts?: ClientCallOptions) => Promise<O> : never;
+};
+export declare const ResponseFormats: {
+    readonly JSON: "json";
+    readonly TEXT: "text";
+    readonly BLOB: "blob";
+    readonly ARRAY_BUFFER: "arrayBuffer";
+    readonly RAW: "raw";
+};
+export type ResponseFormat = typeof ResponseFormats[keyof typeof ResponseFormats];
+export declare const RequestFormats: {
+    readonly JSON: "json";
+    readonly FORM: "form";
+    readonly MULTIPART: "multipart";
+    readonly RAW: "raw";
+};
+export type RequestFormat = typeof RequestFormats[keyof typeof RequestFormats];
+export interface ClientCallOptions {
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    execution?: 'immediate' | 'deferred';
+    pollIntervalMs?: number;
+    retry?: false | Partial<NonNullable<Exclude<ClientProxyConfig['retry'], false>>>;
+    /** Controls how the response body is parsed. Defaults to 'json'. */
+    responseFormat?: ResponseFormat;
+    /** Controls how the request body is serialized. Defaults to 'json'.
+     *  - 'json': JSON.stringify, sets Content-Type: application/json
+     *  - 'form': URL-encoded, sets Content-Type: application/x-www-form-urlencoded
+     *  - 'multipart': FormData (supports File/Blob), Content-Type set by browser
+     *  - 'raw': body passed through as-is (string, ArrayBuffer, ReadableStream, etc.)
+     */
+    requestFormat?: RequestFormat;
+    /** Raw body to send when requestFormat is 'raw'. Bypasses param serialization. */
+    body?: BodyInit;
+    /** Receives intermediate per-call RPC stream events before the final result. */
+    onRpcEvent?: (event: {
+        id?: string;
+        event: PLATRPCEventKind;
+        data?: unknown;
+    }) => void | Promise<void>;
+}
+export interface ImmediateCallOptions extends ClientCallOptions {
+    execution?: 'immediate';
+}
+export interface DeferredCallOptions extends ClientCallOptions {
+    execution: 'deferred';
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

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

package/dist/types/client.js

@@ -0,0 +1,14 @@
+export const ResponseFormats = {
+    JSON: 'json',
+    TEXT: 'text',
+    BLOB: 'blob',
+    ARRAY_BUFFER: 'arrayBuffer',
+    RAW: 'raw',
+};
+export const RequestFormats = {
+    JSON: 'json',
+    FORM: 'form',
+    MULTIPART: 'multipart',
+    RAW: 'raw',
+};
+//# sourceMappingURL=client.js.map

package/dist/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":"AA8CA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,aAAa;IAC3B,GAAG,EAAE,KAAK;CACJ,CAAC;AAGX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,GAAG,EAAE,KAAK;CACJ,CAAC"}