@lssm/lib.contracts 0.0.0-canary-20251120170226

package/dist/regenerator/sinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks.js","names":["executor: ProposalExecutor","options: ExecutorSinkOptions"],"sources":["../../src/regenerator/sinks.ts"],"sourcesContent":["import type { ProposalSink, RegenerationContext, SpecChangeProposal } from './types';\nimport { ProposalExecutor } from './executor';\nimport type { ProposalExecutionResult } from './executor';\n\nexport interface ExecutorResultPayload {\n  context: RegenerationContext;\n  proposal: SpecChangeProposal;\n  result: ProposalExecutionResult;\n}\n\nexport interface ExecutorSinkLogger {\n  info?: (message: string, meta?: Record<string, unknown>) => void;\n  error?: (message: string, error: Error, meta?: Record<string, unknown>) => void;\n}\n\nexport interface ExecutorSinkOptions {\n  dryRun?: boolean;\n  onResult?: (payload: ExecutorResultPayload) => void | Promise<void>;\n  logger?: ExecutorSinkLogger;\n}\n\nexport class ExecutorProposalSink implements ProposalSink {\n  constructor(\n    private readonly executor: ProposalExecutor,\n    private readonly options: ExecutorSinkOptions = {}\n  ) {}\n\n  async submit(\n    context: RegenerationContext,\n    proposal: SpecChangeProposal\n  ): Promise<void> {\n    const dryRun = this.options.dryRun ?? false;\n    try {\n      const result = await this.executor.execute(context, proposal, { dryRun });\n      if (this.options.logger?.info) {\n        this.options.logger.info('[regenerator] proposal executed', {\n          proposalId: proposal.id,\n          contextId: context.id,\n          status: result.status,\n        });\n      }\n      if (this.options.onResult) {\n        await this.options.onResult({ context, proposal, result });\n      }\n    } catch (error) {\n      if (this.options.logger?.error) {\n        this.options.logger.error(\n          '[regenerator] proposal execution failed',\n          error instanceof Error ? error : new Error(String(error)),\n          { proposalId: proposal.id, contextId: context.id }\n        );\n      }\n      throw error instanceof Error ? error : new Error(String(error));\n    }\n  }\n}\n\n\n\n\n\n\n\n"],"mappings":"AAqBA,IAAa,EAAb,KAA0D,CACxD,YACE,EACA,EAAgD,EAAE,CAClD,CAFiB,KAAA,SAAA,EACA,KAAA,QAAA,EAGnB,MAAM,OACJ,EACA,EACe,CACf,IAAM,EAAS,KAAK,QAAQ,QAAU,GACtC,GAAI,CACF,IAAM,EAAS,MAAM,KAAK,SAAS,QAAQ,EAAS,EAAU,CAAE,SAAQ,CAAC,CACrE,KAAK,QAAQ,QAAQ,MACvB,KAAK,QAAQ,OAAO,KAAK,kCAAmC,CAC1D,WAAY,EAAS,GACrB,UAAW,EAAQ,GACnB,OAAQ,EAAO,OAChB,CAAC,CAEA,KAAK,QAAQ,UACf,MAAM,KAAK,QAAQ,SAAS,CAAE,UAAS,WAAU,SAAQ,CAAC,OAErD,EAAO,CAQd,MAPI,KAAK,QAAQ,QAAQ,OACvB,KAAK,QAAQ,OAAO,MAClB,0CACA,aAAiB,MAAQ,EAAY,MAAM,OAAO,EAAM,CAAC,CACzD,CAAE,WAAY,EAAS,GAAI,UAAW,EAAQ,GAAI,CACnD,CAEG,aAAiB,MAAQ,EAAY,MAAM,OAAO,EAAM,CAAC"}

package/dist/regenerator/types.d.ts

@@ -0,0 +1,108 @@
+import { TelemetrySpec } from "../telemetry/spec.js";
+import { AppBlueprintSpec, TenantAppConfig } from "../app-config/spec.js";
+import { ResolvedAppConfig } from "../app-config/runtime.js";
+
+//#region src/regenerator/types.d.ts
+type RegeneratorSignal = TelemetrySignalEnvelope | ErrorSignalEnvelope | BehaviorSignalEnvelope;
+interface TelemetrySignalEnvelope {
+  type: 'telemetry';
+  contextId: string;
+  signal: TelemetrySignal;
+}
+interface TelemetrySignal {
+  eventName: string;
+  eventVersion: number;
+  count: number;
+  windowStart: Date;
+  windowEnd: Date;
+  anomalyScore?: number;
+  classification?: 'normal' | 'warning' | 'critical';
+  metadata?: Record<string, unknown>;
+  telemetrySpec?: TelemetrySpec;
+}
+interface ErrorSignalEnvelope {
+  type: 'error';
+  contextId: string;
+  signal: ErrorSignal;
+}
+interface ErrorSignal {
+  id: string;
+  classification: 'runtime' | 'policy' | 'workflow' | 'unknown';
+  message: string;
+  occurredAt: Date;
+  count: number;
+  metadata?: Record<string, unknown>;
+}
+interface BehaviorSignalEnvelope {
+  type: 'behavior';
+  contextId: string;
+  signal: BehaviorSignal;
+}
+interface BehaviorSignal {
+  feature: string;
+  metric: 'usage' | 'conversion' | 'latency' | 'custom';
+  value: number;
+  baseline?: number;
+  windowStart: Date;
+  windowEnd: Date;
+  metadata?: Record<string, unknown>;
+}
+interface SpecChangeProposal {
+  id: string;
+  title: string;
+  summary: string;
+  confidence: ProposalConfidence;
+  rationale: string[];
+  target: ProposalTarget;
+  diff?: string;
+  actions: ProposalAction[];
+  blockers?: ProposalBlocker[];
+  createdAt: Date;
+  signalIds: string[];
+}
+type ProposalConfidence = 'low' | 'medium' | 'high';
+interface ProposalTarget {
+  specType: 'workflow' | 'capability' | 'policy' | 'dataView' | 'telemetry' | 'experiment' | 'theme' | 'unknown';
+  reference: {
+    name: string;
+    version?: number;
+  };
+  tenantScoped?: boolean;
+}
+type ProposalAction = {
+  kind: 'update_blueprint';
+  summary: string;
+} | {
+  kind: 'update_tenant_config';
+  summary: string;
+} | {
+  kind: 'run_tests';
+  tests: string[];
+} | {
+  kind: 'run_migrations';
+  migrations: string[];
+} | {
+  kind: 'trigger_regeneration';
+  summary?: string;
+};
+interface ProposalBlocker {
+  description: string;
+  kind: 'missing_context' | 'insufficient_data' | 'user_feedback' | 'manual_review';
+}
+interface RegenerationContext {
+  id: string;
+  blueprint: AppBlueprintSpec;
+  tenantConfig: TenantAppConfig;
+  resolved: ResolvedAppConfig;
+}
+interface RegenerationRule {
+  readonly id: string;
+  readonly description: string;
+  evaluate(context: RegenerationContext, signals: RegeneratorSignal[]): Promise<SpecChangeProposal[]>;
+}
+interface ProposalSink {
+  submit(context: RegenerationContext, proposal: SpecChangeProposal): Promise<void>;
+}
+//#endregion
+export { BehaviorSignal, BehaviorSignalEnvelope, ErrorSignal, ErrorSignalEnvelope, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalSink, ProposalTarget, RegenerationContext, RegenerationRule, RegeneratorSignal, SpecChangeProposal, TelemetrySignal, TelemetrySignalEnvelope };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/regenerator/types.ts"],"sourcesContent":[],"mappings":";;;;;KAOY,iBAAA,GACR,0BACA,sBACA;UAEa,uBAAA;EALL,IAAA,EAAA,WAAA;EACR,SAAA,EAAA,MAAA;EACA,MAAA,EAMM,eANN;;AACsB,UAQT,eAAA,CARS;EAET,SAAA,EAAA,MAAA;EAMA,YAAA,EAAA,MAAe;EAIjB,KAAA,EAAA,MAAA;EACF,WAAA,EADE,IACF;EAGA,SAAA,EAHA,IAGA;EACK,YAAA,CAAA,EAAA,MAAA;EAAa,cAAA,CAAA,EAAA,QAAA,GAAA,SAAA,GAAA,UAAA;EAGd,QAAA,CAAA,EAJJ,MAII,CAAA,MAAmB,EAAA,OAAA,CAAA;EAMnB,aAAA,CAAW,EATV,aAaJ;AAKd;AAMiB,UArBA,mBAAA,CAqBc;EAKhB,IAAA,EAAA,OAAA;EACF,SAAA,EAAA,MAAA;EACA,MAAA,EAzBH,WAyBG;;AAGI,UAzBA,WAAA,CAyBkB;EAIrB,EAAA,EAAA,MAAA;EAEJ,cAAA,EAAA,SAAA,GAAA,QAAA,GAAA,UAAA,GAAA,SAAA;EAEC,OAAA,EAAA,MAAA;EACE,UAAA,EA9BC,IA8BD;EACA,KAAA,EAAA,MAAA;EAAI,QAAA,CAAA,EA7BJ,MA6BI,CAAA,MAAA,EAAA,OAAA,CAAA;AAIjB;AAEiB,UAhCA,sBAAA,CAgCc;EAiBnB,IAAA,EAAA,UAAA;EAsBK,SAAA,EAAA,MAAA;EAKA,MAAA,EAzEP,cAyE0B;;AAGpB,UAzEC,cAAA,CAyED;EACJ,OAAA,EAAA,MAAA;EAAiB,MAAA,EAAA,OAAA,GAAA,YAAA,GAAA,SAAA,GAAA,QAAA;EAGZ,KAAA,EAAA,MAAA;EAIJ,QAAA,CAAA,EAAA,MAAA;EACA,WAAA,EA7EE,IA6EF;EACA,SAAA,EA7EA,IA6EA;EAAR,QAAA,CAAA,EA5EQ,MA4ER,CAAA,MAAA,EAAA,OAAA,CAAA;;AAGY,UA5EA,kBAAA,CA4EY;EAEhB,EAAA,EAAA,MAAA;EACC,KAAA,EAAA,MAAA;EACT,OAAA,EAAA,MAAA;EAAO,UAAA,EA5EE,kBA4EF;;UA1EF;;WAEC;aACE;aACA;;;KAID,kBAAA;UAEK,cAAA;;;;;;;;KAiBL,cAAA;;;;;;;;;;;;;;;;UAsBK,eAAA;;;;UAKA,mBAAA;;aAEJ;gBACG;YACJ;;UAGK,gBAAA;;;oBAIJ,8BACA,sBACR,QAAQ;;UAGI,YAAA;kBAEJ,+BACC,qBACT"}

