@lssm/lib.contracts 0.0.0-canary-20251207012602 → 0.0.0-canary-20251207043720

package/dist/resources.d.ts

@@ -1,64 +0,0 @@
-import { Tag } from "./ownership.js";
-import { z as z$1 } from "zod";
-
-//#region src/resources.d.ts
-interface ResourceMeta {
-  /** URI scheme, e.g. "content://doc/{id}" or "marketplace://offers/{city}/{tag}" */
-  uriTemplate: string;
-  /** Human title for discovery */
-  title: string;
-  /** Short description */
-  description?: string;
-  /** MIME type for resource body */
-  mimeType: string;
-  /** Tags for filtering/grouping */
-  tags?: Tag[];
-}
-interface ResourceTemplateSpec<I extends z$1.ZodType> {
-  meta: ResourceMeta;
-  /** Arguments to materialize the URI (zod validates input) */
-  input: I;
-  /**
-   * Resolve returns the resource body and a resolved URI.
-   * It MUST be read-only (no side effects).
-   */
-  resolve: (args: z$1.infer<I>, ctx: {
-    userId?: string | null;
-    orgId?: string | null;
-    locale?: string;
-  }) => Promise<{
-    uri: string;
-    mimeType?: string;
-    data: Uint8Array | string;
-  }>;
-}
-declare function defineResourceTemplate<I extends z$1.ZodType>(spec: ResourceTemplateSpec<I>): ResourceTemplateSpec<I>;
-declare class ResourceRegistry {
-  private templates;
-  register<I extends z$1.ZodType>(tmpl: ResourceTemplateSpec<I>): this;
-  listTemplates(): ResourceTemplateSpec<any>[];
-  /** Try to match a concrete URI to a template by naive pattern substitution */
-  match(uri: string): {
-    tmpl: ResourceTemplateSpec<any>;
-    params: Record<string, string>;
-  } | undefined;
-}
-interface ResourceRefDescriptor<Many extends boolean> {
-  kind: 'resource_ref';
-  /** URI template, e.g. 'strit://spot/{id}' */
-  uriTemplate: string;
-  /** Variable name inside result payload to substitute into template; defaults to 'id' */
-  varName?: string;
-  /** Optional GraphQL type name to use when exposing over GraphQL (e.g., 'Spot') */
-  graphQLType: string;
-  /** Cardinality: when present and true, the handler returns an array of resources */
-  many: Many;
-}
-declare function resourceRef<Many extends boolean>(uriTemplate: string, opts: {
-  varName?: string;
-  graphQLType: string;
-  many: Many;
-}): ResourceRefDescriptor<Many>;
-declare function isResourceRef(x: unknown): x is ResourceRefDescriptor<boolean>;
-//#endregion
-export { ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, defineResourceTemplate, isResourceRef, resourceRef };

package/dist/schema/dist/EnumType.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import"graphql";

package/dist/schema/dist/FieldType.js

@@ -1 +0,0 @@
-import{z as e}from"zod";import{GraphQLScalarType as t}from"graphql";var n=class extends t{zodSchema;jsonSchemaDef;constructor(e){super(e),this.zodSchema=e.zod,this.jsonSchemaDef=e.jsonSchema}getZod(){return this.zodSchema}getPothos(){return this}getJson(){return typeof this.jsonSchemaDef==`function`?this.jsonSchemaDef():this.jsonSchemaDef}getJsonSchemaDef(){return this.jsonSchemaDef}getJsonSchema(){let e=t=>{let n=typeof t==`function`?t():t;if(Array.isArray(n))return n.map(t=>e(t));if(n&&typeof n==`object`){let t={};for(let[r,i]of Object.entries(n))t[r]=e(i);return t}return n};return e(this.getJson())}};export{n};

package/dist/schema/dist/ScalarTypeEnum.js

