canopycms 0.0.0

package/dist/http/router.d.ts

@@ -0,0 +1,49 @@
+import type { ApiResponse } from '../api/types';
+/**
+ * Handler function signature for Canopy API routes.
+ * Uses `any` to accommodate different handler signatures in the codebase.
+ * Some handlers take (ctx, req, params), others take (ctx, params) directly.
+ */
+export type CanopyHandler = (...args: any[]) => Promise<ApiResponse<any>>;
+/**
+ * Route definition for the Canopy API.
+ * Maps HTTP method + path pattern to a handler.
+ */
+export interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    pattern: readonly string[];
+    handler: CanopyHandler;
+    validate?: (extracted: {
+        params?: Record<string, string>;
+        body?: unknown;
+    }) => {
+        ok: true;
+        params?: unknown;
+        body?: unknown;
+    } | {
+        ok: false;
+        error: string;
+    };
+}
+/**
+ * Result of route matching.
+ */
+export interface RouteMatch {
+    handler: CanopyHandler;
+    params: Record<string, string>;
+    validate?: RouteDefinition['validate'];
+}
+/**
+ * Core router - framework-agnostic route matching.
+ */
+export interface CanopyRouter {
+    /** All registered routes */
+    readonly routes: RouteDefinition[];
+    /** Find a matching route for the given method and path segments */
+    match(method: string, segments: string[]): RouteMatch | null;
+}
+/**
+ * Create the standard Canopy router with all API routes.
+ */
+export declare function createCanopyRouter(): CanopyRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/http/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/http/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAc/C;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;AAEzE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnD,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,OAAO,EAAE,aAAa,CAAA;IAEtB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KACtE;QACE,EAAE,EAAE,IAAI,CAAA;QACR,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,GACD;QACE,EAAE,EAAE,KAAK,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACN;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9B,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAA;IAElC,mEAAmE;IACnE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAAA;CAC7D;AAyED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAyBjD"}

package/dist/http/router.js

