@lssm/lib.contracts 0.0.0-canary-20251220041653 → 0.0.0-canary-20251221114240

package/README.md

@@ -19,14 +19,14 @@ bun add @lssm/lib.contracts @lssm/lib.schema
 ## Key Concepts
 
 - **Spec-First, TypeScript-First**: Define operations in pure TypeScript (no YAML).
-- **Runtime Adapters**: The `SpecRegistry` is passed to adapters (e.g., `makeNextAppHandler`) to serve APIs dynamically. There is no intermediate "compile" step to generate code; the spec _is_ the code.
+- **Runtime Adapters**: The `OperationSpecRegistry` is passed to adapters (e.g., `makeNextAppHandler`) to serve APIs dynamically. There is no intermediate "compile" step to generate code; the spec _is_ the code.
 - **Capabilities**: `defineCommand` (writes) and `defineQuery` (reads) with Zod-backed I/O.
 - **Events**: `defineEvent` for type-safe side effects.
 - **Presentations**: (V2) Describe how data is rendered (Web Components, Markdown, Data) for automated UI generation.
 
 ## Exports
 
-- **Core**: `SpecRegistry`, `defineCommand`, `defineQuery`, `defineEvent`.
+- **Core**: `OperationSpecRegistry`, `defineCommand`, `defineQuery`, `defineEvent`.
 - **Adapters**:
   - `server/rest-next-app`: Next.js App Router adapter.
   - `server/provider-mcp`: Model Context Protocol (MCP) adapter for AI agents.
