@facetlayer/prism-framework 0.4.0 → 0.4.1

package/README.md

@@ -1,11 +1,51 @@
 # @facetlayer/prism-framework
 
-Base library and CLI tools for the Prism app framework.
+A TypeScript framework for building web-based SaaS applications and desktop Electron apps. Includes a server framework, CLI tools, and development utilities.
+
+**Important:** This framework uses **Zod v4** for schema validation. Make sure to install `zod@^4` — Zod v3 is not compatible and will produce confusing type errors.
 
 ## Installation
 
 ```bash
-npm install @facetlayer/prism-framework
+pnpm add @facetlayer/prism-framework zod@^4
+```
+
+## Quick Start
+
+```typescript
+import { createEndpoint, App, startServer, ServiceDefinition } from '@facetlayer/prism-framework';
+import { z } from 'zod';
+
+// Define a service with endpoints
+const myService: ServiceDefinition = {
+  name: 'hello',
+  endpoints: [
+    createEndpoint({
+      method: 'GET',
+      path: '/hello',
+      description: 'Say hello',
+      requestSchema: z.object({ name: z.string() }),
+      responseSchema: z.object({ message: z.string() }),
+      handler: async (input) => {
+        return { message: `Hello, ${input.name}!` };
+      },
+    }),
+  ],
+};
+
+// Create app and start server
+async function main() {
+  const app = new App({ services: [myService] });
+
+  await startServer({
+    app,
+    port: 3000,
+  });
+
+  console.log('Server running at http://localhost:3000');
+}
+
+main().catch(console.error);
 ```
 
 ## CLI Commands
@@ -25,9 +65,9 @@ npm install @facetlayer/prism-framework
 prism list-endpoints
 
 # Call endpoints
-prism call /api/users                              # GET request
-prism call POST /api/users --name "John"           # POST with body
-prism call POST /api/data --config '{"timeout":30}'  # JSON arguments
+prism call /users                              # GET request
+prism call POST /users --name "John"           # POST with body
+prism call POST /data --config '{"timeout":30}'  # JSON arguments
 
 # Generate TypeScript types
 prism generate-api-clients --out ./src/api-types.ts
@@ -39,9 +79,137 @@ prism get-doc getting-started
 
 ## Documentation
 
-Once installed, the CLI has `prism list-docs` and `prism get-doc ...` commands to browse through the documentation files.
+This package includes built-in documentation. Use the CLI to explore:
 
-Run `prism list-docs` to see available documentation topics, including:
+```bash
+prism list-docs
+prism get-doc <doc-name>
+```
+
+Available documentation includes:
 - `getting-started` - Setup guide for Prism Framework projects
-- `run-endpoint-tool` - Detailed CLI usage documentation
+- `overview` - Framework overview and concepts
+- `creating-services` - How to create services and endpoints
+- `server-setup` - Server configuration options
+- `database-setup` - Database integration
+- `authorization` - Authentication and authorization
+- `launch-configuration` - App configuration options
+- `endpoint-tools` - CLI tools for calling endpoints
 - `env-files` - Environment configuration strategy