package/dist/regenerator/utils.d.ts

@@ -0,0 +1,10 @@
+import { BehaviorSignal, BehaviorSignalEnvelope, ErrorSignal, ErrorSignalEnvelope, TelemetrySignal, TelemetrySignalEnvelope } from "./types.js";
+
+//#region src/regenerator/utils.d.ts
+type Clock = () => Date;
+declare function telemetryToEnvelope(contextId: string, signal: TelemetrySignal, clock: Clock): TelemetrySignalEnvelope;
+declare function errorToEnvelope(contextId: string, signal: ErrorSignal, clock: Clock): ErrorSignalEnvelope;
+declare function behaviorToEnvelope(contextId: string, signal: BehaviorSignal, clock: Clock): BehaviorSignalEnvelope;
+//#endregion
+export { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope };
+//# sourceMappingURL=utils.d.ts.map

package/dist/regenerator/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/regenerator/utils.ts"],"sourcesContent":[],"mappings":";;;KASK,KAAA,SAAc;iBAEH,mBAAA,4BAEN,wBACD,QACN;AANE,iBAcW,eAAA,CAdO,SAAA,EAAA,MAAA,EAAA,MAAA,EAgBb,WAhBa,EAAA,KAAA,EAiBd,KAjBc,CAAA,EAkBpB,mBAlBoB;AAEP,iBAwBA,kBAAA,CAxBmB,SAAA,EAAA,MAAA,EAAA,MAAA,EA0BzB,cA1ByB,EAAA,KAAA,EA2B1B,KA3B0B,CAAA,EA4BhC,sBA5BgC"}

package/dist/regenerator/utils.js

@@ -0,0 +1,2 @@
+function e(e,t,n){return{type:`telemetry`,contextId:e,signal:r(t,n)}}function t(e,t,n){return{type:`error`,contextId:e,signal:i(t,n)}}function n(e,t,n){return{type:`behavior`,contextId:e,signal:a(t,n)}}function r(e,t){return{...e,windowStart:o(e.windowStart,t),windowEnd:o(e.windowEnd,t)}}function i(e,t){return{...e,occurredAt:o(e.occurredAt,t)}}function a(e,t){return{...e,windowStart:o(e.windowStart,t),windowEnd:o(e.windowEnd,t)}}function o(e,t){if(e instanceof Date)return e;let n=new Date(e);return Number.isNaN(n.getTime())?t():n}export{n as behaviorToEnvelope,t as errorToEnvelope,e as telemetryToEnvelope};
+//# sourceMappingURL=utils.js.map

package/dist/regenerator/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/regenerator/utils.ts"],"sourcesContent":["import type {\n  BehaviorSignal,\n  BehaviorSignalEnvelope,\n  ErrorSignal,\n  ErrorSignalEnvelope,\n  TelemetrySignal,\n  TelemetrySignalEnvelope,\n} from './types';\n\ntype Clock = () => Date;\n\nexport function telemetryToEnvelope(\n  contextId: string,\n  signal: TelemetrySignal,\n  clock: Clock\n): TelemetrySignalEnvelope {\n  return {\n    type: 'telemetry',\n    contextId,\n    signal: normalizeTelemetryDates(signal, clock),\n  };\n}\n\nexport function errorToEnvelope(\n  contextId: string,\n  signal: ErrorSignal,\n  clock: Clock\n): ErrorSignalEnvelope {\n  return {\n    type: 'error',\n    contextId,\n    signal: normalizeErrorDates(signal, clock),\n  };\n}\n\nexport function behaviorToEnvelope(\n  contextId: string,\n  signal: BehaviorSignal,\n  clock: Clock\n): BehaviorSignalEnvelope {\n  return {\n    type: 'behavior',\n    contextId,\n    signal: normalizeBehaviorDates(signal, clock),\n  };\n}\n\nfunction normalizeTelemetryDates(\n  signal: TelemetrySignal,\n  clock: Clock\n): TelemetrySignal {\n  return {\n    ...signal,\n    windowStart: toDate(signal.windowStart, clock),\n    windowEnd: toDate(signal.windowEnd, clock),\n  };\n}\n\nfunction normalizeErrorDates(\n  signal: ErrorSignal,\n  clock: Clock\n): ErrorSignal {\n  return {\n    ...signal,\n    occurredAt: toDate(signal.occurredAt, clock),\n  };\n}\n\nfunction normalizeBehaviorDates(\n  signal: BehaviorSignal,\n  clock: Clock\n): BehaviorSignal {\n  return {\n    ...signal,\n    windowStart: toDate(signal.windowStart, clock),\n    windowEnd: toDate(signal.windowEnd, clock),\n  };\n}\n\nfunction toDate(value: Date | string, clock: Clock): Date {\n  if (value instanceof Date) return value;\n  const parsed = new Date(value);\n  if (Number.isNaN(parsed.getTime())) {\n    return clock();\n  }\n  return parsed;\n}\n\n\n\n\n\n\n\n"],"mappings":"AAWA,SAAgB,EACd,EACA,EACA,EACyB,CACzB,MAAO,CACL,KAAM,YACN,YACA,OAAQ,EAAwB,EAAQ,EAAM,CAC/C,CAGH,SAAgB,EACd,EACA,EACA,EACqB,CACrB,MAAO,CACL,KAAM,QACN,YACA,OAAQ,EAAoB,EAAQ,EAAM,CAC3C,CAGH,SAAgB,EACd,EACA,EACA,EACwB,CACxB,MAAO,CACL,KAAM,WACN,YACA,OAAQ,EAAuB,EAAQ,EAAM,CAC9C,CAGH,SAAS,EACP,EACA,EACiB,CACjB,MAAO,CACL,GAAG,EACH,YAAa,EAAO,EAAO,YAAa,EAAM,CAC9C,UAAW,EAAO,EAAO,UAAW,EAAM,CAC3C,CAGH,SAAS,EACP,EACA,EACa,CACb,MAAO,CACL,GAAG,EACH,WAAY,EAAO,EAAO,WAAY,EAAM,CAC7C,CAGH,SAAS,EACP,EACA,EACgB,CAChB,MAAO,CACL,GAAG,EACH,YAAa,EAAO,EAAO,YAAa,EAAM,CAC9C,UAAW,EAAO,EAAO,UAAW,EAAM,CAC3C,CAGH,SAAS,EAAO,EAAsB,EAAoB,CACxD,GAAI,aAAiB,KAAM,OAAO,EAClC,IAAM,EAAS,IAAI,KAAK,EAAM,CAI9B,OAHI,OAAO,MAAM,EAAO,SAAS,CAAC,CACzB,GAAO,CAET"}

package/dist/registry.d.ts