@@ -78,9 +78,9 @@ export const CreateUser = defineCommand({
 ### 2. Register and Implement
 
 ```ts
-import { SpecRegistry, installOp } from '@lssm/lib.contracts';
+import { OperationSpecRegistry, installOp } from '@lssm/lib.contracts';
 
-const reg = new SpecRegistry();
+const reg = new OperationSpecRegistry();
 
 installOp(reg, CreateUser, async (ctx, input) => {
   // Implementation logic here

package/dist/app-config/contracts.d.ts

@@ -1,38 +1,38 @@
-import { ContractSpec } from "../spec.js";
-import { SpecRegistry } from "../registry.js";
-import * as _lssm_lib_schema97 from "@lssm/lib.schema";
+import { OperationSpec } from "../operation.js";
+import { OperationSpecRegistry } from "../registry.js";
+import * as _lssm_lib_schema242 from "@lssm/lib.schema";
 import { SchemaModel } from "@lssm/lib.schema";
 
 //#region src/app-config/contracts.d.ts
-declare const UpdateTenantBrandingCommand: ContractSpec<SchemaModel<{
+declare const UpdateTenantBrandingCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
   appName: {
-    type: _lssm_lib_schema97.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema242.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: true;
   };
   assets: {
     type: SchemaModel<{
       type: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       url: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       mimeType: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -40,92 +40,92 @@ declare const UpdateTenantBrandingCommand: ContractSpec<SchemaModel<{
     isArray: true;
   };
   colors: {
-    type: _lssm_lib_schema97.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema242.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: true;
   };
   customDomain: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
   subdomain: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema97.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema242.FieldType<boolean, boolean>;
     isOptional: false;
   };
   updatedAt: {
-    type: _lssm_lib_schema97.FieldType<Date, string>;
+    type: _lssm_lib_schema242.FieldType<Date, string>;
     isOptional: false;
   };
 }>, undefined>;
-declare const VerifyCustomDomainCommand: ContractSpec<SchemaModel<{
+declare const VerifyCustomDomainCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   domain: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   status: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   message: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;
-declare const UpdateBlueprintTranslationCatalogCommand: ContractSpec<SchemaModel<{
+declare const UpdateBlueprintTranslationCatalogCommand: OperationSpec<SchemaModel<{
   blueprintName: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   blueprintVersion: {
-    type: _lssm_lib_schema97.FieldType<number, number>;
+    type: _lssm_lib_schema242.FieldType<number, number>;
     isOptional: false;
   };
   catalogName: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   catalogVersion: {
-    type: _lssm_lib_schema97.FieldType<number, number>;
+    type: _lssm_lib_schema242.FieldType<number, number>;
     isOptional: false;
   };
   defaultLocale: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   supportedLocales: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
     isArray: true;
   };
   entries: {
     type: SchemaModel<{
       key: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       locale: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       value: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       context: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -134,39 +134,39 @@ declare const UpdateBlueprintTranslationCatalogCommand: ContractSpec<SchemaModel
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema97.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema242.FieldType<boolean, boolean>;
     isOptional: false;
   };
   updatedAt: {
-    type: _lssm_lib_schema97.FieldType<Date, string>;
+    type: _lssm_lib_schema242.FieldType<Date, string>;
     isOptional: false;
   };
 }>, undefined>;
-declare const UpdateTenantTranslationOverridesCommand: ContractSpec<SchemaModel<{
+declare const UpdateTenantTranslationOverridesCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   entries: {
     type: SchemaModel<{
       key: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       locale: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       value: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: false;
       };
       context: {
-        type: _lssm_lib_schema97.FieldType<string, string>;
+        type: _lssm_lib_schema242.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -174,71 +174,71 @@ declare const UpdateTenantTranslationOverridesCommand: ContractSpec<SchemaModel<
     isArray: true;
   };
   defaultLocale: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
   enabledLocales: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema97.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema242.FieldType<boolean, boolean>;
     isOptional: false;
   };
   updatedAt: {
-    type: _lssm_lib_schema97.FieldType<Date, string>;
+    type: _lssm_lib_schema242.FieldType<Date, string>;
     isOptional: false;
   };
 }>, undefined>;
-declare const GetResolvedBrandingQuery: ContractSpec<SchemaModel<{
+declare const GetResolvedBrandingQuery: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
 }>, SchemaModel<{
   branding: {
-    type: _lssm_lib_schema97.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema242.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: false;
   };
 }>, undefined>;
-declare const ResolveMessageQuery: ContractSpec<SchemaModel<{
+declare const ResolveMessageQuery: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   locale: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
   key: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   value: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
   source: {
-    type: _lssm_lib_schema97.FieldType<string, string>;
+    type: _lssm_lib_schema242.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;
-declare const appConfigContracts: Record<string, ContractSpec<any, any>>;
-declare function registerAppConfigContracts(registry: SpecRegistry): SpecRegistry;
+declare const appConfigContracts: Record<string, OperationSpec<any, any>>;
+declare function registerAppConfigContracts(registry: OperationSpecRegistry): OperationSpecRegistry;
 //#endregion
 export { GetResolvedBrandingQuery, ResolveMessageQuery, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantTranslationOverridesCommand, VerifyCustomDomainCommand, appConfigContracts, registerAppConfigContracts };

package/dist/app-config/contracts.js

@@ -1,5 +1,5 @@
 import { E5, x8 } from "../schema/dist/index.js";
-import { defineCommand, defineQuery } from "../spec.js";
+import { defineCommand, defineQuery } from "../operation.js";
 import { OwnersEnum, StabilityEnum, TagsEnum } from "../ownership.js";
 
 //#region src/app-config/contracts.ts

package/dist/app-config/events.d.ts

@@ -1,120 +1,120 @@
 import { EventSpec } from "../events.js";
 import "../index.js";
-import * as _lssm_lib_schema146 from "@lssm/lib.schema";
+import * as _lssm_lib_schema291 from "@lssm/lib.schema";
 import { SchemaModel } from "@lssm/lib.schema";
 
 //#region src/app-config/events.d.ts
 declare const ConfigDraftCreatedEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: false;
   };
   blueprintName: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   blueprintVersion: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: false;
   };
   createdBy: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   clonedFrom: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: true;
   };
 }>>;
 declare const ConfigPromotedToPreviewEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: false;
   };
   promotedBy: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   warnings: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
 }>>;
 declare const ConfigPublishedEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: false;
   };
   previousVersion: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: true;
   };
   publishedBy: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   changeSummary: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: true;
   };
   changedSections: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
 }>>;
 declare const ConfigRolledBackEvent: EventSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   newVersion: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: false;
   };
   rolledBackFrom: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: false;
   };
   rolledBackTo: {
-    type: _lssm_lib_schema146.FieldType<number, number>;
+    type: _lssm_lib_schema291.FieldType<number, number>;
     isOptional: false;
   };
   rolledBackBy: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
   reason: {
-    type: _lssm_lib_schema146.FieldType<string, string>;
+    type: _lssm_lib_schema291.FieldType<string, string>;
     isOptional: false;
   };
 }>>;