+- `stdin-protocol` - Stdin/stdout protocol for subprocess communication
+
+## Testing Endpoints
+
+Use the `prism` CLI to test your endpoints:
+
+```bash
+prism list-endpoints    # See all available endpoints
+prism call /hello       # Call an endpoint (GET)
+prism call POST /users --name "John" --email "john@example.com"  # POST with data
+```
+
+This is preferred over using curl directly because the `prism` CLI automatically reads your `.env` file for the API port.
+
+## Environment Variables
+
+```bash
+# Optional
+PORT=3000
+PRISM_API_PORT=3000     # Used by prism CLI tools
+API_BASE_URL=https://api.example.com
+WEB_BASE_URL=https://example.com
+ENABLE_TEST_ENDPOINTS=true
+```
+
+## Key Concepts
+
+### App
+
+The `App` class wraps your services and provides endpoint routing:
+
+```typescript
+import { App } from '@facetlayer/prism-framework';
+
+const app = new App({ services: [service1, service2] });
+```
+
+### ServiceDefinition
+
+A service groups related endpoints together:
+
+```typescript
+const userService: ServiceDefinition = {
+  name: 'users',
+  endpoints: [
+    // ... endpoint definitions
+  ],
+};
+```
+
+### createEndpoint
+
+Define type-safe endpoints with Zod schemas:
+
+```typescript
+createEndpoint({
+  method: 'POST',
+  path: '/users',
+  description: 'Create a new user',
+  requestSchema: z.object({
+    name: z.string(),
+    email: z.string().email(),
+  }),
+  responseSchema: z.object({
+    id: z.number(),
+    name: z.string(),
+    email: z.string(),
+  }),
+  handler: async (input) => {
+    // input is typed based on requestSchema
+    return { id: 1, name: input.name, email: input.email };
+  },
+});
+```
+
+## Stdin/Stdout Protocol Mode
+
+Prism apps can run as subprocesses communicating over stdin/stdout instead of opening an HTTP port. This is useful for composing multiple Prism apps into a single web UI.
+
+```typescript
+import { App, startServer, startStdinServer } from '@facetlayer/prism-framework';
+
+const app = new App({ services: [myService] });
+
+if (process.argv.includes('--stdin')) {
+  // Communicate via JSON-over-stdin instead of HTTP
+  startStdinServer({ app });
+} else {
+  await startServer({ app, port: 3000 });
+}
+```
+
+When running in stdin mode, send newline-delimited JSON requests to stdin and receive JSON responses on stdout:
+
+```json
+{"id":"req-1","method":"GET","path":"/items"}
+```
+
+See `prism get-doc stdin-protocol` for full protocol details.
+
+## Zod Version Requirements
+
+This framework requires **Zod 4.x** (specifically `zod@^4.0.5` or later). If you see TypeScript errors like:
+
+```
+Type 'ZodObject<...>' is missing properties from type 'ZodType<...>': def, type, toJSONSchema, check...
+```
+
+This indicates a Zod version mismatch. Ensure your project uses Zod 4.x:
+
+```bash
+pnpm add zod@^4.0.5
+```
+
+## License
+
+MIT

package/dist/Errors.d.ts

@@ -0,0 +1,38 @@
+export declare class HttpError extends Error {
+    statusCode: number;
+    details?: any;
+    constructor(statusCode: number, message: string, details?: any);
+}
+export declare class BadRequestError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class SchemaValidationError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class ResponseSchemaValidationError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class UnauthorizedError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class ForbiddenError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class NotFoundError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class ConflictError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class ValidationError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class NotImplementedError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare class ServiceUnavailableError extends HttpError {
+    constructor(message?: string, details?: any);
+}
+export declare function createErrorFromStatus(statusCode: number, message?: string, details?: any): HttpError;
+export declare function isHttpError(error: any): error is HttpError;
+//# sourceMappingURL=Errors.d.ts.map

package/dist/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../src/Errors.ts"],"names":[],"mappings":"AAMA,qBAAa,SAAU,SAAQ,KAAK;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,GAAG,CAAC;gBAET,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAM/D;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,GAAE,MAAsB,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3D;AAED,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,OAAO,GAAE,MAAkC,EAAE,OAAO,CAAC,EAAE,GAAG;CAIvE;AAED,qBAAa,6BAA8B,SAAQ,SAAS;gBAC9C,OAAO,GAAE,MAA2C,EAAE,OAAO,CAAC,EAAE,GAAG;CAIhF;AAED,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,OAAO,GAAE,MAAuB,EAAE,OAAO,CAAC,EAAE,GAAG;CAI5D;AAED,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,GAAE,MAAoB,EAAE,OAAO,CAAC,EAAE,GAAG;CAIzD;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,GAAE,MAAoB,EAAE,OAAO,CAAC,EAAE,GAAG;CAIzD;AAED,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,GAAE,MAAmB,EAAE,OAAO,CAAC,EAAE,GAAG;CAIxD;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,GAAE,MAA2B,EAAE,OAAO,CAAC,EAAE,GAAG;CAIhE;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,GAAE,MAA0B,EAAE,OAAO,CAAC,EAAE,GAAG;CAI/D;AAED,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,OAAO,GAAE,MAA8B,EAAE,OAAO,CAAC,EAAE,GAAG;CAInE;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,GAAG,GACZ,SAAS,CAuBX;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,SAAS,CAE1D"}