@@ -1 +0,0 @@
-import{n as e}from"./FieldType.js";import{z as t}from"zod";import{Kind as n}from"graphql";const r=/^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/,i=/^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/,a=/^[+]?\d[\d\s().-]{3,}$/,o=/^[A-Z]{3}$/,s=/^[A-Z]{2}$/,c=-180,l={String_unsecure:()=>new e({name:`String_unsecure`,description:`Unvalidated string scalar`,zod:t.string(),parseValue:e=>t.string().parse(e),serialize:e=>String(e),parseLiteral:e=>{if(e.kind!==n.STRING)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`string`}}),Int_unsecure:()=>new e({name:`Int_unsecure`,description:`Unvalidated integer scalar`,zod:t.number().int(),parseValue:e=>{let n=typeof e==`number`?e:Number(e);return t.number().int().parse(n)},serialize:e=>Math.trunc(typeof e==`number`?e:Number(e)),parseLiteral:e=>{if(e.kind!==n.INT)throw TypeError(`Invalid literal`);return Number(e.value)},jsonSchema:{type:`integer`}}),Float_unsecure:()=>new e({name:`Float_unsecure`,description:`Unvalidated float scalar`,zod:t.number(),parseValue:e=>{let n=typeof e==`number`?e:Number(e);return t.number().parse(n)},serialize:e=>Number(e),parseLiteral:e=>{if(e.kind!==n.FLOAT&&e.kind!==n.INT)throw TypeError(`Invalid literal`);return Number(e.value)},jsonSchema:{type:`number`}}),Boolean:()=>new e({name:`Boolean`,description:`Unvalidated boolean scalar`,zod:t.boolean(),parseValue:e=>t.coerce.boolean().parse(e),serialize:e=>!!e,parseLiteral:e=>{if(e.kind!==n.BOOLEAN)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`boolean`}}),ID:()=>new e({name:`ID`,description:`Unvalidated id scalar`,zod:t.string(),parseValue:e=>t.string().parse(e),serialize:e=>String(e),parseLiteral:e=>{if(e.kind!==n.STRING)throw TypeError(`Invalid literal`);return e.value},jsonSchema:{type:`string`}}),JSON:()=>new e({name:`JSON`,zod:t.any(),parseValue:e=>e,serialize:e=>e,jsonSchema:{}}),JSONObject:()=>new e({name:`JSONObject`,zod:t.record(t.string(),t.any()),parseValue:e=>t.record(t.string(),t.any()).parse(e),serialize:e=>e??{},jsonSchema:{type:`object`}}),Date:()=>new e({name:`Date`,zod:t.date(),parseValue:e=>e instanceof Date?e:new Date(String(e)),serialize:e=>e instanceof Date?e.toISOString().split(`T`)[0]:String(e),jsonSchema:{type:`string`,format:`date`}}),DateTime:()=>new e({name:`DateTime`,zod:t.date(),parseValue:e=>e instanceof Date?e:new Date(String(e)),serialize:e=>e instanceof Date?e.toISOString():String(e),jsonSchema:{type:`string`,format:`date-time`}}),Time:()=>new e({name:`Time`,zod:t.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),parseValue:e=>t.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:`^\\d{2}:\\d{2}(:\\d{2})?$`}}),EmailAddress:()=>new e({name:`EmailAddress`,zod:t.string().email(),parseValue:e=>t.string().email().parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,format:`email`}}),URL:()=>new e({name:`URL`,zod:t.string().url(),parseValue:e=>t.string().url().parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,format:`uri`}}),PhoneNumber:()=>new e({name:`PhoneNumber`,zod:t.string().regex(a),parseValue:e=>t.string().regex(a).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:a.source}}),NonEmptyString:()=>new e({name:`NonEmptyString`,zod:t.string().min(1),parseValue:e=>t.string().min(1).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,minLength:1}}),Locale:()=>new e({name:`Locale`,zod:t.string().regex(r),parseValue:e=>t.string().regex(r).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:r.source}}),TimeZone:()=>new e({name:`TimeZone`,zod:t.string().regex(i),parseValue:e=>t.string().regex(i).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:i.source}}),Latitude:()=>new e({name:`Latitude`,zod:t.number().min(-90).max(90),parseValue:e=>t.coerce.number().min(-90).max(90).parse(e),serialize:e=>Number(e),jsonSchema:{type:`number`,minimum:-90,maximum:90}}),Longitude:()=>new e({name:`Longitude`,zod:t.number().min(c).max(180),parseValue:e=>t.coerce.number().min(c).max(180).parse(e),serialize:e=>Number(e),jsonSchema:{type:`number`,minimum:c,maximum:180}}),Currency:()=>new e({name:`Currency`,zod:t.string().regex(o),parseValue:e=>t.string().regex(o).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:o.source}}),CountryCode:()=>new e({name:`CountryCode`,zod:t.string().regex(s),parseValue:e=>t.string().regex(s).parse(e),serialize:e=>String(e),jsonSchema:{type:`string`,pattern:s.source}})};export{l};

