canopycms 0.0.0

package/dist/api/resolve-references.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import type { ApiResponse } from './types';
+export interface ResolveReferencesBody {
+    ids: string[];
+}
+/** Response type for resolved references */
+export type ResolveReferencesResponse = ApiResponse<{
+    resolved: Record<string, unknown>;
+}>;
+/**
+ * Exported routes for router registration
+ */
+export declare const RESOLVE_REFERENCES_ROUTES: {
+    readonly post: import("./route-builder").RouteDefinition<z.ZodObject<{
+        branch: z.ZodType<import("../paths").BranchName, z.ZodTypeDef, import("../paths").BranchName>;
+    }, "strip", z.ZodTypeAny, {
+        branch: string & {
+            readonly __brand: "BranchName";
+        };
+    }, {
+        branch: string & {
+            readonly __brand: "BranchName";
+        };
+    }>, z.ZodObject<{
+        ids: z.ZodArray<z.ZodType<import("../paths").ContentId, z.ZodTypeDef, import("../paths").ContentId>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        ids: import("../paths").ContentId[];
+    }, {
+        ids: import("../paths").ContentId[];
+    }>, ResolveReferencesResponse>;
+};
+//# sourceMappingURL=resolve-references.d.ts.map

package/dist/api/resolve-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-references.d.ts","sourceRoot":"","sources":["../../src/api/resolve-references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAA0B,WAAW,EAAE,MAAM,SAAS,CAAA;AAOlE,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAED,4CAA4C;AAC5C,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAC,CAAA;AAqFF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;CAE5B,CAAA"}

package/dist/api/resolve-references.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { ContentStore } from '../content-store';
+import { defineEndpoint } from './route-builder';
+import { ReferenceResolver } from '../reference-resolver';
+import { branchNameSchema, contentIdSchema } from './validators';
+// ============================================================================
+// Zod Schemas for Validation
+// ============================================================================
+const resolveReferencesParamsSchema = z.object({
+    branch: branchNameSchema,
+});
+const resolveReferencesBodySchema = z.object({
+    ids: z.array(contentIdSchema).min(1),
+});
+const resolveReferencesHandler = async (gc, ctx, req, params, body) => {
+    const { branchContext } = gc;
+    const { ids } = body;
+    const flatSchema = branchContext.flatSchema;
+    const store = new ContentStore(branchContext.branchRoot, flatSchema);
+    // Get ID index (automatically loads if needed)
+    const idIndex = await store.idIndex();
+    // Resolve each ID to full document
+    const resolver = new ReferenceResolver(store, idIndex);
+    const resolved = {};
+    for (const id of ids) {
+        try {
+            const result = await resolver.resolve(id);
+            if (result && result.exists && result.collection && result.slug) {
+                const doc = await store.read(result.collection, result.slug);
+                if (doc && doc.data) {
+                    resolved[id] = {
+                        id,
+                        ...doc.data,
+                    };
+                }
+            }
+        }
+        catch (error) {
+            // Skip failed resolutions, don't block entire request
+            console.error(`Failed to resolve reference ID ${id}:`, error);
+        }
+    }
+    return {
+        ok: true,
+        status: 200,
+        data: { resolved },
+    };
+};
+// ============================================================================
+// Route Definitions
+// ============================================================================
+/**
+ * Resolve reference IDs to full document objects
+ * POST /:branch/resolve-references
+ * Body: { ids: string[] }
+ */
+const resolveReferences = defineEndpoint({
+    namespace: 'content',
+    name: 'resolveReferences',
+    method: 'POST',
+    path: '/:branch/resolve-references',
+    params: resolveReferencesParamsSchema,
+    body: resolveReferencesBodySchema,
+    bodyType: 'ResolveReferencesBody',
+    responseType: 'ResolveReferencesResponse',
+    response: {},
+    defaultMockData: { resolved: {} },
+    guards: ['branchAccessWithSchema'],
+    handler: resolveReferencesHandler,
+});
+/**
+ * Exported routes for router registration
+ */
+export const RESOLVE_REFERENCES_ROUTES = {
+    post: resolveReferences,
+};
+//# sourceMappingURL=resolve-references.js.map

package/dist/api/resolve-references.js.map

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