@@ -0,0 +1,73 @@
+import { ResourceRefDescriptor } from "./resources.js";
+import { ContractSpec } from "./spec.js";
+import { HandlerCtx } from "./types.js";
+import { HandlerFor } from "./install.js";
+import { AnySchemaModel } from "@lssm/lib.schema";
+
+//#region src/registry.d.ts
+
+type OperationKey = `${string}.v${number}`;
+declare function opKey(name: string, version: number): OperationKey;
+type AnySpec = ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
+type AnyHandler = (args: any, ctx: HandlerCtx) => Promise<unknown>;
+/**
+ * In-memory registry for ContractSpecs and their bound handlers.
+ * Provides validation, policy enforcement, and guarded event emission at execute time.
+ */
+declare class SpecRegistry {
+  private specs;
+  private handlers;
+  /**
+   * Registers a ContractSpec definition.
+   *
+   * @param spec - The contract specification to register.
+   * @returns The registry instance for chaining.
+   * @throws If a spec with the same name and version is already registered.
+   */
+  register<I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>>(spec: ContractSpec<I, O>): this;
+  /**
+   * Binds a runtime handler implementation to a previously registered spec.
+   *
+   * @param spec - The spec to bind to.
+   * @param handler - The async function implementing the business logic.
+   * @returns The registry instance for chaining.
+   * @throws If the spec is not found or a handler is already bound.
+   */
+  bind<I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>>(spec: ContractSpec<I, O>, handler: HandlerFor<ContractSpec<I, O>>): this;
+  /**
+   * Retrieves a registered spec by name and version.
+   * If version is omitted, returns the highest version found.
+   *
+   * @param name - Operation name.
+   * @param version - (Optional) Specific version.
+   */
+  getSpec(name: string, version?: number): AnySpec | undefined;
+  /**
+   * Retrieves the bound handler for a spec.
+   */
+  getHandler(name: string, version?: number): AnyHandler | undefined;
+  /** Iterate all registered specs. */
+  listSpecs(): AnySpec[];
+  /** Iterate all bound operations (spec+handler). */
+  listBound(): {
+    spec: AnySpec;
+    handler: AnyHandler;
+  }[];
+  /**
+   * Execute an operation by name/version with full runtime protections:
+   * 1. Validates input against Zod schema.
+   * 2. Enforces policy (Auth, RBAC, Rate Limits) via PDP.
+   * 3. Guards event emission to ensure only declared events are sent.
+   * 4. Validates output against Zod schema (if applicable).
+   * 5. Tracks telemetry (success/failure).
+   *
+   * @param name - Operation name.
+   * @param version - Operation version (optional, defaults to latest).
+   * @param rawInput - The raw input payload (e.g. from JSON body).
+   * @param ctx - The runtime context (actor, tenant, etc.).
+   */
+  execute(name: string, version: number | undefined, rawInput: unknown, ctx: HandlerCtx): Promise<unknown>;
+}
+//#endregion
+export { OperationKey, SpecRegistry, opKey };
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../src/registry.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAyBe,KANH,YAAA,GAMG,GAAA,MAAA,KAAA,MAAA,EAAA;AAAY,iBAJX,KAAA,CAIW,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EAJ2B,YAI3B;AAAA,KAAtB,OAAA,GAAU,YAIA,CAHb,cAGgD,EAFhD,cAEuD,GAFtC,qBAEsC,CAAA,OAAA,CAAA,CAAA;AAMzD,KANK,UAAA,GAMQ,CAAY,IAAA,EAAA,GAAA,EAAA,GAAA,EANU,UAMV,EAAA,GANyB,OAMzB,CAAA,OAAA,CAAA;;;;;AAcC,cAdb,YAAA,CAca;EAAhB,QAAA,KAAA;EAgBI,QAAA,QAAA;EACA;;;;;;;EACoC,QAAA,CAAA,UApBpC,cAoBoC,EAAA,UAnBpC,cAmBoC,GAnBnB,qBAmBmB,CAAA,OAAA,CAAA,CAAA,CAAA,IAAA,EAlBxC,YAkBwC,CAlB3B,CAkB2B,EAlBxB,CAkBwB,CAAA,CAAA,EAAA,IAAA;EAAX;;;;;;;;EA2E3B,IAAA,CAAA,UA7EE,cA6EF,EAAA,UA5EE,cA4EF,GA5EmB,qBA4EnB,CAAA,OAAA,CAAA,CAAA,CAAA,IAAA,EA3EF,YA2EE,CA3EW,CA2EX,EA3Ec,CA2Ed,CAAA,EAAA,OAAA,EA3E2B,UA2E3B,CA3EsC,YA2EtC,CA3EmD,CA2EnD,EA3EsD,CA2EtD,CAAA,CAAA,CAAA,EAAA,IAAA;;;;;;;;2CAzD+B;;;;8CAkBG;;eAO/B;;;UAKQ;aAAkB;;;;;;;;;;;;;;;6EA0BhC,aACJ"}

package/dist/registry.js