package/dist/schema/dist/SchemaModel.js

@@ -1 +0,0 @@
-import"./EnumType.js";import"./FieldType.js";import{z as e}from"zod";var t=class{constructor(e){this.config=e}getZod(){let t=Object.entries(this.config.fields).reduce((t,[n,r])=>{let i=r.type.getZod(),a=r.isArray?e.array(i):i;return t[n]=r.isOptional?a.optional():a,t},{});return e.object(t)}getPothosInput(){return this.config.name}};const n=e=>new t(e);export{n,t};

package/dist/schema/dist/entity/defineEntity.js

@@ -1 +0,0 @@
-import{z as e}from"zod";

package/dist/schema/dist/entity/index.js

@@ -1 +0,0 @@
-import"./defineEntity.js";import"./types.js";

package/dist/schema/dist/entity/types.js

@@ -1 +0,0 @@
-import{z as e}from"zod";

package/dist/schema/dist/index.js

@@ -1 +0,0 @@
-import"./EnumType.js";import{n as e}from"./FieldType.js";import{l as t}from"./ScalarTypeEnum.js";import{n,t as r}from"./SchemaModel.js";import"./entity/defineEntity.js";import"./entity/index.js";

package/dist/schema-to-markdown.d.ts

@@ -1,54 +0,0 @@
-import { AnySchemaModel } from "@lssm/lib.schema";
-
-//#region src/schema-to-markdown.d.ts
-
-/**
- * Options for schema-to-markdown generation
- */
-interface SchemaMarkdownOptions {
-  /** Title for the markdown section */
-  title?: string;
-  /** Description to include below the title */
-  description?: string;
-  /** Output format: table for lists, list for simple items, detail for single objects */
-  format?: 'table' | 'list' | 'detail' | 'auto';
-  /** Maximum number of items to render (for arrays) */
-  maxItems?: number;
-  /** Only include these fields (if not specified, all fields are included) */
-  includeFields?: string[];
-  /** Exclude these fields from output */
-  excludeFields?: string[];
-  /** Custom field labels (field name -> display label) */
-  fieldLabels?: Record<string, string>;
-  /** Fields to use for summary in list format */
-  summaryFields?: string[];
-  /** Nesting depth for nested schemas (default: 2) */
-  maxDepth?: number;
-}
-/**
- * Generate markdown from a SchemaModel and data.
- * Automatically detects array vs object data and formats accordingly.
- */
-declare function schemaToMarkdown(schema: AnySchemaModel, data: unknown, options?: SchemaMarkdownOptions): string;
-/**
- * Generate a markdown table from array data using schema fields as columns.
- */
-declare function schemaToMarkdownTable(schema: AnySchemaModel, items: unknown[], options?: SchemaMarkdownOptions): string;
-/**
- * Generate a markdown list from array data.
- * Uses summaryFields to create concise list items.
- */
-declare function schemaToMarkdownList(schema: AnySchemaModel, items: unknown[], options?: SchemaMarkdownOptions): string;
-/**
- * Generate a markdown detail view (key-value pairs) from object data.
- */
-declare function schemaToMarkdownDetail(schema: AnySchemaModel, item: unknown, options?: SchemaMarkdownOptions): string;
-/**
- * Generate markdown summary statistics for numeric fields in array data.
- */
-declare function schemaToMarkdownSummary(schema: AnySchemaModel, items: unknown[], options?: {
-  numericFields?: string[];
-  countByField?: string;
-}): string;
-//#endregion
-export { SchemaMarkdownOptions, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable };

package/dist/server/graphql-pothos.d.ts