package/dist/api/route-builder.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Declarative API route builder with Zod validation.
+ *
+ * This module provides a type-safe way to define API routes that:
+ * - Validates params and body at runtime with Zod
+ * - Runs declarative guards (auth, branch access, schema loading) before handlers
+ * - Provides full TypeScript type inference
+ * - Makes code generation trivial (no regex parsing needed)
+ * - Self-documents the API surface
+ */
+import type { z } from 'zod';
+import type { ApiContext, ApiRequest } from './types';
+import { type GuardId, type ComputeGuardContext } from './guards';
+/**
+ * Cast specification for branded types in mock data.
+ * Maps field paths to cast function names.
+ *
+ * @example
+ * { 'collectionPath': 'createLogicalPath', 'items.*.path': 'createPhysicalPath' }
+ */
+export type MockDataCasts = Record<string, 'createLogicalPath' | 'createPhysicalPath' | 'as ContentId'>;
+/**
+ * Metadata for code generation
+ */
+export interface RouteMetadata {
+    namespace: string;
+    name: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    paramsSchema?: z.ZodType;
+    bodySchema?: z.ZodType;
+    bodyTypeName?: string;
+    responseTypeName: string;
+    defaultMockData?: unknown;
+    /** Casts to apply to mock data fields for branded types */
+    mockDataCasts?: MockDataCasts;
+}
+/**
+ * Global registry - generator reads this
+ */
+export declare const ROUTE_REGISTRY: RouteMetadata[];
+/**
+ * Route definition created by defineEndpoint.
+ * Contains all metadata needed for:
+ * - Server-side routing and validation
+ * - Client code generation
+ * - Type inference
+ */
+export interface RouteDefinition<TParams extends z.ZodType | undefined = undefined, TBody extends z.ZodType | undefined = undefined, TResponse = unknown> {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    pattern: readonly string[];
+    params?: TParams;
+    body?: TBody;
+    response: TResponse;
+    handler: RouteHandler<TParams, TBody, TResponse>;
+    buildPath: TParams extends z.ZodType ? (params: z.infer<TParams>) => string : () => string;
+    validate: (extracted: {
+        params?: Record<string, string>;
+        body?: unknown;
+    }) => {
+        ok: true;
+        params?: TParams extends z.ZodType ? z.infer<TParams> : undefined;
+        body?: TBody extends z.ZodType ? z.infer<TBody> : undefined;
+    } | {
+        ok: false;
+        error: string;
+    };
+}
+/**
+ * Handler function signature with validated params and body (no guards)
+ */
+export type RouteHandler<TParams extends z.ZodType | undefined, TBody extends z.ZodType | undefined, TResponse> = (ctx: ApiContext, req: ApiRequest, ...args: [
+    ...(TParams extends z.ZodType ? [params: z.infer<TParams>] : []),
+    ...(TBody extends z.ZodType ? [body: z.infer<TBody>] : [])
+]) => Promise<TResponse>;
+/**
+ * Guarded handler: receives guard context as first argument.
+ * The guard context shape is computed from the declared guards.
+ */
+export type GuardedRouteHandler<TGuards extends readonly GuardId[], TParams extends z.ZodType | undefined, TBody extends z.ZodType | undefined, TResponse> = (gc: ComputeGuardContext<TGuards>, ctx: ApiContext, req: ApiRequest, ...args: [
+    ...(TParams extends z.ZodType ? [params: z.infer<TParams>] : []),
+    ...(TBody extends z.ZodType ? [body: z.infer<TBody>] : [])
+]) => Promise<TResponse>;
+/** Base config fields shared by guarded and unguarded endpoints */
+interface EndpointConfigBase<TParams extends z.ZodType | undefined, TBody extends z.ZodType | undefined> {
+    namespace: string;
+    name: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    params?: TParams;
+    body?: TBody;
+    bodyType?: string;
+    responseType: string;
+    response: unknown;
+    defaultMockData?: unknown;
+    mockDataCasts?: MockDataCasts;
+}
+/** Config for an endpoint without guards */
+interface UnguardedEndpointConfig<TParams extends z.ZodType | undefined, TBody extends z.ZodType | undefined, TResponse> extends EndpointConfigBase<TParams, TBody> {
+    guards?: undefined;
+    response: TResponse;
+    handler: RouteHandler<TParams, TBody, TResponse>;
+}
+/** Config for an endpoint with guards */
+interface GuardedEndpointConfig<TGuards extends readonly [GuardId, ...GuardId[]], TParams extends z.ZodType | undefined, TBody extends z.ZodType | undefined, TResponse> extends EndpointConfigBase<TParams, TBody> {
+    guards: TGuards;
+    response: TResponse;
+    handler: GuardedRouteHandler<TGuards, TParams, TBody, TResponse>;
+}
+/** Define an endpoint without guards */
+export declare function defineEndpoint<TParams extends z.ZodType | undefined = undefined, TBody extends z.ZodType | undefined = undefined, TResponse = unknown>(config: UnguardedEndpointConfig<TParams, TBody, TResponse>): RouteDefinition<TParams, TBody, TResponse>;
+/** Define an endpoint with declarative guards */
+export declare function defineEndpoint<TGuards extends readonly [GuardId, ...GuardId[]], TParams extends z.ZodType | undefined = undefined, TBody extends z.ZodType | undefined = undefined, TResponse = unknown>(config: GuardedEndpointConfig<TGuards, TParams, TBody, TResponse>): RouteDefinition<TParams, TBody, TResponse>;
+/**
+ * Get all registered routes (for code generation)
+ */
+export declare function getAllRoutes(): RouteMetadata[];
+export {};
+//# sourceMappingURL=route-builder.d.ts.map