@@ -0,0 +1,100 @@
+import { BRANCH_ROUTES } from '../api/branch';
+import { WORKFLOW_ROUTES } from '../api/branch-status';
+import { COMMENT_ROUTES } from '../api/comments';
+import { CONTENT_ROUTES } from '../api/content';
+import { REFERENCE_OPTIONS_ROUTES } from '../api/reference-options';
+import { RESOLVE_REFERENCES_ROUTES } from '../api/resolve-references';
+import { ENTRY_ROUTES } from '../api/entries';
+import { ASSET_ROUTES } from '../api/assets';
+import { PERMISSION_ROUTES } from '../api/permissions';
+import { GROUP_ROUTES } from '../api/groups';
+import { USER_ROUTES } from '../api/user';
+import { SCHEMA_ROUTES } from '../api/schema';
+/**
+ * Build the standard route definitions for the Canopy API.
+ * Assembled from co-located route definitions in each API module.
+ *
+ * This is a function (not a top-level constant) to ensure all route modules
+ * have been fully initialized before we try to access their exports.
+ * This prevents module initialization timing issues with ES modules.
+ */
+function buildCanopyRoutes() {
+    return [
+        ...Object.values(BRANCH_ROUTES),
+        ...Object.values(WORKFLOW_ROUTES),
+        ...Object.values(COMMENT_ROUTES),
+        ...Object.values(CONTENT_ROUTES),
+        ...Object.values(REFERENCE_OPTIONS_ROUTES),
+        ...Object.values(RESOLVE_REFERENCES_ROUTES),
+        ...Object.values(ENTRY_ROUTES),
+        ...Object.values(ASSET_ROUTES),
+        ...Object.values(PERMISSION_ROUTES),
+        ...Object.values(GROUP_ROUTES),
+        ...Object.values(USER_ROUTES),
+        ...Object.values(SCHEMA_ROUTES),
+    ].map((route) => ({
+        method: route.method,
+        pattern: route.pattern,
+        handler: route.handler,
+        // Include validation function if present (new-style routes from defineEndpoint)
+        validate: 'validate' in route ? route.validate : undefined,
+    }));
+}
+/**
+ * Match a route pattern against actual path segments.
+ * Supports :param for single-segment params and ...slug for catch-all.
+ */
+const matchPattern = (pattern, actual) => {
+    const params = {};
+    const actualCopy = [...actual];
+    for (const part of pattern) {
+        // Catch-all: consume remaining segments
+        if (part.startsWith('...')) {
+            const paramName = part.slice(3); // Remove '...' prefix
+            params[paramName] = actualCopy.join('/');
+            actualCopy.length = 0;
+            break;
+        }
+        const next = actualCopy.shift();
+        if (!next)
+            return null;
+        if (part.startsWith(':')) {
+            // Dynamic segment - extract param
+            params[part.slice(1)] = decodeURIComponent(next);
+        }
+        else if (part !== next) {
+            // Static segment - must match exactly
+            return null;
+        }
+    }
+    // If there are leftover segments, no match
+    if (actualCopy.length > 0)
+        return null;
+    return { params };
+};
+/**
+ * Create the standard Canopy router with all API routes.
+ */
+export function createCanopyRouter() {
+    const routes = buildCanopyRoutes();
+    return {
+        routes,
+        match(method, segments) {
+            const upperMethod = method.toUpperCase();
+            for (const route of routes) {
+                if (route.method !== upperMethod)
+                    continue;
+                const match = matchPattern(route.pattern, segments);
+                if (match) {
+                    return {
+                        handler: route.handler,
+                        params: match.params,
+                        validate: route.validate, // Include validation function if present
+                    };
+                }
+            }
+            return null;
+        },
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/http/router.js.map

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

package/dist/http/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Framework-agnostic HTTP request interface.
+ * Minimal surface area - only what CanopyCMS actually needs.
+ */
+export interface CanopyRequest {
+    /** HTTP method (GET, POST, PUT, DELETE, etc.) */
+    readonly method: string;
+    /** Full request URL as string */
+    readonly url: string;
+    /**
+     * Get request header value (case-insensitive).
+     * Returns null if header not present.
+     */
+    header(name: string): string | null;
+    /**
+     * Parse request body as JSON.
+     * Returns undefined for GET requests or empty bodies.
+     */
+    json(): Promise<unknown>;
+}
+/**
+ * Framework-agnostic HTTP response.
+ * Represents the response data to be sent back.
+ */
+export interface CanopyResponse<T = unknown> {
+    readonly status: number;
+    readonly body: T;
+    readonly headers?: Record<string, string>;
+}
+/**
+ * Create a JSON response with the given body and status code.
+ */
+export declare function jsonResponse<T>(body: T, status?: number, headers?: Record<string, string>): CanopyResponse<T>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,iCAAiC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAEnC;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,EACP,MAAM,SAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,cAAc,CAAC,CAAC,CAAC,CAEnB"}

package/dist/http/types.js

@@ -0,0 +1,7 @@
+/**
+ * Create a JSON response with the given body and status code.
+ */
+export function jsonResponse(body, status = 200, headers) {
+    return { status, body, headers };
+}
+//# sourceMappingURL=types.js.map

package/dist/http/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAkCA;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAO,EACP,MAAM,GAAG,GAAG,EACZ,OAAgC;IAEhC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAClC,CAAC"}

package/dist/id.d.ts

@@ -0,0 +1,17 @@
+import type { ContentId } from './paths/types';
+import { isValidContentId } from './paths/validation';
+/**
+ * Generate a new 12-character content ID.
+ * Uses Base58-encoded UUID, truncated for shorter filenames.
+ *
+ * Collision probability with 12 chars:
+ * - ~58^12 = 2.6 × 10^21 possible IDs
+ * - With 10,000 entries: collision chance ~0.000000002%
+ */
+export declare function generateId(): ContentId;
+/**
+ * Validate that a string is a valid content ID format.
+ * Standard format: 12 characters using Base58 alphabet (no ambiguous characters: 0, O, I, l).
+ */
+export declare const isValidId: typeof isValidContentId;
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAGtC;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,yBAAmB,CAAA"}

package/dist/id.js

@@ -0,0 +1,20 @@
+import { generate } from 'short-uuid';
+import { isValidContentId } from './paths/validation';
+/**
+ * Generate a new 12-character content ID.
+ * Uses Base58-encoded UUID, truncated for shorter filenames.
+ *
+ * Collision probability with 12 chars:
+ * - ~58^12 = 2.6 × 10^21 possible IDs
+ * - With 10,000 entries: collision chance ~0.000000002%
+ */
+export function generateId() {
+    const full = generate(); // 22 chars
+    return full.substring(0, 12); // Truncate to 12 chars
+}
+/**
+ * Validate that a string is a valid content ID format.
+ * Standard format: 12 characters using Base58 alphabet (no ambiguous characters: 0, O, I, l).
+ */
+export const isValidId = isValidContentId;
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA,CAAC,WAAW;IACnC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAc,CAAA,CAAC,uBAAuB;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './config';
+export * from './entry-schema';
+export * from './types';
+export * from './user';
+export { defineAIContentConfig } from './ai/types';
+export type { AIContentConfig, ExcludeConfig, BundleConfig, BundleFilter, FieldTransformFn, FieldTransforms, } from './ai/types';
+export type { AuthPlugin, AuthPluginFactory } from './auth/plugin';
+export type { UserSearchResult, GroupMetadata, AuthenticationResult } from './auth/types';
+export { isCanopyRequest, isHeadersLike, extractHeaders, validateAuthContext, } from './auth/context-helpers';
+export type { HeadersLike } from './auth/context-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAGtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,YAAY,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAA;AAGnB,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAClE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACzF,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './config';
+export * from './entry-schema';
+export * from './types';
+export * from './user';
+// AI content config helper — client-safe (no node: imports).
+// Server-only AI features (handler, generator) are in 'canopycms/ai'.
+export { defineAIContentConfig } from './ai/types';
+export { isCanopyRequest, isHeadersLike, extractHeaders, validateAuthContext, } from './auth/context-helpers';
+//# 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,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,6DAA6D;AAC7D,sEAAsE;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAalD,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,wBAAwB,CAAA"}

package/dist/operating-mode/client-safe-strategy.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Client-Safe Operating Mode Strategies
+ *
+ * Base strategy classes that are safe to import in 'use client' React components.
+ * NO Node.js imports (fs, path, process, etc.) - only pure logic and simple data.
+ *
+ * These classes are extended by client-unsafe strategies to add Node.js functionality.
+ */
+import type { OperatingMode, ClientSafeStrategy } from './types';
+export declare class ProdClientSafeStrategy implements ClientSafeStrategy {
+    readonly mode: OperatingMode;
+    supportsBranching(): boolean;
+    supportsStatusBadge(): boolean;
+    supportsComments(): boolean;
+    supportsPullRequests(): boolean;
+    getPermissionsFileName(): string;
+    getGroupsFileName(): string;
+    shouldCommit(): boolean;
+    shouldPush(): boolean;
+}
+export declare class LocalProdSimClientSafeStrategy implements ClientSafeStrategy {
+    readonly mode: OperatingMode;
+    supportsBranching(): boolean;
+    supportsStatusBadge(): boolean;
+    supportsComments(): boolean;
+    supportsPullRequests(): boolean;
+    getPermissionsFileName(): string;
+    getGroupsFileName(): string;
+    shouldCommit(): boolean;
+    shouldPush(): boolean;
+}
+export declare class LocalSimpleClientSafeStrategy implements ClientSafeStrategy {
+    readonly mode: OperatingMode;
+    supportsBranching(): boolean;
+    supportsStatusBadge(): boolean;
+    supportsComments(): boolean;
+    supportsPullRequests(): boolean;
+    getPermissionsFileName(): string;
+    getGroupsFileName(): string;
+    shouldCommit(): boolean;
+    shouldPush(): boolean;
+}
+/**
+ * Get the client-safe strategy for an operating mode.
+ *
+ * Strategies are memoized - one instance per mode for the entire process lifetime.
+ * Safe to call inline: clientOperatingStrategy(mode).supportsBranching()
+ *
+ * @param mode - The operating mode
+ * @returns Client-safe strategy instance
+ */
+export declare function clientOperatingStrategy(mode: OperatingMode): ClientSafeStrategy;
+/**
+ * Clear the client strategy cache (mainly for testing)
+ */
+export declare function clearClientStrategyCache(): void;
+//# sourceMappingURL=client-safe-strategy.d.ts.map

package/dist/operating-mode/client-safe-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-safe-strategy.d.ts","sourceRoot":"","sources":["../../src/operating-mode/client-safe-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAMhE,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAS;IAGrC,iBAAiB,IAAI,OAAO;IAI5B,mBAAmB,IAAI,OAAO;IAI9B,gBAAgB,IAAI,OAAO;IAI3B,oBAAoB,IAAI,OAAO;IAK/B,sBAAsB,IAAI,MAAM;IAIhC,iBAAiB,IAAI,MAAM;IAI3B,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,OAAO;CAGtB;AAMD,qBAAa,8BAA+B,YAAW,kBAAkB;IACvE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAa;IAGzC,iBAAiB,IAAI,OAAO;IAI5B,mBAAmB,IAAI,OAAO;IAI9B,gBAAgB,IAAI,OAAO;IAI3B,oBAAoB,IAAI,OAAO;IAK/B,sBAAsB,IAAI,MAAM;IAIhC,iBAAiB,IAAI,MAAM;IAI3B,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,OAAO;CAGtB;AAMD,qBAAa,6BAA8B,YAAW,kBAAkB;IACtE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAQ;IAGpC,iBAAiB,IAAI,OAAO;IAI5B,mBAAmB,IAAI,OAAO;IAI9B,gBAAgB,IAAI,OAAO;IAI3B,oBAAoB,IAAI,OAAO;IAK/B,sBAAsB,IAAI,MAAM;IAIhC,iBAAiB,IAAI,MAAM;IAI3B,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,OAAO;CAGtB;AAQD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,aAAa,GAAG,kBAAkB,CAwB/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/operating-mode/client-safe-strategy.js

@@ -0,0 +1,154 @@
+/**
+ * Client-Safe Operating Mode Strategies
+ *
+ * Base strategy classes that are safe to import in 'use client' React components.
+ * NO Node.js imports (fs, path, process, etc.) - only pure logic and simple data.
+ *
+ * These classes are extended by client-unsafe strategies to add Node.js functionality.
+ */
+// ============================================================================
+// Production Mode - Client-Safe Strategy
+// ============================================================================
+export class ProdClientSafeStrategy {
+    constructor() {
+        this.mode = 'prod';
+    }
+    // UI Feature Flags
+    supportsBranching() {
+        return true;
+    }
+    supportsStatusBadge() {
+        return true;
+    }
+    supportsComments() {
+        return true;
+    }
+    supportsPullRequests() {
+        return true;
+    }
+    // Simple Data
+    getPermissionsFileName() {
+        return 'permissions.json';
+    }
+    getGroupsFileName() {
+        return 'groups.json';
+    }
+    shouldCommit() {
+        return true;
+    }
+    shouldPush() {
+        return true;
+    }
+}
+// ============================================================================
+// Local Production Simulation - Client-Safe Strategy
+// ============================================================================
+export class LocalProdSimClientSafeStrategy {
+    constructor() {
+        this.mode = 'prod-sim';
+    }
+    // UI Feature Flags
+    supportsBranching() {
+        return true;
+    }
+    supportsStatusBadge() {
+        return true;
+    }
+    supportsComments() {
+        return true;
+    }
+    supportsPullRequests() {
+        return false; // No real GitHub in simulation
+    }
+    // Simple Data
+    getPermissionsFileName() {
+        return 'permissions.json';
+    }
+    getGroupsFileName() {
+        return 'groups.json';
+    }
+    shouldCommit() {
+        return true;
+    }
+    shouldPush() {
+        return true;
+    }
+}
+// ============================================================================
+// Local Simple Mode - Client-Safe Strategy
+// ============================================================================
+export class LocalSimpleClientSafeStrategy {
+    constructor() {
+        this.mode = 'dev';
+    }
+    // UI Feature Flags
+    supportsBranching() {
+        return false;
+    }
+    supportsStatusBadge() {
+        return false;
+    }
+    supportsComments() {
+        return false;
+    }
+    supportsPullRequests() {
+        return false;
+    }
+    // Simple Data
+    getPermissionsFileName() {
+        return 'permissions.json';
+    }
+    getGroupsFileName() {
+        return 'groups.json';
+    }
+    shouldCommit() {
+        return false;
+    }
+    shouldPush() {
+        return false;
+    }
+}
+// ============================================================================
+// Factory with Memoization
+// ============================================================================
+const clientStrategyCache = new Map();
+/**
+ * Get the client-safe strategy for an operating mode.
+ *
+ * Strategies are memoized - one instance per mode for the entire process lifetime.
+ * Safe to call inline: clientOperatingStrategy(mode).supportsBranching()
+ *
+ * @param mode - The operating mode
+ * @returns Client-safe strategy instance
+ */
+export function clientOperatingStrategy(mode) {
+    const cached = clientStrategyCache.get(mode);
+    if (cached)
+        return cached;
+    let strategy;
+    switch (mode) {
+        case 'prod':
+            strategy = new ProdClientSafeStrategy();
+            break;
+        case 'prod-sim':
+            strategy = new LocalProdSimClientSafeStrategy();
+            break;
+        case 'dev':
+            strategy = new LocalSimpleClientSafeStrategy();
+            break;
+        default: {
+            // Exhaustiveness check - TypeScript will error if a mode is not handled
+            const _exhaustive = mode;
+            throw new Error(`Unknown operating mode: ${_exhaustive}`);
+        }
+    }
+    clientStrategyCache.set(mode, strategy);
+    return strategy;
+}
+/**
+ * Clear the client strategy cache (mainly for testing)
+ */
+export function clearClientStrategyCache() {
+    clientStrategyCache.clear();
+}
+//# sourceMappingURL=client-safe-strategy.js.map

package/dist/operating-mode/client-safe-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-safe-strategy.js","sourceRoot":"","sources":["../../src/operating-mode/client-safe-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,MAAM,OAAO,sBAAsB;IAAnC;QACW,SAAI,GAAkB,MAAM,CAAA;IAmCvC,CAAC;IAjCC,mBAAmB;IACnB,iBAAiB;QACf,OAAO,IAAI,CAAA;IACb,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,cAAc;IACd,sBAAsB;QACpB,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED,iBAAiB;QACf,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,+EAA+E;AAC/E,qDAAqD;AACrD,+EAA+E;AAE/E,MAAM,OAAO,8BAA8B;IAA3C;QACW,SAAI,GAAkB,UAAU,CAAA;IAmC3C,CAAC;IAjCC,mBAAmB;IACnB,iBAAiB;QACf,OAAO,IAAI,CAAA;IACb,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oBAAoB;QAClB,OAAO,KAAK,CAAA,CAAC,+BAA+B;IAC9C,CAAC;IAED,cAAc;IACd,sBAAsB;QACpB,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED,iBAAiB;QACf,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,MAAM,OAAO,6BAA6B;IAA1C;QACW,SAAI,GAAkB,KAAK,CAAA;IAmCtC,CAAC;IAjCC,mBAAmB;IACnB,iBAAiB;QACf,OAAO,KAAK,CAAA;IACd,CAAC;IAED,mBAAmB;QACjB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,gBAAgB;QACd,OAAO,KAAK,CAAA;IACd,CAAC;IAED,oBAAoB;QAClB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,cAAc;IACd,sBAAsB;QACpB,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED,iBAAiB;QACf,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,YAAY;QACV,OAAO,KAAK,CAAA;IACd,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAED,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAqC,CAAA;AAExE;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAmB;IACzD,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,QAA4B,CAAA;IAChC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAA;YACvC,MAAK;QACP,KAAK,UAAU;YACb,QAAQ,GAAG,IAAI,8BAA8B,EAAE,CAAA;YAC/C,MAAK;QACP,KAAK,KAAK;YACR,QAAQ,GAAG,IAAI,6BAA6B,EAAE,CAAA;YAC9C,MAAK;QACP,OAAO,CAAC,CAAC,CAAC;YACR,wEAAwE;YACxE,MAAM,WAAW,GAAU,IAAI,CAAA;YAC/B,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACvC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,mBAAmB,CAAC,KAAK,EAAE,CAAA;AAC7B,CAAC"}

package/dist/operating-mode/client-unsafe-strategy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Client-Unsafe Operating Mode Strategies
+ *
+ * Full strategy implementations that extend client-safe base classes.
+ * INCLUDES Node.js imports (fs, path, process) - can only be imported server-side.
+ *
+ * These classes inherit all client-safe methods and add client-unsafe functionality.
+ */
+import type { OperatingMode, ClientUnsafeStrategy } from './types';
+/**
+ * Get the full strategy (client-unsafe) for an operating mode.
+ *
+ * Strategies are memoized - one instance per mode for the entire process lifetime.
+ * Safe to call inline: operatingStrategy(mode).getBaseRoot()
+ *
+ * Includes all client-safe methods (inherited) plus client-unsafe methods (Node.js APIs).
+ *
+ * @param mode - The operating mode
+ * @returns Full strategy instance with client-unsafe methods
+ */
+export declare function operatingStrategy(mode: OperatingMode): ClientUnsafeStrategy;
+/**
+ * Clear the strategy cache (mainly for testing)
+ */
+export declare function clearStrategyCache(): void;
+//# sourceMappingURL=client-unsafe-strategy.d.ts.map

package/dist/operating-mode/client-unsafe-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-unsafe-strategy.d.ts","sourceRoot":"","sources":["../../src/operating-mode/client-unsafe-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAqPlE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,oBAAoB,CAwB3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}