package/dist/Metrics.d.ts

@@ -0,0 +1,5 @@
+export declare function setupMetrics(): void;
+export declare function recordHttpRequest(method: string, endpoint: string): void;
+export declare function recordHttpResponse(method: string, endpoint: string, statusCode: number, duration: number): void;
+export declare function getMetrics(): Promise<string>;
+//# sourceMappingURL=Metrics.d.ts.map

package/dist/Metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.d.ts","sourceRoot":"","sources":["../src/Metrics.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,IAAI,IAAI,CAkBnC;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKxE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CAKN;AAGD,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAK5C"}

package/dist/RequestContext.d.ts

@@ -0,0 +1,17 @@
+import { AsyncLocalStorage } from 'async_hooks';
+import type { Request, Response } from 'express';
+import type { Authorization } from './authorization/Authorization.ts';
+export interface RequestContext {
+    requestId: string;
+    startTime: number;
+    req?: Request;
+    res?: Response;
+    auth: Authorization;
+}
+export declare const requestContextStorage: AsyncLocalStorage<RequestContext>;
+export declare function withRequestContext<T>(context: RequestContext, fn: () => T): T;
+export declare function getCurrentRequestContext(): RequestContext | undefined;
+export declare const RequestContext: {
+    getCurrentRequestContext: typeof getCurrentRequestContext;
+};
+//# sourceMappingURL=RequestContext.d.ts.map

package/dist/RequestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../src/RequestContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAYtE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,mCAA0C,CAAC;AAG7E,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7E;AAED,wBAAgB,wBAAwB,IAAI,cAAc,GAAG,SAAS,CAErE;AAED,eAAO,MAAM,cAAc;;CAE1B,CAAC"}

package/dist/ServiceDefinition.d.ts

@@ -0,0 +1,16 @@
+import type { NextFunction, Request, Response } from 'express';
+import type { EndpointDefinition } from './web/ExpressEndpointSetup.ts';
+export interface MiddlewareDefinition {
+    path: string;
+    handler: (req: Request, res: Response, next: NextFunction) => void;
+}
+export interface ServiceDefinition {
+    name: string;
+    endpoints?: EndpointDefinition[];
+    middleware?: MiddlewareDefinition[];
+    databases?: Record<string, {
+        statements: string[];
+    }>;
+    startJobs?: () => Promise<void>;
+}
+//# sourceMappingURL=ServiceDefinition.d.ts.map

package/dist/ServiceDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDefinition.d.ts","sourceRoot":"","sources":["../src/ServiceDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;CACpE;AAYD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IAGb,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAGjC,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAGpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC,CAAC;IAGH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC"}

package/dist/app/PrismApp.d.ts

@@ -0,0 +1,31 @@
+import type { EndpointDefinition } from '../web/ExpressEndpointSetup.ts';
+import type { ServiceDefinition } from '../ServiceDefinition.ts';
+import { type CallEndpointOptions } from './callEndpoint.ts';
+export interface PrismAppConfig {
+    name?: string;
+    description?: string;
+    services?: ServiceDefinition[];
+}
+export declare function endpointKey(method: string, path: string): string;
+export declare class PrismApp {
+    endpointMap: Map<string, EndpointDefinition>;
+    services: ServiceDefinition[];
+    name: string;
+    description: string;
+    constructor(config?: PrismAppConfig);
+    /**
+     * Add a service to the app. Endpoints from the service will be registered
+     * and available for routing.
+     */
+    addService(service: ServiceDefinition): void;
+    getAllServices(): ServiceDefinition[];
+    getEndpoint(method: string, path: string): EndpointDefinition | undefined;
+    matchEndpoint(method: string, path: string): {
+        endpoint: EndpointDefinition;
+        params: Record<string, string>;
+    } | undefined;
+    private matchPath;
+    listAllEndpoints(): EndpointDefinition[];
+    callEndpoint(options: CallEndpointOptions): Promise<any>;
+}
+//# sourceMappingURL=PrismApp.d.ts.map