@@ -0,0 +1,2 @@
+import{eventKey as e}from"./events.js";import{isEmitDeclRef as t}from"./spec.js";function n(e,t){return`${e}.v${t}`}var r=class{specs=new Map;handlers=new Map;register(e){let t=n(e.meta.name,e.meta.version);if(this.specs.has(t))throw Error(`Duplicate spec ${t}`);return this.specs.set(t,e),this}bind(e,t){let r=n(e.meta.name,e.meta.version);if(!this.specs.has(r))throw Error(`Cannot bind; spec not found: ${r}`);if(this.handlers.has(r))throw Error(`Handler already bound for ${r}`);return this.handlers.set(r,t),this}getSpec(e,t){if(t!=null)return this.specs.get(n(e,t));let r,i=-1/0;for(let[t,n]of this.specs.entries())t.startsWith(`${e}.v`)&&n.meta.version>i&&(i=n.meta.version,r=n);return r}getHandler(e,t){let r=this.getSpec(e,t);if(r)return this.handlers.get(n(r.meta.name,r.meta.version))}listSpecs(){return[...this.specs.values()]}listBound(){let e=[];for(let[t,n]of this.specs.entries()){let r=this.handlers.get(t);r&&e.push({spec:n,handler:r})}return e}async execute(r,i,a,o){let s=this.getSpec(r,i);if(!s)throw Error(`Spec not found for ${r}${i?`.v${i}`:``}`);let c=n(s.meta.name,s.meta.version),l=this.handlers.get(c);if(!l)throw Error(`No handler bound for ${c}`);let u=s.io.input?.getZod().parse(a);if(o.decide){let[e,t]=s.meta.name.split(`.`),n=await o.decide({service:e,command:t,version:s.meta.version,actor:o.actor??`anonymous`,channel:o.channel,roles:o.roles,organizationId:o.organizationId,userId:o.userId,flags:[]});if(n.effect===`deny`)throw Error(`PolicyDenied: ${s.meta.name}.v${s.meta.version}`);if(n.rateLimit&&o.rateLimit){let e=n.rateLimit.key??`default`,t=n.rateLimit.rpm??60;await o.rateLimit(e,1,t)}}let d=new Map;if(s.sideEffects?.emits)for(let e of s.sideEffects.emits)t(e)?d.set(`${e.ref.name}.v${e.ref.version}`,e.ref.payload):d.set(`${e.name}.v${e.version}`,e.payload);let f=async(t,r,i)=>{let a=e(t,r),c=d.get(a);if(!c)throw Error(`UndeclaredEvent: ${a} not allowed by ${n(s.meta.name,s.meta.version)}`);let l=c.getZod().parse(i);await o.eventPublisher?.({name:t,version:r,payload:l,traceId:o.traceId})};o.appConfig&&(o.branding||=o.appConfig.branding,o.translation?o.translation.config||(o.translation={...o.translation,config:o.appConfig.translation}):o.translation={config:o.appConfig.translation});let p=o.telemetry,m=async(e,t)=>{if(!(!p||!e?.event))try{let n=e.properties?.(t)??{};await p.track(e.event.name,e.event.version??1,n,{tenantId:o.organizationId??void 0,organizationId:o.organizationId,userId:o.userId,actor:o.actor,channel:o.channel,metadata:o.traceId?{traceId:o.traceId}:void 0})}catch{}},h;try{h=await l(u,{...o,__emitGuard__:f})}catch(e){throw s.telemetry?.failure&&await m(s.telemetry.failure,{input:u??a,error:e}),e}s.telemetry?.success&&await m(s.telemetry.success,{input:u??a,output:h});let g=s.io.output;return g?.getZod?g.getZod().parse(h):h}};export{r as SpecRegistry,n as opKey};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":["key: OperationKey","found: AnySpec | undefined","out: { spec: AnySpec; handler: AnyHandler }[]","key","result: unknown"],"sources":["../src/registry.ts"],"sourcesContent":["/**\n * SpecRegistry:\n * - Registers ContractSpecs (unique by name+version)\n * - Binds runtime handlers to specs\n * - Provides lookup, iteration, and a safe execute() with validation/policy/enforcement\n *\n * Includes a minimal OpRegistry shim for backward-compat (deprecated).\n */\nimport {\n  type ContractSpec,\n  type TelemetryTrigger,\n  isEmitDeclRef,\n} from './spec';\nimport type { ResourceRefDescriptor } from './resources';\nimport type { HandlerCtx } from './types';\nimport { eventKey } from './events';\nimport type { AnySchemaModel, ZodSchemaModel } from '@lssm/lib.schema';\nimport type { HandlerFor } from './install';\n\nexport type OperationKey = `${string}.v${number}`;\n\nexport function opKey(name: string, version: number): OperationKey {\n  return `${name}.v${version}`;\n}\n\ntype AnySpec = ContractSpec<\n  AnySchemaModel,\n  AnySchemaModel | ResourceRefDescriptor<boolean>\n>;\ntype AnyHandler = (args: any, ctx: HandlerCtx) => Promise<unknown>;\n\n/**\n * In-memory registry for ContractSpecs and their bound handlers.\n * Provides validation, policy enforcement, and guarded event emission at execute time.\n */\nexport class SpecRegistry {\n  private specs = new Map<OperationKey, AnySpec>();\n  private handlers = new Map<OperationKey, AnyHandler>();\n\n  /**\n   * Registers a ContractSpec definition.\n   *\n   * @param spec - The contract specification to register.\n   * @returns The registry instance for chaining.\n   * @throws If a spec with the same name and version is already registered.\n   */\n  register<\n    I extends AnySchemaModel,\n    O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  >(spec: ContractSpec<I, O>): this {\n    const key = opKey(spec.meta.name, spec.meta.version);\n    if (this.specs.has(key)) throw new Error(`Duplicate spec ${key}`);\n    this.specs.set(key, spec as AnySpec);\n    return this;\n  }\n\n  /**\n   * Binds a runtime handler implementation to a previously registered spec.\n   *\n   * @param spec - The spec to bind to.\n   * @param handler - The async function implementing the business logic.\n   * @returns The registry instance for chaining.\n   * @throws If the spec is not found or a handler is already bound.\n   */\n  bind<\n    I extends AnySchemaModel,\n    O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  >(spec: ContractSpec<I, O>, handler: HandlerFor<ContractSpec<I, O>>): this {\n    const key: OperationKey = opKey(spec.meta.name, spec.meta.version);\n\n    if (!this.specs.has(key))\n      throw new Error(`Cannot bind; spec not found: ${key}`);\n    if (this.handlers.has(key))\n      throw new Error(`Handler already bound for ${key}`);\n    this.handlers.set(key, handler);\n    return this;\n  }\n\n  /**\n   * Retrieves a registered spec by name and version.\n   * If version is omitted, returns the highest version found.\n   *\n   * @param name - Operation name.\n   * @param version - (Optional) Specific version.\n   */\n  getSpec(name: string, version?: number): AnySpec | undefined {\n    if (version != null) return this.specs.get(opKey(name, version));\n    // find highest version by scanning keys of the same name\n    let found: AnySpec | undefined;\n    let maxV = -Infinity;\n    for (const [k, s] of this.specs.entries()) {\n      if (!k.startsWith(`${name}.v`)) continue;\n      if (s.meta.version > maxV) {\n        maxV = s.meta.version;\n        found = s;\n      }\n    }\n    return found;\n  }\n\n  /**\n   * Retrieves the bound handler for a spec.\n   */\n  getHandler(name: string, version?: number): AnyHandler | undefined {\n    const spec = this.getSpec(name, version);\n    if (!spec) return undefined;\n    return this.handlers.get(opKey(spec.meta.name, spec.meta.version));\n  }\n\n  /** Iterate all registered specs. */\n  listSpecs(): AnySpec[] {\n    return [...this.specs.values()];\n  }\n\n  /** Iterate all bound operations (spec+handler). */\n  listBound(): { spec: AnySpec; handler: AnyHandler }[] {\n    const out: { spec: AnySpec; handler: AnyHandler }[] = [];\n    for (const [k, spec] of this.specs.entries()) {\n      const h = this.handlers.get(k);\n      if (h) out.push({ spec, handler: h });\n    }\n    return out;\n  }\n\n  /**\n   * Execute an operation by name/version with full runtime protections:\n   * 1. Validates input against Zod schema.\n   * 2. Enforces policy (Auth, RBAC, Rate Limits) via PDP.\n   * 3. Guards event emission to ensure only declared events are sent.\n   * 4. Validates output against Zod schema (if applicable).\n   * 5. Tracks telemetry (success/failure).\n   *\n   * @param name - Operation name.\n   * @param version - Operation version (optional, defaults to latest).\n   * @param rawInput - The raw input payload (e.g. from JSON body).\n   * @param ctx - The runtime context (actor, tenant, etc.).\n   */\n  async execute(\n    name: string,\n    version: number | undefined,\n    rawInput: unknown,\n    ctx: HandlerCtx\n  ): Promise<unknown> {\n    const spec = this.getSpec(name, version);\n    if (!spec)\n      throw new Error(\n        `Spec not found for ${name}${version ? `.v${version}` : ''}`\n      );\n\n    const key = opKey(spec.meta.name, spec.meta.version);\n    const handler = this.handlers.get(key);\n    if (!handler) throw new Error(`No handler bound for ${key}`);\n\n    // 1) Validate input\n    const parsedInput = spec.io.input?.getZod().parse(rawInput);\n\n    // 2) Policy enforcement\n    if (ctx.decide) {\n      const [service, command] = spec.meta.name.split('.');\n      const decision = await ctx.decide({\n        service: service!,\n        command: command!,\n        version: spec.meta.version,\n        actor: ctx.actor ?? 'anonymous',\n        channel: ctx.channel,\n        roles: ctx.roles,\n        organizationId: ctx.organizationId,\n        userId: ctx.userId,\n        flags: [], // adapter may fill flags from request\n      });\n      if (decision.effect === 'deny') {\n        throw new Error(\n          `PolicyDenied: ${spec.meta.name}.v${spec.meta.version}`\n        );\n      }\n      if (decision.rateLimit && ctx.rateLimit) {\n        const key = decision.rateLimit.key ?? 'default';\n        const rpm = decision.rateLimit.rpm ?? 60;\n        await ctx.rateLimit(key, 1, rpm);\n      }\n      // escalations are advisory; adapter may short-circuit if needed\n    }\n\n    // 3) Event emission guard\n    const allowedEvents = new Map<string, AnySchemaModel>();\n    if (spec.sideEffects?.emits) {\n      for (const e of spec.sideEffects.emits) {\n        if (isEmitDeclRef(e)) {\n          allowedEvents.set(`${e.ref.name}.v${e.ref.version}`, e.ref.payload);\n        } else {\n          allowedEvents.set(`${e.name}.v${e.version}`, e.payload);\n        }\n      }\n    }\n\n    const emitGuard = async (\n      eventName: string,\n      eventVersion: number,\n      payload: unknown\n    ) => {\n      const key2 = eventKey(eventName, eventVersion);\n      const schema = allowedEvents.get(key2);\n      if (!schema)\n        throw new Error(\n          `UndeclaredEvent: ${key2} not allowed by ${opKey(spec.meta.name, spec.meta.version)}`\n        );\n      const parsed = schema.getZod().parse(payload);\n      // Delegate to service publisher if present\n      await ctx.eventPublisher?.({\n        name: eventName,\n        version: eventVersion,\n        payload: parsed,\n        traceId: ctx.traceId,\n      });\n    };\n\n    // 4) Execute handler with guarded ctx\n    if (ctx.appConfig) {\n      if (!ctx.branding) {\n        ctx.branding = ctx.appConfig.branding;\n      }\n      if (!ctx.translation) {\n        ctx.translation = { config: ctx.appConfig.translation };\n      } else if (!ctx.translation.config) {\n        ctx.translation = {\n          ...ctx.translation,\n          config: ctx.appConfig.translation,\n        };\n      }\n    }\n    const telemetryContext = ctx.telemetry;\n    const trackTelemetry = async (\n      trigger: TelemetryTrigger | undefined,\n      details: { input: unknown; output?: unknown; error?: unknown }\n    ) => {\n      if (!telemetryContext || !trigger?.event) return;\n      try {\n        const props = trigger.properties?.(details) ?? {};\n        await telemetryContext.track(\n          trigger.event.name,\n          trigger.event.version ?? 1,\n          props,\n          {\n            tenantId: ctx.organizationId ?? undefined,\n            organizationId: ctx.organizationId,\n            userId: ctx.userId,\n            actor: ctx.actor,\n            channel: ctx.channel,\n            metadata: ctx.traceId ? { traceId: ctx.traceId } : undefined,\n          }\n        );\n      } catch (_error) {\n        // Best-effort telemetry: swallow errors to avoid breaking the handler.\n      }\n    };\n\n    let result: unknown;\n    try {\n      result = await handler(parsedInput, {\n        ...ctx,\n        __emitGuard__: emitGuard,\n      });\n    } catch (error) {\n      if (spec.telemetry?.failure) {\n        await trackTelemetry(spec.telemetry.failure, {\n          input: parsedInput ?? rawInput,\n          error,\n        });\n      }\n      throw error;\n    }\n\n    if (spec.telemetry?.success) {\n      await trackTelemetry(spec.telemetry.success, {\n        input: parsedInput ?? rawInput,\n        output: result,\n      });\n    }\n\n    // 5) Validate output when the spec declares a SchemaModel output.\n    const outputModel = spec.io.output as\n      | AnySchemaModel\n      | ResourceRefDescriptor<boolean>;\n    if ((outputModel as AnySchemaModel)?.getZod) {\n      const parsedOutput = (outputModel as AnySchemaModel)\n        .getZod()\n        .parse(result);\n      return parsedOutput;\n    }\n    // ResourceRefDescriptor path: adapter may hydrate entity; leave as-is\n    return result;\n  }\n}\n"],"mappings":"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"}

package/dist/resources.d.ts

@@ -0,0 +1,65 @@
+import { Tag } from "./ownership.js";
+import { z } 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.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.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.ZodType>(spec: ResourceTemplateSpec<I>): ResourceTemplateSpec<I>;
+declare class ResourceRegistry {
+  private templates;
+  register<I extends z.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 };
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","names":[],"sources":["../src/resources.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,YAAA;;EAAA,WAAA,EAAA,MAAY;EAaZ;EAAiC,KAAA,EAAA,MAAA;EAC1C;EAEC,WAAA,CAAA,EAAA,MAAA;EAMS;EAAN,QAAA,EAAA,MAAA;EAE2C;EAAhD,IAAA,CAAA,EAdE,GAcF,EAAA;;AAGS,UAdC,oBAcqB,CAAA,UAdU,CAAA,CAAE,OAcZ,CAAA,CAAA;EAAa,IAAA,EAb3C,YAa2C;EACtB;EAArB,KAAA,EAZC,CAYD;EACgB;;;AAIxB;EAGuB,OAAA,EAAA,CAAA,IAAA,EAdb,CAAA,CAAE,KAcW,CAdL,CAcK,CAAA,EAAA,GAAA,EAAA;IAAoC,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;IAArB,KAAA,CAAA,EAAA,MAAA,GAAA,IAAA;IAKvB,MAAA,CAAA,EAAA,MAAA;EASD,CAAA,EAAA,GA1BP,OA0BO,CAAA;IAAmC,GAAA,EAAA,MAAA;IAAM,QAAA,CAAA,EAAA,MAAA;IAoBtC,IAAA,EA9CsC,UA8CtC,GAAA,MAAqB;EAYtB,CAAA,CAAA;;AAGS,iBA1DT,sBA0DS,CAAA,UA1DwB,CAAA,CAAE,OA0D1B,CAAA,CAAA,IAAA,EAzDjB,oBAyDiB,CAzDI,CAyDJ,CAAA,CAAA,EAxDtB,oBAwDsB,CAxDD,CAwDC,CAAA;AAAtB,cApDU,gBAAA,CAoDV;EAAqB,QAAA,SAAA;EAUR,QAAA,CAAA,UA3DK,CAAA,CAAE,OA2DM,CAAmB,CAAA,IAAA,EA3DV,oBA2D+B,CA3DV,CA2DU,CAAA,CAAA,EAAA,IAAA;mBAtDtD;;;UASD;YAAmC;;;UAoBhC;;;;;;;;;QAST;;iBAGQ;;;QAEuC;IACpD,sBAAsB;iBAUT,aAAA,mBAAgC"}

package/dist/resources.js

@@ -0,0 +1,2 @@
+import{z as e}from"zod";function t(e){return e}var n=class{templates=[];register(e){return this.templates.push(e),this}listTemplates(){return[...this.templates]}match(e){for(let t of this.templates){let n=RegExp(`^`+t.meta.uriTemplate.replace(/\{[^}]+\}/g,`([^/]+)`)+`$`),r=e.match(n);if(!r)continue;let i=[...t.meta.uriTemplate.matchAll(/\{([^}]+)\}/g)].map(e=>e[1]),a={};return i.forEach((e,t)=>a[e]=decodeURIComponent(r[t+1])),{tmpl:t,params:a}}}};function r(e,t){return{kind:`resource_ref`,uriTemplate:e,varName:t.varName??`id`,graphQLType:t.graphQLType,many:t.many}}function i(e){let t=e;return!!t&&t.kind===`resource_ref`&&typeof t.uriTemplate==`string`}export{n as ResourceRegistry,t as defineResourceTemplate,i as isResourceRef,r as resourceRef};
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","names":["params: Record<string, string>"],"sources":["../src/resources.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { Tag } from './ownership';\n\nexport interface ResourceMeta {\n  /** URI scheme, e.g. \"content://doc/{id}\" or \"marketplace://offers/{city}/{tag}\" */\n  uriTemplate: string;\n  /** Human title for discovery */\n  title: string;\n  /** Short description */\n  description?: string;\n  /** MIME type for resource body */\n  mimeType: string; // e.g., \"application/json\" | \"text/markdown\"\n  /** Tags for filtering/grouping */\n  tags?: Tag[];\n}\n\nexport interface ResourceTemplateSpec<I extends z.ZodType> {\n  meta: ResourceMeta;\n  /** Arguments to materialize the URI (zod validates input) */\n  input: I;\n  /**\n   * Resolve returns the resource body and a resolved URI.\n   * It MUST be read-only (no side effects).\n   */\n  resolve: (\n    args: z.infer<I>,\n    ctx: { userId?: string | null; orgId?: string | null; locale?: string }\n  ) => Promise<{ uri: string; mimeType?: string; data: Uint8Array | string }>;\n}\n\nexport function defineResourceTemplate<I extends z.ZodType>(\n  spec: ResourceTemplateSpec<I>\n): ResourceTemplateSpec<I> {\n  return spec;\n}\n\nexport class ResourceRegistry {\n  private templates: ResourceTemplateSpec<any>[] = [];\n\n  register<I extends z.ZodType>(tmpl: ResourceTemplateSpec<I>): this {\n    this.templates.push(tmpl);\n    return this;\n  }\n\n  listTemplates() {\n    return [...this.templates];\n  }\n\n  /** Try to match a concrete URI to a template by naive pattern substitution */\n  // MVP: simple matcher; replace {param} with (.+) and capture\n  match(\n    uri: string\n  ):\n    | { tmpl: ResourceTemplateSpec<any>; params: Record<string, string> }\n    | undefined {\n    for (const tmpl of this.templates) {\n      const re = new RegExp(\n        '^' + tmpl.meta.uriTemplate.replace(/\\{[^}]+\\}/g, '([^/]+)') + '$'\n      );\n      const m = uri.match(re);\n      if (!m) continue;\n      const names = [...tmpl.meta.uriTemplate.matchAll(/\\{([^}]+)\\}/g)].map(\n        (x) => x[1]\n      );\n      const params: Record<string, string> = {};\n      names.forEach((n, i) => (params[n!] = decodeURIComponent(m[i + 1]!)));\n      return { tmpl, params };\n    }\n    return undefined;\n  }\n}\n\n// ResourceRef (output descriptor for ContractSpecs)\nexport interface ResourceRefDescriptor<Many extends boolean> {\n  kind: 'resource_ref';\n  /** URI template, e.g. 'strit://spot/{id}' */\n  uriTemplate: string;\n  /** Variable name inside result payload to substitute into template; defaults to 'id' */\n  varName?: string;\n  /** Optional GraphQL type name to use when exposing over GraphQL (e.g., 'Spot') */\n  graphQLType: string;\n  /** Cardinality: when present and true, the handler returns an array of resources */\n  many: Many;\n}\n\nexport function resourceRef<Many extends boolean>(\n  uriTemplate: string,\n  opts: { varName?: string; graphQLType: string; many: Many }\n): ResourceRefDescriptor<Many> {\n  return {\n    kind: 'resource_ref',\n    uriTemplate,\n    varName: opts.varName ?? 'id',\n    graphQLType: opts.graphQLType,\n    many: opts.many,\n  };\n}\n\nexport function isResourceRef(x: unknown): x is ResourceRefDescriptor<boolean> {\n  const o = x as any;\n  return !!o && o.kind === 'resource_ref' && typeof o.uriTemplate === 'string';\n}\n"],"mappings":"wBA8BA,SAAgB,EACd,EACyB,CACzB,OAAO,EAGT,IAAa,EAAb,KAA8B,CAC5B,UAAiD,EAAE,CAEnD,SAA8B,EAAqC,CAEjE,OADA,KAAK,UAAU,KAAK,EAAK,CAClB,KAGT,eAAgB,CACd,MAAO,CAAC,GAAG,KAAK,UAAU,CAK5B,MACE,EAGY,CACZ,IAAK,IAAM,KAAQ,KAAK,UAAW,CACjC,IAAM,EAAS,OACb,IAAM,EAAK,KAAK,YAAY,QAAQ,aAAc,UAAU,CAAG,IAChE,CACK,EAAI,EAAI,MAAM,EAAG,CACvB,GAAI,CAAC,EAAG,SACR,IAAM,EAAQ,CAAC,GAAG,EAAK,KAAK,YAAY,SAAS,eAAe,CAAC,CAAC,IAC/D,GAAM,EAAE,GACV,CACKA,EAAiC,EAAE,CAEzC,OADA,EAAM,SAAS,EAAG,IAAO,EAAO,GAAM,mBAAmB,EAAE,EAAI,GAAI,CAAE,CAC9D,CAAE,OAAM,SAAQ,IAmB7B,SAAgB,EACd,EACA,EAC6B,CAC7B,MAAO,CACL,KAAM,eACN,cACA,QAAS,EAAK,SAAW,KACzB,YAAa,EAAK,YAClB,KAAM,EAAK,KACZ,CAGH,SAAgB,EAAc,EAAiD,CAC7E,IAAM,EAAI,EACV,MAAO,CAAC,CAAC,GAAK,EAAE,OAAS,gBAAkB,OAAO,EAAE,aAAgB"}

package/dist/schema/dist/EnumType.js

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

package/dist/schema/dist/FieldType.js

@@ -0,0 +1,2 @@
+import{z as e}from"zod";import{GraphQLScalarType as t,Kind as n}from"graphql";var r=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{r};
+//# sourceMappingURL=FieldType.js.map

package/dist/schema/dist/FieldType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldType.js","names":["t","r"],"sources":["../../../../schema/dist/FieldType.js"],"sourcesContent":["import{z as e}from\"zod\";import{GraphQLScalarType as t,Kind as n}from\"graphql\";var r=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{r as FieldType};\n//# sourceMappingURL=FieldType.js.map"],"mappings":"8EAA8E,IAAI,EAAE,cAAcA,CAAC,CAAC,UAAU,cAAc,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,UAAU,EAAE,IAAI,KAAK,cAAc,EAAE,WAAW,QAAQ,CAAC,OAAO,KAAK,UAAU,WAAW,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,OAAO,KAAK,eAAe,WAAW,KAAK,eAAe,CAAC,KAAK,cAAc,kBAAkB,CAAC,OAAO,KAAK,cAAc,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,CAAC,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,IAAI,GAAG,EAAEA,EAAE,CAAC,CAAC,GAAG,GAAG,OAAO,GAAG,SAAS,CAAC,IAAIA,EAAE,EAAE,CAAC,IAAI,GAAG,CAACC,EAAE,KAAK,OAAO,QAAQ,EAAE,CAAC,EAAEA,GAAG,EAAE,EAAE,CAAC,OAAOD,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,SAAS,CAAC"}