package/dist/api/route-builder.d.ts.map

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

package/dist/api/route-builder.js

@@ -0,0 +1,108 @@
+/**
+ * Declarative API route builder with Zod validation.
+ *
+ * This module provides a type-safe way to define API routes that:
+ * - Validates params and body at runtime with Zod
+ * - Runs declarative guards (auth, branch access, schema loading) before handlers
+ * - Provides full TypeScript type inference
+ * - Makes code generation trivial (no regex parsing needed)
+ * - Self-documents the API surface
+ */
+import { executeGuards } from './guards';
+/**
+ * Global registry - generator reads this
+ */
+export const ROUTE_REGISTRY = [];
+/** Implementation — uses `any` for the union of overloaded config types */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function defineEndpoint(config) {
+    // Register for code generation
+    ROUTE_REGISTRY.push({
+        namespace: config.namespace,
+        name: config.name,
+        method: config.method,
+        path: config.path,
+        paramsSchema: config.params,
+        bodySchema: config.body,
+        bodyTypeName: config.bodyType,
+        responseTypeName: config.responseType,
+        defaultMockData: config.defaultMockData,
+        mockDataCasts: config.mockDataCasts,
+    });
+    // Convert path template to pattern array for router
+    const pattern = config.path.split('/').filter(Boolean);
+    // Build path function - handles param substitution
+    const buildPath = (paramsOrNothing) => {
+        if (!config.params) {
+            return config.path;
+        }
+        let result = config.path;
+        const params = paramsOrNothing;
+        for (const [key, value] of Object.entries(params)) {
+            result = result.replace(`:${key}`, encodeURIComponent(String(value)));
+        }
+        return result;
+    };
+    // Validate params and body using Zod
+    const validate = (extracted) => {
+        const result = { ok: true };
+        if (config.params) {
+            const paramsResult = config.params.safeParse(extracted.params);
+            if (!paramsResult.success) {
+                return {
+                    ok: false,
+                    error: `Invalid params: ${paramsResult.error.message}`,
+                };
+            }
+            result.params = paramsResult.data;
+        }
+        if (config.body) {
+            const bodyResult = config.body.safeParse(extracted.body);
+            if (!bodyResult.success) {
+                return { ok: false, error: `Invalid body: ${bodyResult.error.message}` };
+            }
+            result.body = bodyResult.data;
+        }
+        return result;
+    };
+    // Wrap handler with guard execution if guards are declared
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let handler;
+    if (config.guards && config.guards.length > 0) {
+        const guards = config.guards;
+        const guardedHandler = config.handler;
+        handler = async (ctx, req, ...args) => {
+            // Extract params from args (first arg after ctx/req if present)
+            const params = args[0] ?? {};
+            const guardResult = await executeGuards(guards, ctx, req, params);
+            if (!guardResult.ok) {
+                return guardResult.response;
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+            return guardedHandler(guardResult.guardContext, ctx, req, ...args);
+        };
+    }
+    else {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        handler = config.handler;
+    }
+    return {
+        method: config.method,
+        path: config.path,
+        pattern,
+        params: config.params,
+        body: config.body,
+        response: config.response,
+        handler,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        buildPath: buildPath,
+        validate,
+    };
+}
+/**
+ * Get all registered routes (for code generation)
+ */
+export function getAllRoutes() {
+    return ROUTE_REGISTRY;
+}
+//# sourceMappingURL=route-builder.js.map

package/dist/api/route-builder.js.map

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