package/dist/app/PrismApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismApp.d.ts","sourceRoot":"","sources":["../../src/app/PrismApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,qBAAa,QAAQ;IACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;gBAER,MAAM,GAAE,cAAmB;IAcvC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAW5C,cAAc,IAAI,iBAAiB,EAAE;IAIrC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAKzE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,kBAAkB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS;IAyBzH,OAAO,CAAC,SAAS;IA0BjB,gBAAgB,IAAI,kBAAkB,EAAE;IAIxC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC;CAGzD"}

package/dist/app/callEndpoint.d.ts

@@ -0,0 +1,13 @@
+import { PrismApp } from './PrismApp.ts';
+export interface CallEndpointOptions {
+    method: string;
+    path: string;
+    input?: any;
+    onResponseSchemaFail?: (error: any, result: any) => void;
+}
+/**
+ * Call an endpoint programmatically without going through HTTP
+ * This is useful for testing or for calling endpoints from scripts/tools
+ */
+export declare function callEndpoint(app: PrismApp, options: CallEndpointOptions): Promise<any>;
+//# sourceMappingURL=callEndpoint.d.ts.map

package/dist/app/callEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callEndpoint.d.ts","sourceRoot":"","sources":["../../src/app/callEndpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CAC1D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,gBAuC7E"}

package/dist/app/validateApp.d.ts