package/dist/schema/dist/ScalarTypeEnum.js

@@ -0,0 +1,2 @@
+import{r 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};
+//# sourceMappingURL=ScalarTypeEnum.js.map

package/dist/schema/dist/ScalarTypeEnum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScalarTypeEnum.js","names":["r","e","t","n"],"sources":["../../../../schema/dist/ScalarTypeEnum.js"],"sourcesContent":["import{FieldType 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 as ScalarTypeEnum};\n//# sourceMappingURL=ScalarTypeEnum.js.map"],"mappings":"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"}

package/dist/schema/dist/SchemaModel.js

@@ -0,0 +1,2 @@
+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}};export{t};
+//# sourceMappingURL=SchemaModel.js.map

package/dist/schema/dist/SchemaModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaModel.js","names":["t","e"],"sources":["../../../../schema/dist/SchemaModel.js"],"sourcesContent":["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}};export{t as SchemaModel};\n//# sourceMappingURL=SchemaModel.js.map"],"mappings":"qEAAqE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,KAAK,OAAO,EAAE,QAAQ,CAAC,IAAIA,EAAE,OAAO,QAAQ,KAAK,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,QAAQ,CAAC,EAAE,EAAE,QAAQC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAO,GAAE,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,EAAED,GAAG,EAAE,CAAC,CAAC,OAAOC,EAAE,OAAOD,EAAE,CAAC,gBAAgB,CAAC,OAAO,KAAK,OAAO"}