@@ -1,31 +0,0 @@
-import { ResourceRegistry } from "../resources.js";
-import { SpecRegistry } from "../registry.js";
-import "@pothos/plugin-prisma";
-import "@pothos/plugin-complexity";
-import "@pothos/plugin-relay";
-import "@pothos/plugin-dataloader";
-import "@pothos/plugin-tracing";
-import { SchemaTypes } from "@pothos/core";
-
-//#region src/server/graphql-pothos.d.ts
-
-/**
- * Registers all ContractSpecs from a SpecRegistry onto a Pothos SchemaBuilder.
- *
- * This adapter:
- * 1. Discovers output types from specs and registers them as Pothos object types.
- * 2. Maps `ContractSpec` inputs to Pothos input types.
- * 3. Mounts `query` specs as `Query` fields and `command` specs as `Mutation` fields.
- * 4. Wraps the resolver to:
- *    - Enforce auth policies (basic check).
- *    - Build a `HandlerCtx`.
- *    - Execute via `SpecRegistry`.
- *    - Hydrate resource references if applicable.
- *
- * @param builder - The Pothos SchemaBuilder instance.
- * @param reg - The SpecRegistry containing operations.
- * @param resources - (Optional) ResourceRegistry for hydrating resource references.
- */
-declare function registerContractsOnBuilder<T extends SchemaTypes>(builder: PothosSchemaTypes.SchemaBuilder<T>, reg: SpecRegistry, resources?: ResourceRegistry): void;
-//#endregion
-export { registerContractsOnBuilder };

package/dist/server/graphql-schema-export.d.ts

@@ -1,6 +0,0 @@
-import { GraphQLSchema } from "graphql";
-
-//#region src/server/graphql-schema-export.d.ts
-declare const exportContractsToGraphQLSchema: (schema: GraphQLSchema, outputPathDir: string) => Promise<void>;
-//#endregion
-export { exportContractsToGraphQLSchema };

package/dist/server/index.d.ts

@@ -1,9 +0,0 @@
-import { registerContractsOnBuilder } from "./graphql-pothos.js";
-import { exportContractsToGraphQLSchema } from "./graphql-schema-export.js";
-import { createMcpServer } from "./provider-mcp.js";
-import { RestOptions, createFetchHandler } from "./rest-generic.js";
-import { elysiaPlugin } from "./rest-elysia.js";
-import { expressRouter } from "./rest-express.js";
-import { makeNextAppHandler } from "./rest-next-app.js";
-import { makeNextPagesHandler } from "./rest-next-pages.js";
-export { RestOptions, createFetchHandler, createMcpServer, elysiaPlugin, exportContractsToGraphQLSchema, expressRouter, makeNextAppHandler, makeNextPagesHandler, registerContractsOnBuilder };

package/dist/server/provider-mcp.d.ts

@@ -1,51 +0,0 @@
-import { ResourceRegistry } from "../resources.js";
-import { PresentationRegistry } from "../presentations.js";
-import { PresentationDescriptorV2 } from "../presentations.v2.js";
-import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
-import { PromptRegistry } from "../promptRegistry.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-
-//#region src/server/provider-mcp.d.ts
-
-/**
- * Creates a unified Model Context Protocol (MCP) server exposing operations, resources, and prompts.
- *
- * This function takes registries for operations, resources, and prompts, and exposes them as
- * MCP Tools, Resources, and Prompts respectively. It enables AI agents to discover and interact
- * with the application's capabilities.
- *
- * Features:
- * - **Tools**: Exposes `command` operations as executable tools.
- * - **Resources**: Exposes `ResourceRegistry` entries and `PresentationSpec`s (Markdown/JSON) as read-only resources.
- * - **Prompts**: Exposes `PromptRegistry` entries as templated prompts.
- *
- * @param server - The `McpServer` instance to populate.
- * @param ops - Registry containing operations (tools).
- * @param resources - Registry containing data resources.
- * @param prompts - Registry containing prompt templates.
- * @param ctxFactories - Factories to create context for tools, resources, and prompts execution.
- * @returns The populated `McpServer` instance.
- */
-declare function createMcpServer(server: McpServer, ops: SpecRegistry, resources: ResourceRegistry, prompts: PromptRegistry, ctxFactories: {
-  /** Factory for tool execution context (e.g., system actor) */
-  toolCtx: () => HandlerCtx;
-  /** Factory for prompt rendering context */
-  promptCtx: () => {
-    userId?: string | null;
-    orgId?: string | null;
-    locale?: string;
-  };
-  /** Factory for resource resolution context */
-  resourceCtx: () => {
-    userId?: string | null;
-    orgId?: string | null;
-    locale?: string;
-  };
-  /** Optional registry for V1 presentations */
-  presentations?: PresentationRegistry;
-  /** Optional list of V2 presentation descriptors */
-  presentationsV2?: PresentationDescriptorV2[];
-}): McpServer;
-//#endregion
-export { createMcpServer };

package/dist/server/rest-elysia.d.ts