@@ -0,0 +1,20 @@
+import type { PrismApp } from './PrismApp.ts';
+export interface ValidationError {
+    message: string;
+    endpoints?: string[];
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Validates a PrismApp configuration, checking for issues like duplicate operationIds.
+ * This should be run at server startup to catch configuration errors early.
+ */
+export declare function validateApp(app: PrismApp): ValidationResult;
+/**
+ * Validates the app and throws an error if validation fails.
+ * Use this at server startup to ensure the app is properly configured.
+ */
+export declare function validateAppOrThrow(app: PrismApp): void;
+//# sourceMappingURL=validateApp.d.ts.map

package/dist/app/validateApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateApp.d.ts","sourceRoot":"","sources":["../../src/app/validateApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,gBAAgB,CAa3D;AAqCD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAMtD"}

package/dist/authorization/AuthSource.d.ts

@@ -0,0 +1,8 @@
+export interface AuthSource {
+    type: string;
+}
+export interface CookieAuthSource extends AuthSource {
+    type: 'cookie';
+    sessionId: string;
+}
+//# sourceMappingURL=AuthSource.d.ts.map

package/dist/authorization/AuthSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthSource.d.ts","sourceRoot":"","sources":["../../src/authorization/AuthSource.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/authorization/Authorization.d.ts

@@ -0,0 +1,24 @@
+import type { CookieAuthSource, AuthSource } from './AuthSource.ts';
+import type { Resource } from './Resource.ts';
+export type Permission = string;
+export interface UserPermissions {
+    userId: string;
+    permissions: Permission[];
+}
+export declare class Authorization {
+    private resources;
+    private authSources;
+    private userPermissions?;
+    constructor(resources?: Resource[], authSources?: AuthSource[]);
+    addResource(resource: Resource): void;
+    hasResource(type: Resource['type']): boolean;
+    getResource(type: Resource['type']): Resource | undefined;
+    getAllResources(): Resource[];
+    addAuthSource(authSource: AuthSource): void;
+    getAuthSources(): AuthSource[];
+    getCookieAuthSource(): CookieAuthSource | undefined;
+    setUserPermissions(userPermissions: UserPermissions): void;
+    getUserPermissions(): UserPermissions | undefined;
+    hasPermission(permission: Permission): boolean;
+}
+//# sourceMappingURL=Authorization.d.ts.map

package/dist/authorization/Authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Authorization.d.ts","sourceRoot":"","sources":["../../src/authorization/Authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAaD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,eAAe,CAAC,CAAkB;gBAE9B,SAAS,GAAE,QAAQ,EAAO,EAAE,WAAW,GAAE,UAAU,EAAO;IAQtE,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIrC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO;IAI5C,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,GAAG,SAAS;IAIzD,eAAe,IAAI,QAAQ,EAAE;IAI7B,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAI3C,cAAc,IAAI,UAAU,EAAE;IAI9B,mBAAmB,IAAI,gBAAgB,GAAG,SAAS;IAInD,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI;IAI1D,kBAAkB,IAAI,eAAe,GAAG,SAAS;IAIjD,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;CAM/C"}

package/dist/authorization/Resource.d.ts

@@ -0,0 +1,5 @@
+export interface Resource {
+    type: 'user' | 'project' | 'session' | 'custom';
+    id: string;
+}
+//# sourceMappingURL=Resource.d.ts.map

package/dist/authorization/Resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../src/authorization/Resource.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChD,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/authorization/index.d.ts

@@ -0,0 +1,5 @@
+export { Authorization } from './Authorization.ts';
+export type { Permission, UserPermissions } from './Authorization.ts';
+export type { CookieAuthSource, AuthSource } from './AuthSource.ts';
+export type { Resource } from './Resource.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authorization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/cli.js

@@ -150,7 +150,7 @@ async function listEndpoints(baseUrl) {
   try {
     const response = await callEndpoint({
       baseUrl,
-      positionalArgs: ["GET", "/endpoints.json"],
+      positionalArgs: ["GET", "/api/endpoints.json"],
       namedArgs: {},
       quiet: true
     });

package/dist/databases/DatabaseInitializationOptions.d.ts

@@ -0,0 +1,9 @@
+import type { ServiceDefinition } from '../ServiceDefinition.ts';
+import type { LoadDatabaseFn, MigrationBehavior } from '@facetlayer/sqlite-wrapper';
+export interface DatabaseInitializationOptions {
+    migrationBehavior: MigrationBehavior;
+    databasePath: string;
+    services?: ServiceDefinition[];
+    loadDatabase: LoadDatabaseFn;
+}
+//# sourceMappingURL=DatabaseInitializationOptions.d.ts.map

package/dist/databases/DatabaseInitializationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseInitializationOptions.d.ts","sourceRoot":"","sources":["../../src/databases/DatabaseInitializationOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,YAAY,EAAE,cAAc,CAAC;CAC9B"}

package/dist/databases/DatabaseSetup.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceDefinition } from '../ServiceDefinition.ts';
+export declare function getStatementsForDatabase(databaseName: string, services: ServiceDefinition[]): string[];
+//# sourceMappingURL=DatabaseSetup.d.ts.map

package/dist/databases/DatabaseSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseSetup.d.ts","sourceRoot":"","sources":["../../src/databases/DatabaseSetup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAQjE,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,MAAM,EAAE,CAOV"}

package/dist/endpoints/createEndpoint.d.ts

@@ -0,0 +1,4 @@
+import type { EndpointDefinition } from "../web/ExpressEndpointSetup.ts";
+export { getEffectiveOperationId, isValidOperationId, generateOperationIdFromPath } from "./getEffectiveOperationId.ts";
+export declare function createEndpoint(definition: EndpointDefinition): EndpointDefinition;
+//# sourceMappingURL=createEndpoint.d.ts.map

package/dist/endpoints/createEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createEndpoint.d.ts","sourceRoot":"","sources":["../../src/endpoints/createEndpoint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAExH,wBAAgB,cAAc,CAC1B,UAAU,EAAE,kBAAkB,GAC/B,kBAAkB,CA6BpB"}

package/dist/endpoints/getEffectiveOperationId.d.ts

@@ -0,0 +1,19 @@
+import type { EndpointDefinition } from "../web/ExpressEndpointSetup.ts";
+/**
+ * Validates that an operationId is not a known bad value.
+ */
+export declare function isValidOperationId(operationId: string | undefined): boolean;
+/**
+ * Generates an operationId from the method and path.
+ * e.g., "GET /users/:id" -> "getUsers_id"
+ * e.g., "GET /users/:id/undo-redo-state" -> "getUsers_idUndoRedoState"
+ */
+export declare function generateOperationIdFromPath(method: string, path: string): string;
+/**
+ * Gets the effective operationId for an endpoint using the priority:
+ * 1. Explicit operationId if defined
+ * 2. Handler function name if not a known bad value
+ * 3. Auto-generated from method + path
+ */
+export declare function getEffectiveOperationId(definition: EndpointDefinition): string;
+//# sourceMappingURL=getEffectiveOperationId.d.ts.map

package/dist/endpoints/getEffectiveOperationId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEffectiveOperationId.d.ts","sourceRoot":"","sources":["../../src/endpoints/getEffectiveOperationId.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAYzE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAK3E;AAuBD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBhF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAc9E"}

package/dist/env/Env.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Env.d.ts.map

package/dist/env/Env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Env.d.ts","sourceRoot":"","sources":["../../src/env/Env.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export { BadRequestError, ConflictError, ForbiddenError, HttpError, NotFoundError, NotImplementedError, ServiceUnavailableError, UnauthorizedError, ValidationError, createErrorFromStatus, isHttpError, } from './Errors.ts';
+export { createExpressApp, startServer } from './web/ExpressAppSetup.ts';
+export type { ServerSetupConfig, WebConfig } from './web/ExpressAppSetup.ts';
+export { getMetrics, recordHttpRequest, recordHttpResponse } from './Metrics.ts';
+export type { RequestContext } from './RequestContext.ts';
+export { getCurrentRequestContext, withRequestContext } from './RequestContext.ts';
+export { requestContextMiddleware } from './web/requestContextMiddleware.ts';
+export type { MiddlewareDefinition, ServiceDefinition } from './ServiceDefinition.ts';
+export type { CookieAuthSource, AuthSource, Permission, Resource, UserPermissions } from './authorization/index.ts';
+export { Authorization } from './authorization/index.ts';
+export { corsMiddleware } from './web/corsMiddleware.ts';
+export type { CorsConfig } from './web/corsMiddleware.ts';
+export type { EndpointDefinition } from './web/ExpressEndpointSetup.ts';
+export { getRequestDataFromReq, mountMiddleware, mountMiddlewares, mountPrismApp, } from './web/ExpressEndpointSetup.ts';
+export { localhostOnlyMiddleware } from './web/localhostOnlyMiddleware.ts';
+export { SseResponse } from './web/SseResponse.ts';
+export { createEndpoint } from './endpoints/createEndpoint.ts';
+export type { OpenAPIDocumentInfo, ParseExpressPathForOpenAPIResult } from './web/openapi/OpenAPI.ts';
+export { generateOpenAPISchema, parseExpressPathForOpenAPI } from './web/openapi/OpenAPI.ts';
+export { createListingEndpoints } from './web/EndpointListing.ts';
+export { ConnectionManager } from './sse/ConnectionManager.ts';
+export { PrismApp as App } from './app/PrismApp.ts';
+export type { PrismAppConfig as AppConfig } from './app/PrismApp.ts';
+export type { LoggingSettings, LaunchConfig } from './launch/launchConfig.ts';
+export { getDatabaseConfig, getLaunchConfig, getLoggingConfig, setLaunchConfig } from './launch/launchConfig.ts';
+export type { DatabaseInitializationOptions } from './databases/DatabaseInitializationOptions.ts';
+export type { MigrationBehavior } from '@facetlayer/sqlite-wrapper';
+export { getStatementsForDatabase } from './databases/DatabaseSetup.ts';
+export type { CallEndpointOptions } from './app/callEndpoint.ts';
+export { callEndpoint } from './app/callEndpoint.ts';
+export type { StdinRequest, StdinResponse, StdinServerConfig } from './stdin/StdinServer.ts';
+export { startStdinServer } from './stdin/StdinServer.ts';
+export { setLogStderr } from './logging/index.ts';
+//# 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":"AACA,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjF,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACpH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,YAAY,EAAE,mBAAmB,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,cAAc,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGrE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGjH,YAAY,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAClG,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}