package/dist/schema/dist/index.js

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

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

@@ -0,0 +1,32 @@
+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 };
+//# sourceMappingURL=graphql-pothos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-pothos.d.ts","names":[],"sources":["../../src/server/graphql-pothos.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AAuCA;;;;;;;;;;;;;;;iBAAgB,qCAAqC,sBAC1C,iBAAA,CAAkB,cAAc,SACpC,0BACO"}

package/dist/server/graphql-pothos.js

@@ -0,0 +1,2 @@
+import{hydrateResourceIfNeeded as e,parseReturns as t}from"../contracts-adapter-hydration.js";import{createInputTypeBuilder as n}from"../contracts-adapter-input.js";import{defaultGqlField as r}from"../jsonschema.js";import"@pothos/plugin-prisma";import"@pothos/plugin-complexity";import"@pothos/plugin-relay";import"@pothos/plugin-dataloader";import"@pothos/plugin-tracing";function i(i,a,o){let{buildInputFieldArgs:s}=n(i),c=new Map;for(let e of a.listSpecs()){let t=e.io.output;if(t&&`getZod`in t&&typeof t.getZod==`function`){let e=t,n=e.config?.name??`UnknownOutput`;c.has(n)||c.set(n,e)}}for(let[e,t]of c.entries())i.objectType(e,{fields:e=>{let n=Object.entries(t.config.fields),r={};for(let[t,i]of n){let n=i.type,a=`JSON`;n&&typeof n.getPothos==`function`&&(a=n.getPothos().name||`JSON`,a===`String_unsecure`&&(a=`String`),a===`Int_unsecure`&&(a=`Int`),a===`Float_unsecure`&&(a=`Float`),a===`Boolean_unsecure`&&(a=`Boolean`),a===`ID_unsecure`&&(a=`ID`));let o=i.isArray?[a]:a;r[t]=e.field({type:o,nullable:i.isOptional,resolve:e=>e[t]})}return r}});function l(e){let t=e.transport?.gql?.returns;if(t)return t;let n=e.io.output??{};if(n&&`kind`in n&&n.kind===`resource_ref`&&`graphQLType`in n&&n.graphQLType)return String(n.graphQLType);if(n&&`getZod`in n&&typeof n.getZod==`function`){let e=n.config?.name;if(e&&c.has(e))return e}return`JSON`}for(let n of a.listSpecs()){let c=n.transport?.gql?.field??r(n.meta.name,n.meta.version);n.transport?.gql?.returns;let u=n.transport?.gql?.byIdField??`id`,d=n.transport?.gql?.resource,f=n.meta.kind===`query`,p=l(n),m=n.transport?.gql?.returns,h=t(m??p),g=async(t,r,i)=>{if(n.policy.auth!==`anonymous`&&!i.user)throw Error(`Unauthorized`);let s={traceId:i.logger?.getTraceId?.()??void 0,userId:i.user?.id??null,organizationId:i.session?.activeOrganizationId??null,actor:i.user?`user`:`anonymous`,channel:`web`,eventPublisher:i.eventPublisher},c=n.io.input?.getZod().parse(r.input??{}),l=await a.execute(n.meta.name,n.meta.version,c,s),f=n.io.output;if(o&&(d||f?.kind===`resource_ref`)){let t=u??f?.varName??`id`,n=await e(o,l,{template:d??f?.uriTemplate,varName:t,returns:h});if(n!==l)return n}return p?h.inner===`Boolean`&&!h.isList?!!(l?.ok??l):l:n.io.output.getZod().parse(l)},_=e=>{let t=s(n.io.input);return e.field({type:h.isList?[h.inner]:h.inner,complexity:()=>10,resolve:g,args:t?{input:e.arg({type:t,required:!0})}:void 0})};f?i.queryField(c,_):i.mutationField(c,_)}}export{i as registerContractsOnBuilder};
+//# sourceMappingURL=graphql-pothos.js.map