@@ -1,40 +0,0 @@
-import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
-import { RestOptions } from "./rest-generic.js";
-import { Elysia } from "elysia";
-
-//#region src/server/rest-elysia.d.ts
-/** Mount routes on an Elysia instance */
-declare function elysiaPlugin(app: Elysia, reg: SpecRegistry, ctxFactory: (c: {
-  request: Request;
-  store: any;
-}) => HandlerCtx, options?: RestOptions): Elysia<"", {
-  decorator: {};
-  store: {};
-  derive: {};
-  resolve: {};
-}, {
-  typebox: {};
-  error: {};
-}, {
-  schema: {};
-  standaloneSchema: {};
-  macro: {};
-  macroFn: {};
-  parser: {};
-  response: {};
-}, {}, {
-  derive: {};
-  resolve: {};
-  schema: {};
-  standaloneSchema: {};
-  response: {};
-}, {
-  derive: {};
-  resolve: {};
-  schema: {};
-  standaloneSchema: {};
-  response: {};
-}>;
-//#endregion
-export { elysiaPlugin };

package/dist/server/rest-express.d.ts

@@ -1,16 +0,0 @@
-import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
-import { RestOptions } from "./rest-generic.js";
-import { Request, Router } from "express";
-
-//#region src/server/rest-express.d.ts
-
-/**
- * Build an Express Router that proxies to the Fetch-style handler.
- * You can mount it at any base path; pass the same basePath in options.
- */
-declare function expressRouter(express: {
-  Router: () => Router;
-}, reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): Router;
-//#endregion
-export { expressRouter };

package/dist/server/rest-generic.d.ts