package/dist/server/graphql-pothos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-pothos.js","names":["acc: Record<string, any>","handlerCtx: HandlerCtx","result: unknown","fieldSettingsFn: QueryFieldThunk<T> | MutationFieldThunk<T>"],"sources":["../../src/server/graphql-pothos.ts"],"sourcesContent":["import type {\n  MutationFieldThunk,\n  QueryFieldThunk,\n  SchemaTypes,\n} from '@pothos/core';\nimport type { HandlerCtx } from '../types';\nimport { defaultGqlField } from '../jsonschema';\nimport type { SpecRegistry } from '../registry';\nimport '@pothos/plugin-prisma';\nimport '@pothos/plugin-complexity';\nimport '@pothos/plugin-relay';\nimport '@pothos/plugin-dataloader';\nimport '@pothos/plugin-tracing';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ResourceRefDescriptor, ResourceRegistry } from '../resources';\nimport { createInputTypeBuilder } from '../contracts-adapter-input';\nimport type { AnyContractSpec } from '../spec';\nimport {\n  hydrateResourceIfNeeded,\n  parseReturns,\n} from '../contracts-adapter-hydration';\n\n/**\n * Registers all ContractSpecs from a SpecRegistry onto a Pothos SchemaBuilder.\n *\n * This adapter:\n * 1. Discovers output types from specs and registers them as Pothos object types.\n * 2. Maps `ContractSpec` inputs to Pothos input types.\n * 3. Mounts `query` specs as `Query` fields and `command` specs as `Mutation` fields.\n * 4. Wraps the resolver to:\n *    - Enforce auth policies (basic check).\n *    - Build a `HandlerCtx`.\n *    - Execute via `SpecRegistry`.\n *    - Hydrate resource references if applicable.\n *\n * @param builder - The Pothos SchemaBuilder instance.\n * @param reg - The SpecRegistry containing operations.\n * @param resources - (Optional) ResourceRegistry for hydrating resource references.\n */\nexport function registerContractsOnBuilder<T extends SchemaTypes>(\n  builder: PothosSchemaTypes.SchemaBuilder<T>,\n  reg: SpecRegistry,\n  resources?: ResourceRegistry\n) {\n  const { buildInputFieldArgs } = createInputTypeBuilder(builder);\n\n  // Build a map of output types we need to register\n  const outputTypeCache = new Map<string, AnySchemaModel>();\n  for (const spec of reg.listSpecs()) {\n    const out = spec.io.output as\n      | AnySchemaModel\n      | ResourceRefDescriptor<boolean>;\n    if (out && 'getZod' in out && typeof out.getZod === 'function') {\n      const model = out as AnySchemaModel;\n      const typeName = model.config?.name ?? 'UnknownOutput';\n      if (!outputTypeCache.has(typeName)) {\n        outputTypeCache.set(typeName, model);\n      }\n    }\n  }\n\n  // Register all output types as GraphQL object types\n  for (const [typeName, model] of outputTypeCache.entries()) {\n    builder.objectType(typeName as any, {\n      fields: (t) => {\n        const entries = Object.entries(model.config.fields) as [\n          string,\n          {\n            type: any;\n            isOptional: boolean;\n            isArray?: boolean;\n          },\n        ][];\n        const acc: Record<string, any> = {};\n        for (const [key, field] of entries) {\n          const fieldType = field.type;\n          let gqlType = 'JSON';\n\n          // Check if it's a known scalar type\n          if (fieldType && typeof fieldType.getPothos === 'function') {\n            const pothosInfo = fieldType.getPothos();\n            gqlType = pothosInfo.name || 'JSON';\n            // Map unsecure types to their secure equivalents\n            if (gqlType === 'String_unsecure') gqlType = 'String';\n            if (gqlType === 'Int_unsecure') gqlType = 'Int';\n            if (gqlType === 'Float_unsecure') gqlType = 'Float';\n            if (gqlType === 'Boolean_unsecure') gqlType = 'Boolean';\n            if (gqlType === 'ID_unsecure') gqlType = 'ID';\n          }\n\n          const typeRef = field.isArray\n            ? ([gqlType] as never)\n            : (gqlType as never);\n          acc[key] = t.field({\n            type: typeRef,\n            nullable: field.isOptional,\n            resolve: (parent: any) => parent[key],\n          });\n        }\n        return acc as never;\n      },\n    });\n  }\n\n  // For outputs, prefer an explicit GraphQL type name; otherwise use SchemaModel name or resource ref\n  function resolveGraphQLTypeName(contractSpec: AnyContractSpec): string {\n    const returnsName = contractSpec.transport?.gql?.returns;\n    if (returnsName) return returnsName;\n\n    const out = contractSpec.io.output ?? {};\n\n    // Check if it's a resource ref\n    if (\n      out &&\n      'kind' in out &&\n      out.kind === 'resource_ref' &&\n      'graphQLType' in out &&\n      out.graphQLType\n    )\n      return String(out.graphQLType);\n\n    // Check if it's a SchemaModel with a name\n    if (out && 'getZod' in out && typeof out.getZod === 'function') {\n      const model = out as AnySchemaModel;\n      const typeName = model.config?.name;\n      if (typeName && outputTypeCache.has(typeName)) {\n        return typeName;\n      }\n    }\n\n    return 'JSON';\n  }\n\n  // parseReturns moved to hydration util\n\n  for (const spec of reg.listSpecs()) {\n    const fieldName =\n      spec.transport?.gql?.field ??\n      defaultGqlField(spec.meta.name, spec.meta.version);\n    const returnsName = spec.transport?.gql?.returns;\n    const byIdField =\n      (spec.transport as unknown as { gql?: { byIdField?: string } })?.gql\n        ?.byIdField ?? 'id';\n    const returnsResource = (\n      spec.transport as unknown as { gql?: { resource?: string } }\n    )?.gql?.resource;\n    const isQuery = spec.meta.kind === 'query';\n\n    const graphQLTypeName = resolveGraphQLTypeName(spec);\n    const returnsDecl = (\n      spec.transport as unknown as { gql?: { returns?: string } }\n    )?.gql?.returns;\n    const parsed = parseReturns(returnsDecl ?? graphQLTypeName);\n\n    const resolveFieldFn = async (_root: any, args: any, ctx: any) => {\n      if (spec.policy.auth !== 'anonymous' && !ctx.user)\n        throw new Error('Unauthorized');\n      const handlerCtx: HandlerCtx = {\n        traceId: ctx.logger?.getTraceId?.() ?? undefined,\n        userId: ctx.user?.id ?? null,\n        organizationId: ctx.session?.activeOrganizationId ?? null,\n        actor: ctx.user ? 'user' : 'anonymous',\n        channel: 'web',\n        eventPublisher: ctx.eventPublisher,\n      };\n      const parsedInput = spec.io.input?.getZod().parse(args.input ?? {});\n      const result: unknown = await reg.execute(\n        spec.meta.name,\n        spec.meta.version,\n        parsedInput,\n        handlerCtx\n      );\n      const out = spec.io.output as unknown;\n      if (\n        resources &&\n        (returnsResource || (out as { kind?: string })?.kind === 'resource_ref')\n      ) {\n        const varName =\n          byIdField ?? (out as { varName?: string })?.varName ?? 'id';\n        const template =\n          returnsResource ?? (out as { uriTemplate?: string })?.uriTemplate;\n        const hydrated = await hydrateResourceIfNeeded(resources, result, {\n          template,\n          varName,\n          returns: parsed,\n        });\n        if (hydrated !== result) return hydrated as never;\n      }\n      if (graphQLTypeName) {\n        if (parsed.inner === 'Boolean' && !parsed.isList)\n          return Boolean((result as { ok?: boolean })?.ok ?? result) as never;\n        // fallback to direct\n        return result as unknown as never;\n      }\n      const parsedOut: unknown = (spec.io.output as AnySchemaModel)\n        .getZod()\n        .parse(result);\n      return parsedOut as never;\n    };\n\n    const fieldSettingsFn: QueryFieldThunk<T> | MutationFieldThunk<T> = (\n      t: PothosSchemaTypes.MutationFieldBuilder<T, T['Root']>\n    ) => {\n      const inputType = buildInputFieldArgs(spec.io.input);\n      return t.field({\n        type: (parsed.isList ? [parsed.inner] : parsed.inner) as any,\n        complexity: () => 10,\n        resolve: resolveFieldFn as any,\n        args: inputType\n          ? {\n              input: t.arg({\n                type: inputType,\n                required: true,\n              }),\n            }\n          : undefined,\n      });\n    };\n\n    if (isQuery) {\n      builder.queryField(\n        fieldName,\n        fieldSettingsFn as never as QueryFieldThunk<T>\n      );\n    } else {\n      builder.mutationField(\n        fieldName,\n        fieldSettingsFn as MutationFieldThunk<T>\n      );\n    }\n  }\n}\n"],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-schema-export.d.ts","names":[],"sources":["../../src/server/graphql-schema-export.ts"],"sourcesContent":[],"mappings":";;;cAKa,yCACH,yCACa"}

package/dist/server/graphql-schema-export.js

@@ -0,0 +1,2 @@
+"use server";import{t as e}from"../graphql-federation/dist/index.js";import{GraphQLSchema as t,printSchema as n}from"graphql";const r=async(t,r)=>{let i=await import(`fs`),a=await import(`path`),o=n(t),s=e(t),c=a.join(r,`../schema.graphql`),l=a.join(r,`../schema.subgraph.graphql`);i.writeFileSync(c,o),console.log(`Schema exported to ${c}`),i.writeFileSync(l,s),console.log(`Subgraph exported to ${l}`)};export{r as exportContractsToGraphQLSchema};
+//# sourceMappingURL=graphql-schema-export.js.map

package/dist/server/graphql-schema-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-schema-export.js","names":["toSubgraphSDL"],"sources":["../../src/server/graphql-schema-export.ts"],"sourcesContent":["'use server';\n\nimport { GraphQLSchema, printSchema } from 'graphql';\nimport { toSubgraphSDL } from '@lssm/lib.graphql-federation';\n\nexport const exportContractsToGraphQLSchema = async (\n  schema: GraphQLSchema,\n  outputPathDir: string\n) => {\n  const fs = await import('fs');\n  const path = await import('path');\n\n  const schemaString = printSchema(schema);\n  const subgraphString = toSubgraphSDL(schema);\n  const outputPath = path.join(outputPathDir, '../schema.graphql');\n  const subgraphPath = path.join(outputPathDir, '../schema.subgraph.graphql');\n\n  fs.writeFileSync(outputPath, schemaString);\n  console.log(`Schema exported to ${outputPath}`);\n  fs.writeFileSync(subgraphPath, subgraphString);\n  console.log(`Subgraph exported to ${subgraphPath}`);\n};\n"],"mappings":"8HAKA,MAAa,EAAiC,MAC5C,EACA,IACG,CACH,IAAM,EAAK,MAAM,OAAO,MAClB,EAAO,MAAM,OAAO,QAEpB,EAAe,EAAY,EAAO,CAClC,EAAiBA,EAAc,EAAO,CACtC,EAAa,EAAK,KAAK,EAAe,oBAAoB,CAC1D,EAAe,EAAK,KAAK,EAAe,6BAA6B,CAE3E,EAAG,cAAc,EAAY,EAAa,CAC1C,QAAQ,IAAI,sBAAsB,IAAa,CAC/C,EAAG,cAAc,EAAc,EAAe,CAC9C,QAAQ,IAAI,wBAAwB,IAAe"}

package/dist/server/index.d.ts

@@ -0,0 +1,9 @@
+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/index.js

@@ -0,0 +1 @@
+import{registerContractsOnBuilder as e}from"./graphql-pothos.js";import{exportContractsToGraphQLSchema as t}from"./graphql-schema-export.js";import{createMcpServer as n}from"./provider-mcp.js";import{createFetchHandler as r}from"./rest-generic.js";import{elysiaPlugin as i}from"./rest-elysia.js";import{expressRouter as a}from"./rest-express.js";import{makeNextAppHandler as o}from"./rest-next-app.js";import{makeNextPagesHandler as s}from"./rest-next-pages.js";export{r as createFetchHandler,n as createMcpServer,i as elysiaPlugin,t as exportContractsToGraphQLSchema,a as expressRouter,o as makeNextAppHandler,s as makeNextPagesHandler,e as registerContractsOnBuilder};

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

@@ -0,0 +1,52 @@
+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 };
+//# sourceMappingURL=provider-mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-mcp.d.ts","names":[],"sources":["../../src/server/provider-mcp.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;AA6CA;;;;;;;;;;;;;;;;;iBAAgB,eAAA,SACN,gBACH,yBACM,2BACF;;iBAGQ;;;;;;;;;;;;;;kBAcC;;oBAEE;IACnB"}