@@ -1,32 +0,0 @@
-import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
-
-//#region src/server/rest-generic.d.ts
-interface RestOptions {
-  /** Prefix all routes, e.g. "/api" */
-  basePath?: string;
-  /** If true, handle OPTIONS and set CORS headers */
-  cors?: boolean | {
-    origin?: string | '*';
-    methods?: string[];
-    headers?: string[];
-    credentials?: boolean;
-    maxAge?: number;
-  };
-  /** JSON spacing in responses (dev only ideally) */
-  prettyJson?: number | false;
-  /** Map thrown errors to {status, body} */
-  onError?: (err: unknown) => {
-    status: number;
-    body: any;
-  };
-}
-/**
- * Build a single Fetch-style handler: (req) => Response
- * - Discovers routes from SpecRegistry
- * - Validates with zod via registry.execute()
- * - Handles CORS (optional)
- */
-declare function createFetchHandler(reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
-//#endregion
-export { RestOptions, createFetchHandler };

package/dist/server/rest-next-app.d.ts

@@ -1,35 +0,0 @@
-import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
-import { RestOptions } from "./rest-generic.js";
-
-//#region src/server/rest-next-app.d.ts
-
-/**
- * Creates a Next.js App Router route handler for ContractSpec operations.
- *
- * This function returns a handler suitable for `export const { GET, POST }` in a `route.ts` file.
- * It handles:
- * - Path parsing to determine the operation name and version.
- * - Body parsing (JSON).
- * - Context creation via `ctxFactory`.
- * - Execution via `SpecRegistry`.
- * - Response formatting (JSON success/error).
- *
- * @param reg - The SpecRegistry containing the operations.
- * @param ctxFactory - A factory function to build the `HandlerCtx` (e.g., auth, tenant) from the request.
- * @param options - Optional configuration for the REST handler.
- * @returns A function `(req: Request) => Promise<Response>`.
- *
- * @example
- * ```ts
- * // app/api/[...route]/route.ts
- * import { makeNextAppHandler } from '@lssm/lib.contracts/server/rest-next-app';
- * import { registry } from '@/lib/registry';
- *
- * const handler = makeNextAppHandler(registry, (req) => ({ actor: 'anonymous' }));
- * export { handler as GET, handler as POST };
- * ```
- */
-declare function makeNextAppHandler(reg: SpecRegistry, ctxFactory: (req: Request) => HandlerCtx, options?: RestOptions): (req: Request) => Promise<Response>;
-//#endregion
-export { makeNextAppHandler };

package/dist/server/rest-next-mcp.d.ts

@@ -1,11 +0,0 @@
-import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
-
-//#region src/server/rest-next-mcp.d.ts
-declare function makeNextMcpServerFromRegistry(reg: SpecRegistry, ctxFactory: () => HandlerCtx): {
-  GET: (request: Request) => Promise<Response>;
-  POST: (request: Request) => Promise<Response>;
-  DELETE: (request: Request) => Promise<Response>;
-};
-//#endregion
-export { makeNextMcpServerFromRegistry };

package/dist/server/rest-next-pages.d.ts

@@ -1,9 +0,0 @@
-import { HandlerCtx } from "../types.js";
-import { SpecRegistry } from "../registry.js";
-import { RestOptions } from "./rest-generic.js";
-import { NextApiRequest, NextApiResponse } from "next";
-
-//#region src/server/rest-next-pages.d.ts
-declare function makeNextPagesHandler(reg: SpecRegistry, ctxFactory: (req: NextApiRequest) => HandlerCtx, options?: RestOptions): (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
-//#endregion
-export { makeNextPagesHandler };

package/dist/spec.d.ts

@@ -1,171 +0,0 @@
-import { Owner, Stability, Tag } from "./ownership.js";
-import { EventSpec } from "./events.js";
-import { ResourceRefDescriptor } from "./resources.js";
-import { PolicyRef } from "./policy/spec.js";
-import { TestSpecRef } from "./tests/spec.js";
-import { AnySchemaModel } from "@lssm/lib.schema";
-
-//#region src/spec.d.ts
-
-/**
- * Distinguishes between state-changing operations (command) and read-only operations (query).
- */
-type OpKind = 'command' | 'query';
-interface EmitDeclRef {
-  ref: EventSpec<AnySchemaModel>;
-  when: string;
-}
-interface EmitDeclInline {
-  name: string;
-  version: number;
-  when: string;
-  payload: AnySchemaModel;
-}
-/**
- * Declaration of an event that an operation may emit.
- * Can be a reference to an `EventSpec` or an inline definition.
- */
-type EmitDecl = EmitDeclRef | EmitDeclInline;
-declare const isEmitDeclRef: (e: EmitDecl) => e is EmitDeclRef;
-interface TelemetryTrigger {
-  event: {
-    name: string;
-    version?: number;
-  };
-  properties?: (args: {
-    input: unknown;
-    output?: unknown;
-    error?: unknown;
-  }) => Record<string, unknown>;
-}
-/**
- * The core specification interface for any operation (Command or Query).
- *
- * @template Input - The Zod-backed schema model for the input payload.
- * @template Output - The Zod-backed schema model for the output payload, or a resource reference.
- * @template Events - Tuple of events that this operation may emit.
- */
-interface ContractSpec<Input extends AnySchemaModel, Output extends AnySchemaModel | ResourceRefDescriptor<boolean>, Events extends readonly EmitDecl[] | undefined = readonly EmitDecl[] | undefined> {
-  meta: {
-    /** Fully-qualified op name (e.g., "sigil.beginSignup") */
-    name: string;
-    /** Breaking changes => bump version */
-    version: number;
-    /** "command" changes state; "query" is read-only/idempotent */
-    kind: OpKind;
-    /** Lifecycle marker for comms & tooling */
-    stability: Stability;
-    /** Owners for CODEOWNERS / on-call / approvals */
-    owners: Owner[];
-    /** Search tags, grouping, docs navigation */
-    tags: Tag[];
-    /** Short human-friendly summary */
-    description: string;
-    /** Business goal: why this exists */
-    goal: string;
-    /** Background, constraints, scope edges (feeds docs & LLM context) */
-    context: string;
-  };
-  io: {
-    /** Zod schema for input payload */
-    input: Input | null;
-    /** Zod schema for output payload */
-    output: Output;
-    /** Named, typed errors this op may throw (optional) */
-    errors?: Record<string, {
-      description: string;
-      http?: number;
-      gqlCode?: string;
-      when: string;
-    }>;
-  };
-  policy: {
-    /** Minimal auth category allowed to call this op */
-    auth: 'anonymous' | 'user' | 'admin';
-    /** Idempotency hint. Queries default true; commands default false. */
-    idempotent?: boolean;
-    /** Soft rate limit suggestion; adapter enforces via limiter */
-    rateLimit?: {
-      rpm: number;
-      key: 'user' | 'org' | 'global';
-    };
-    /** Feature flags that must be ON for this op to run */
-    flags?: string[];
-    /** Whether a human must approve before action (e.g., risky commands) */
-    escalate?: 'human_review' | null;
-    /** JSONPath-like pointers to redact from logs/prompts */
-    pii?: string[];
-    /** Referenced policy specs governing access */
-    policies?: PolicyRef[];
-    /** Field-level overrides referencing policy specs */
-    fieldPolicies?: {
-      field: string;
-      actions: ('read' | 'write')[];
-      policy?: PolicyRef;
-    }[];
-  };
-  sideEffects?: {
-    /** Declared events this op may emit; runtime will guard against others */
-    emits?: Events;
-    /** Analytics intents (names); the service decides the sink */
-    analytics?: string[];
-    /** Audit intents (labels); the service decides storage */
-    audit?: string[];
-  };
-  telemetry?: {
-    success?: TelemetryTrigger;
-    failure?: TelemetryTrigger;
-  };
-  tests?: TestSpecRef[];
-  transport?: {
-    rest?: {
-      /** Override HTTP method (default: POST for commands, GET for queries) */
-      method?: 'GET' | 'POST';
-      /** Override path (default derived from meta.name/version) */
-      path?: string;
-    };
-    gql?: {
-      /** Override field name (default: dots→underscores + _vN) */
-      field?: string;
-      returns?: string;
-    };
-    mcp?: {
-      /** Override tool identifier (default: "<name>.v<version>") */
-      toolName?: string;
-    };
-  };
-  acceptance?: {
-    /** Gherkin-lite scenarios for docs & auto tests */
-    scenarios?: {
-      name: string;
-      given: string[];
-      when: string[];
-      then: string[];
-    }[];
-    /** Request/response examples (used for docs & snapshot tests) */
-    examples?: {
-      name: string;
-      input: unknown;
-      output: unknown;
-    }[];
-  };
-}
-type AnyContractSpec = ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
-/**
- * Helper to define a Command (write operation).
- * Sets `kind: 'command'` and defaults `idempotent: false`.
- */
-declare const defineCommand: <I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>, E extends readonly EmitDecl[] | undefined = undefined>(spec: Omit<ContractSpec<I, O, E>, "meta" | "policy"> & {
-  meta: Omit<ContractSpec<I, O, E>["meta"], "kind">;
-  policy: Omit<ContractSpec<I, O, E>["policy"], "idempotent">;
-}) => ContractSpec<I, O, E>;
-/**
- * Helper to define a Query (read-only operation).
- * Sets `kind: 'query'` and forces `idempotent: true`.
- */
-declare const defineQuery: <I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>, E extends readonly EmitDecl[] | undefined = undefined>(spec: Omit<ContractSpec<I, O, E>, "meta" | "policy"> & {
-  meta: Omit<ContractSpec<I, O, E>["meta"], "kind">;
-  policy: Omit<ContractSpec<I, O, E>["policy"], "idempotent">;
-}) => ContractSpec<I, O, E>;
-//#endregion
-export { AnyContractSpec, ContractSpec, EmitDecl, EmitDeclInline, EmitDeclRef, OpKind, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef };

package/dist/telemetry/anomaly.d.ts

@@ -1,27 +0,0 @@
-import { TelemetryAnomalyDetectionConfig } from "./spec.js";
-import { TelemetryDispatch } from "./tracker.js";
-
-//#region src/telemetry/anomaly.d.ts
-interface TelemetryAnomalyEvent {
-  dispatch: TelemetryDispatch;
-  threshold: TelemetryAnomalyDetectionConfig;
-  metric: string;
-  value: number | undefined;
-  type: 'min' | 'max';
-}
-interface TelemetryAnomalyMonitorOptions {
-  onAnomaly?: (event: TelemetryAnomalyEvent) => void;
-  now?: () => Date;
-}
-declare class TelemetryAnomalyMonitor {
-  private readonly onAnomaly?;
-  private readonly now;
-  private readonly samples;
-  constructor(options?: TelemetryAnomalyMonitorOptions);
-  observe(dispatch: TelemetryDispatch): void;
-  private extractMetric;
-  private emit;
-  reset(): void;
-}
-//#endregion
-export { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions };

package/dist/telemetry/index.d.ts

@@ -1,4 +0,0 @@
-import { TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, makeTelemetryKey } from "./spec.js";
-import { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions } from "./anomaly.js";
-import { RuntimeTelemetryProvider, TelemetryDispatch, TelemetryEventContext, TelemetryTracker, TelemetryTrackerOptions } from "./tracker.js";
-export { RuntimeTelemetryProvider, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, makeTelemetryKey };