package/dist/server/provider-mcp.js

@@ -0,0 +1,2 @@
+import{createDefaultTransformEngine as e,registerBasicValidation as t,registerDefaultReactRenderer as n}from"../presentations.v2.js";import{defaultMcpTool as r,jsonSchemaForSpec as i}from"../jsonschema.js";import{jsonSchemaForPresentation as a}from"../presentations.js";import o from"zod";import{McpServer as s,ResourceTemplate as c}from"@modelcontextprotocol/sdk/server/mcp.js";import{zodToJsonSchema as l}from"zod-to-json-schema";function u(s,u,d,f,p){for(let e of u.listSpecs()){if(e.meta.kind!==`command`)continue;let{input:t}=i(e),n=e.transport?.mcp?.toolName??r(e.meta.name,e.meta.version);s.registerTool(n,{description:e.meta.description,inputSchema:t},async(t,n)=>{let r=await u.execute(e.meta.name,e.meta.version,t??{},p.toolCtx());return{content:[{type:`text`,text:JSON.stringify(r,null,4)}]}})}for(let e of d.listTemplates())s.registerResource(e.meta.uriTemplate.split(`:`)[0],new c(e.meta.uriTemplate,{}),{description:e.meta.description,inputSchema:l(e.input,{})},async(t,n,r)=>{let i=p.resourceCtx(),a=await e.resolve(n,i);return typeof a.data==`string`?{contents:[{uri:a.uri,mimeType:a.mimeType??e.meta.mimeType,text:a.data}]}:{contents:[{uri:a.uri,mimeType:a.mimeType??e.meta.mimeType,blob:a.data.toString()}]}});let m=p.presentations,h=p.presentationsV2;if(m){t(n(e()));for(let e of m.list()){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;s.registerResource(t,new c(n,{}),{description:e.meta.description??`Presentation`,inputSchema:o.toJSONSchema(o.object({}))},async(t,r,i)=>{if(e.content.kind===`markdown`)return{contents:[{uri:n,mimeType:`text/markdown`,text:e.content.content?e.content.content:`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`){let t=a(e);return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}}let o={name:e.meta.name,version:e.meta.version,kind:e.content.kind,description:e.meta.description??``};return{contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify(o,null,2)}]}});for(let r of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let i=`${t}${r.ext}`,l=`${n}${r.ext}`;s.registerResource(i,new c(l,{}),{description:`${e.meta.description??`Presentation`} (${r.ext})`,inputSchema:o.toJSONSchema(o.object({}))},async()=>{if(e.content.kind===`markdown`&&r.target===`markdown`)return{contents:[{uri:l,mimeType:`text/markdown`,text:e.content.content??`See resource: ${e.content.resourceUri??``}`}]};if(e.content.kind===`data`&&r.target===`application/json`)return{contents:[{uri:l,mimeType:`application/json`,text:JSON.stringify(a(e),null,2)}]};let t=JSON.stringify({meta:e.meta,content:e.content},null,2);return r.target===`application/json`?{contents:[{uri:l,mimeType:`application/json`,text:t}]}:r.target===`application/xml`?{contents:[{uri:l,mimeType:`application/xml`,text:`<presentation name="${e.meta.name}" version="${e.meta.version}"><json>${encodeURIComponent(t)}</json></presentation>`}]}:{contents:[{uri:l,mimeType:`text/markdown`,text:`Unsupported presentation for markdown`}]}})}}}if(h&&h.length){let r=t(n(e()));for(let e of h){let t=`presentation.${e.meta.name.replace(/\./g,`_`)}.v${e.meta.version}`,n=`presentation://${e.meta.name}/v${e.meta.version}`;s.registerResource(t,new c(n,{}),{description:e.meta.description??`Presentation`,inputSchema:o.toJSONSchema(o.object({}))},async()=>({contents:[{uri:n,mimeType:`application/json`,text:JSON.stringify({meta:e.meta,source:e.source,targets:e.targets},null,2)}]}));for(let i of[{ext:`.md`,target:`markdown`},{ext:`.json`,target:`application/json`},{ext:`.xml`,target:`application/xml`}]){let a=`${t}${i.ext}`,l=`${n}${i.ext}`;s.registerResource(a,new c(l,{}),{description:`${e.meta.description??`Presentation`} (${i.ext})`,inputSchema:o.toJSONSchema(o.object({}))},async()=>{let t=await r.render(i.target,e);return{contents:[{uri:l,mimeType:t.mimeType??(i.target===`markdown`?`text/markdown`:i.target),text:t.body??String(t)}]}})}}}for(let e of f.list())s.registerPrompt(e.meta.name,{title:e.meta.title,description:e.meta.title,argsSchema:l(e.input)},async(t,n)=>{let r=(e,t)=>{let n=e;for(let[e,r]of Object.entries(t))n=n.replace(RegExp(`\\{${e}\\}`,`g`),encodeURIComponent(String(r)));return n};return{messages:[{role:`assistant`,content:(await e.render(e.input.parse(t),{...p.promptCtx(),link:r})).map(e=>e.type===`text`?{type:`text`,text:e.text}:{type:`text`,text:`See resource: ${e.title??e.uri}\nURI: ${e.uri}`})[0]}],description:e.meta.description}});return s}export{u as createMcpServer};
+//# sourceMappingURL=provider-mcp.js.map