@fabricorg/platform 0.10.0 → 0.11.0

package/dist/manifest/index.d.ts

@@ -1,18 +1,24 @@
 import { SchemaValidator, AdapterStepRetryPolicy } from '../actions/index.js';
-import { ModuleDependency, FabricModule } from '../modules/index.js';
+import { CapabilityMetadata, ModuleDependency, ObjectRelationDefinition, DeclarativeInvariant, FabricModule } from '../modules/index.js';
+import { PortableJsonSchema, JsonValue } from '../objects/index.js';
 import { PolicyKind, DataPolicyDefinition, PolicyFallbackDefinition } from '../policies/index.js';
 import { StateDefinition } from '../state-machines/index.js';
 import '../displays/index.js';
+import '../projections/index.js';
 
 /**
  * Version of the module manifest contract. Bump when the serialized shape
  * changes in a way consumers must detect.
  */
-declare const MODULE_MANIFEST_VERSION: 1;
+declare const MODULE_MANIFEST_VERSION: 2;
 interface ModuleManifestObjectType {
     type: string;
     displayName?: string;
     idPrefix?: string;
+    schema?: PortableJsonSchema;
+    semantics?: Record<string, JsonValue>;
+    relations?: ObjectRelationDefinition[];
+    invariants?: DeclarativeInvariant[];
 }
 interface ModuleManifestIdPrefix {
     prefix: string;
@@ -50,6 +56,8 @@ interface ModuleManifestAction {
      */
     parameterSchema?: unknown;
     parameterSchemaFormat?: "json-schema";
+    resultSchema?: unknown;
+    resultSchemaFormat?: "json-schema";
     stateMachine?: ModuleManifestActionStateMachine;
     adapterSteps?: ModuleManifestAdapterStep[];
 }
@@ -82,6 +90,18 @@ interface ModuleManifestStateMachine {
     states: StateDefinition[];
     transitions: ModuleManifestStateMachineTransition[];
 }
+interface ModuleManifestView {
+    name: string;
+    version: string;
+    shape: PortableJsonSchema;
+    consumes: Array<{
+        eventType: string;
+        schemaVersions: number[];
+    }>;
+    scope: "tenant-space";
+    snapshotVersion: number;
+    compatibleSnapshotVersions?: number[];
+}
 /**
  * Stable, JSON-serializable description of a {@link FabricModule}'s ontology:
  * object types, subject types, id prefixes, event types, actions, policies,
@@ -98,6 +118,7 @@ interface ModuleManifest {
     version?: string;
     displayName?: string;
     description?: string;
+    capability?: CapabilityMetadata;
     dependencies: ModuleDependency[];
     objectTypes: ModuleManifestObjectType[];
     subjectTypes: string[];
@@ -106,12 +127,27 @@ interface ModuleManifest {
     actions: ModuleManifestAction[];
     policies: ModuleManifestPolicy[];
     stateMachines: ModuleManifestStateMachine[];
+    views: ModuleManifestView[];
 }
 interface ModuleManifestBundle {
     manifestVersion: typeof MODULE_MANIFEST_VERSION;
     /** Manifests in the input module order. */
     modules: ModuleManifest[];
 }
+/** Manifest v1 remains accepted by v2 readers; missing v2 fields normalize to absence. */
+type ModuleManifestObjectTypeV1 = Omit<ModuleManifestObjectType, "schema" | "semantics" | "relations" | "invariants">;
+type ModuleManifestActionV1 = Omit<ModuleManifestAction, "resultSchema" | "resultSchemaFormat">;
+type ModuleManifestV1 = Omit<ModuleManifest, "manifestVersion" | "objectTypes" | "actions" | "views"> & {
+    manifestVersion: 1;
+    objectTypes: ModuleManifestObjectTypeV1[];
+    actions: ModuleManifestActionV1[];
+};
+type ModuleManifestBundleV1 = Omit<ModuleManifestBundle, "manifestVersion" | "modules"> & {
+    manifestVersion: 1;
+    modules: ModuleManifestV1[];
+};
+declare function normalizeModuleManifest(manifest: ModuleManifest | ModuleManifestV1): ModuleManifest;
+declare function normalizeModuleManifestBundle(bundle: ModuleManifestBundle | ModuleManifestBundleV1): ModuleManifestBundle;
 /**
  * A {@link SchemaValidator} that can also export its parameter schema as JSON
  * Schema (for example a Zod 4 schema via `z.toJSONSchema`). Keeps the platform
@@ -142,4 +178,4 @@ declare function exportModuleManifest(module: FabricModule<unknown>): ModuleMani
  */
 declare function exportModuleManifestBundle(modules: FabricModule<unknown>[]): ModuleManifestBundle;
 
-export { type JsonSchemaExportableValidator, MODULE_MANIFEST_VERSION, type ModuleManifest, type ModuleManifestAction, type ModuleManifestActionStateMachine, type ModuleManifestAdapterStep, type ModuleManifestBundle, type ModuleManifestCodePolicy, type ModuleManifestDataPolicy, type ModuleManifestEventType, type ModuleManifestIdPrefix, type ModuleManifestObjectType, type ModuleManifestPolicy, type ModuleManifestStateMachine, type ModuleManifestStateMachineTransition, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator };
+export { type JsonSchemaExportableValidator, MODULE_MANIFEST_VERSION, type ModuleManifest, type ModuleManifestAction, type ModuleManifestActionStateMachine, type ModuleManifestActionV1, type ModuleManifestAdapterStep, type ModuleManifestBundle, type ModuleManifestBundleV1, type ModuleManifestCodePolicy, type ModuleManifestDataPolicy, type ModuleManifestEventType, type ModuleManifestIdPrefix, type ModuleManifestObjectType, type ModuleManifestObjectTypeV1, type ModuleManifestPolicy, type ModuleManifestStateMachine, type ModuleManifestStateMachineTransition, type ModuleManifestV1, type ModuleManifestView, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle };

package/dist/manifest/index.js

@@ -1,9 +1,10 @@
-export { MODULE_MANIFEST_VERSION, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator } from '../chunk-N72WJ4AU.js';
-import '../chunk-35DD3H55.js';
-import '../chunk-I35B576X.js';
+export { MODULE_MANIFEST_VERSION, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle } from '../chunk-NFP5DJBT.js';
+import '../chunk-3JQI3OFC.js';
+import '../chunk-3S6UTP4X.js';
 import '../chunk-6ER62UUN.js';
+import '../chunk-7WASIL46.js';
 import '../chunk-T2JLSZN6.js';
-import '../chunk-4SMPJPJ6.js';
+import '../chunk-JM55UQWK.js';
 import '../chunk-O5WVBQ7P.js';
 import '../chunk-4YQOGV7H.js';
 //# sourceMappingURL=index.js.map

package/dist/modules/index.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
-var chunkSSYKDXR4_cjs = require('../chunk-SSYKDXR4.cjs');
-require('../chunk-QETQGAXJ.cjs');
+var chunkODP3DO6P_cjs = require('../chunk-ODP3DO6P.cjs');
+require('../chunk-XCL2HBMB.cjs');
 require('../chunk-NJL3US7H.cjs');
+require('../chunk-O7IHZ53Y.cjs');
 require('../chunk-UV252FLT.cjs');
-require('../chunk-BWNPGRRV.cjs');
+require('../chunk-HLRIXNVG.cjs');
 require('../chunk-EO4VSB2O.cjs');
 require('../chunk-JAXDEK5Z.cjs');
 
@@ -12,31 +13,31 @@ require('../chunk-JAXDEK5Z.cjs');
 
 Object.defineProperty(exports, "createModuleRegistry", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.createModuleRegistry; }
+  get: function () { return chunkODP3DO6P_cjs.createModuleRegistry; }
 });
 Object.defineProperty(exports, "getEventTypeName", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.getEventTypeName; }
+  get: function () { return chunkODP3DO6P_cjs.getEventTypeName; }
 });
 Object.defineProperty(exports, "getModuleDependencyNamespace", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.getModuleDependencyNamespace; }
+  get: function () { return chunkODP3DO6P_cjs.getModuleDependencyNamespace; }
 });
 Object.defineProperty(exports, "getObjectTypeName", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.getObjectTypeName; }
+  get: function () { return chunkODP3DO6P_cjs.getObjectTypeName; }
 });
 Object.defineProperty(exports, "registerFabricModule", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.registerFabricModule; }
+  get: function () { return chunkODP3DO6P_cjs.registerFabricModule; }
 });
 Object.defineProperty(exports, "registerFabricModules", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.registerFabricModules; }
+  get: function () { return chunkODP3DO6P_cjs.registerFabricModules; }
 });
 Object.defineProperty(exports, "validateModuleNamespace", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.validateModuleNamespace; }
+  get: function () { return chunkODP3DO6P_cjs.validateModuleNamespace; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/modules/index.d.cts

@@ -1,5 +1,7 @@
 import { ActionDefinition } from '../actions/index.cjs';
 import { DisplayRenderer } from '../displays/index.cjs';
+import { PortableJsonSchema, JsonValue } from '../objects/index.cjs';
+import { ViewContract } from '../projections/index.cjs';
 
 interface ModuleDependency {
     namespace: string;
@@ -23,6 +25,29 @@ interface ObjectTypeRegistration {
     displayName?: string;
     idPrefix?: string;
     isCoreModuleType?: boolean;
+    schema?: PortableJsonSchema;
+    semantics?: Record<string, JsonValue>;
+    relations?: ObjectRelationDefinition[];
+    invariants?: DeclarativeInvariant[];
+}
+type ObjectRelationCardinality = "one" | "many";
+type ObjectRelationSemantics = "reference" | "owned";
+type ObjectRelationDeleteBehavior = "restrict" | "cascade" | "set-null";
+interface ObjectRelationDefinition {
+    name: string;
+    target: `${string}.${string}`;
+    cardinality: ObjectRelationCardinality;
+    required?: boolean;
+    semantics: ObjectRelationSemantics;
+    onTargetDelete: ObjectRelationDeleteBehavior;
+}
+type InvariantEnforcement = "json-schema" | "state-machine" | "policy" | "host-adapter" | "application";
+interface DeclarativeInvariant {
+    id: string;
+    description: string;
+    required?: boolean;
+    enforcement: InvariantEnforcement;
+    enforcementRef?: string;
 }
 type ObjectTypeRegistrationInput = string | ObjectTypeRegistration;
 interface ModuleDisplayRendererRegistration {
@@ -38,11 +63,33 @@ interface StateMachineRegistration {
     entityType: string;
     states: string[];
 }
+interface CapabilitySlotDefinition {
+    name: string;
+    description: string;
+    shape?: PortableJsonSchema;
+}
+interface CapabilityMetadata {
+    displayName: string;
+    description: string;
+    roles?: string[];
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    deprecated?: {
+        since: string;
+        replacement?: string;
+        message: string;
+    };
+    slots?: CapabilitySlotDefinition[];
+    certification?: {
+        profile: string;
+        required: boolean;
+    };
+}
 interface FabricModule<TDb = unknown> {
     namespace: string;
     version?: string;
     displayName?: string;
     description?: string;
+    capability?: CapabilityMetadata;
     dependencies?: ModuleDependencyInput[];
     objectTypes?: ObjectTypeRegistrationInput[];
     subjectTypes?: string[];
@@ -59,6 +106,7 @@ interface FabricModule<TDb = unknown> {
     dataClassifications?: unknown[];
     retentionRules?: unknown[];
     evidenceRenderers?: unknown[];
+    views?: ViewContract[];
 }
 interface ModuleRegistry<TDb = unknown> {
     modules: ReadonlyMap<string, FabricModule<TDb>>;
@@ -71,4 +119,4 @@ declare function createModuleRegistry<TDb = unknown>(modules?: FabricModule<TDb>
 declare function registerFabricModule(module: FabricModule<unknown>): void;
 declare function registerFabricModules(modules: FabricModule<unknown>[]): FabricModule<unknown>[];
 
-export { type EventTypeRegistration, type EventTypeRegistrationInput, type FabricModule, type IdPrefixRegistration, type ModuleDependency, type ModuleDependencyInput, type ModuleDisplayRendererRegistration, type ModuleRegistry, type ObjectTypeRegistration, type ObjectTypeRegistrationInput, type PolicyRegistration, type StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace };
+export { type CapabilityMetadata, type CapabilitySlotDefinition, type DeclarativeInvariant, type EventTypeRegistration, type EventTypeRegistrationInput, type FabricModule, type IdPrefixRegistration, type InvariantEnforcement, type ModuleDependency, type ModuleDependencyInput, type ModuleDisplayRendererRegistration, type ModuleRegistry, type ObjectRelationCardinality, type ObjectRelationDefinition, type ObjectRelationDeleteBehavior, type ObjectRelationSemantics, type ObjectTypeRegistration, type ObjectTypeRegistrationInput, type PolicyRegistration, type StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace };

package/dist/modules/index.d.ts

@@ -1,5 +1,7 @@
 import { ActionDefinition } from '../actions/index.js';
 import { DisplayRenderer } from '../displays/index.js';
+import { PortableJsonSchema, JsonValue } from '../objects/index.js';
+import { ViewContract } from '../projections/index.js';
 
 interface ModuleDependency {
     namespace: string;
@@ -23,6 +25,29 @@ interface ObjectTypeRegistration {
     displayName?: string;
     idPrefix?: string;
     isCoreModuleType?: boolean;
+    schema?: PortableJsonSchema;
+    semantics?: Record<string, JsonValue>;
+    relations?: ObjectRelationDefinition[];
+    invariants?: DeclarativeInvariant[];
+}
+type ObjectRelationCardinality = "one" | "many";
+type ObjectRelationSemantics = "reference" | "owned";
+type ObjectRelationDeleteBehavior = "restrict" | "cascade" | "set-null";
+interface ObjectRelationDefinition {
+    name: string;
+    target: `${string}.${string}`;
+    cardinality: ObjectRelationCardinality;
+    required?: boolean;
+    semantics: ObjectRelationSemantics;
+    onTargetDelete: ObjectRelationDeleteBehavior;
+}
+type InvariantEnforcement = "json-schema" | "state-machine" | "policy" | "host-adapter" | "application";
+interface DeclarativeInvariant {
+    id: string;
+    description: string;
+    required?: boolean;
+    enforcement: InvariantEnforcement;
+    enforcementRef?: string;
 }
 type ObjectTypeRegistrationInput = string | ObjectTypeRegistration;
 interface ModuleDisplayRendererRegistration {
@@ -38,11 +63,33 @@ interface StateMachineRegistration {
     entityType: string;
     states: string[];
 }
+interface CapabilitySlotDefinition {
+    name: string;
+    description: string;
+    shape?: PortableJsonSchema;
+}
+interface CapabilityMetadata {
+    displayName: string;
+    description: string;
+    roles?: string[];
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    deprecated?: {
+        since: string;
+        replacement?: string;
+        message: string;
+    };
+    slots?: CapabilitySlotDefinition[];
+    certification?: {
+        profile: string;
+        required: boolean;
+    };
+}
 interface FabricModule<TDb = unknown> {
     namespace: string;
     version?: string;
     displayName?: string;
     description?: string;
+    capability?: CapabilityMetadata;
     dependencies?: ModuleDependencyInput[];
     objectTypes?: ObjectTypeRegistrationInput[];
     subjectTypes?: string[];
@@ -59,6 +106,7 @@ interface FabricModule<TDb = unknown> {
     dataClassifications?: unknown[];
     retentionRules?: unknown[];
     evidenceRenderers?: unknown[];
+    views?: ViewContract[];
 }
 interface ModuleRegistry<TDb = unknown> {
     modules: ReadonlyMap<string, FabricModule<TDb>>;
@@ -71,4 +119,4 @@ declare function createModuleRegistry<TDb = unknown>(modules?: FabricModule<TDb>
 declare function registerFabricModule(module: FabricModule<unknown>): void;
 declare function registerFabricModules(modules: FabricModule<unknown>[]): FabricModule<unknown>[];
 
-export { type EventTypeRegistration, type EventTypeRegistrationInput, type FabricModule, type IdPrefixRegistration, type ModuleDependency, type ModuleDependencyInput, type ModuleDisplayRendererRegistration, type ModuleRegistry, type ObjectTypeRegistration, type ObjectTypeRegistrationInput, type PolicyRegistration, type StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace };
+export { type CapabilityMetadata, type CapabilitySlotDefinition, type DeclarativeInvariant, type EventTypeRegistration, type EventTypeRegistrationInput, type FabricModule, type IdPrefixRegistration, type InvariantEnforcement, type ModuleDependency, type ModuleDependencyInput, type ModuleDisplayRendererRegistration, type ModuleRegistry, type ObjectRelationCardinality, type ObjectRelationDefinition, type ObjectRelationDeleteBehavior, type ObjectRelationSemantics, type ObjectTypeRegistration, type ObjectTypeRegistrationInput, type PolicyRegistration, type StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace };

package/dist/modules/index.js

@@ -1,8 +1,9 @@
-export { createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from '../chunk-35DD3H55.js';
-import '../chunk-I35B576X.js';
+export { createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from '../chunk-3JQI3OFC.js';
+import '../chunk-3S6UTP4X.js';
 import '../chunk-6ER62UUN.js';
+import '../chunk-7WASIL46.js';
 import '../chunk-T2JLSZN6.js';
-import '../chunk-4SMPJPJ6.js';
+import '../chunk-JM55UQWK.js';
 import '../chunk-O5WVBQ7P.js';
 import '../chunk-4YQOGV7H.js';
 //# sourceMappingURL=index.js.map

package/dist/objects/index.cjs

@@ -1,24 +1,28 @@
 'use strict';
 
-var chunkQETQGAXJ_cjs = require('../chunk-QETQGAXJ.cjs');
+var chunkXCL2HBMB_cjs = require('../chunk-XCL2HBMB.cjs');
 
 
 
 Object.defineProperty(exports, "assertObjectType", {
   enumerable: true,
-  get: function () { return chunkQETQGAXJ_cjs.assertObjectType; }
+  get: function () { return chunkXCL2HBMB_cjs.assertObjectType; }
+});
+Object.defineProperty(exports, "assertPortableJsonSchema", {
+  enumerable: true,
+  get: function () { return chunkXCL2HBMB_cjs.assertPortableJsonSchema; }
 });
 Object.defineProperty(exports, "getRegisteredObjectTypes", {
   enumerable: true,
-  get: function () { return chunkQETQGAXJ_cjs.getRegisteredObjectTypes; }
+  get: function () { return chunkXCL2HBMB_cjs.getRegisteredObjectTypes; }
 });
 Object.defineProperty(exports, "isValidObjectType", {
   enumerable: true,
-  get: function () { return chunkQETQGAXJ_cjs.isValidObjectType; }
+  get: function () { return chunkXCL2HBMB_cjs.isValidObjectType; }
 });
 Object.defineProperty(exports, "registerObjectType", {
   enumerable: true,
-  get: function () { return chunkQETQGAXJ_cjs.registerObjectType; }
+  get: function () { return chunkXCL2HBMB_cjs.registerObjectType; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/objects/index.d.cts

@@ -1,7 +1,51 @@
 type FabricObjectType = string;
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Dependency-free JSON Schema profile accepted in portable module manifests.
+ * Unknown extension keywords must use an `x-` prefix. Runtime validators may
+ * support more vocabulary, but exported entity contracts stay in this profile.
+ */
+interface PortableJsonSchema {
+    $schema?: string;
+    $id?: string;
+    $ref?: string;
+    $defs?: Record<string, PortableJsonSchema>;
+    title?: string;
+    description?: string;
+    type?: "null" | "boolean" | "object" | "array" | "number" | "integer" | "string" | Array<"null" | "boolean" | "object" | "array" | "number" | "integer" | "string">;
+    enum?: JsonValue[];
+    const?: JsonValue;
+    properties?: Record<string, PortableJsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean | PortableJsonSchema;
+    items?: PortableJsonSchema | PortableJsonSchema[];
+    allOf?: PortableJsonSchema[];
+    anyOf?: PortableJsonSchema[];
+    oneOf?: PortableJsonSchema[];
+    not?: PortableJsonSchema;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    default?: JsonValue;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    [key: `x-${string}`]: JsonValue | undefined;
+}
+declare function assertPortableJsonSchema(schema: unknown, path?: string): asserts schema is PortableJsonSchema;
 declare function assertObjectType(type: string): asserts type is FabricObjectType;
 declare function registerObjectType(type: string): void;
 declare function isValidObjectType(type: string): boolean;
 declare function getRegisteredObjectTypes(): string[];
 
-export { type FabricObjectType, assertObjectType, getRegisteredObjectTypes, isValidObjectType, registerObjectType };
+export { type FabricObjectType, type JsonPrimitive, type JsonValue, type PortableJsonSchema, assertObjectType, assertPortableJsonSchema, getRegisteredObjectTypes, isValidObjectType, registerObjectType };

package/dist/objects/index.d.ts

@@ -1,7 +1,51 @@
 type FabricObjectType = string;
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Dependency-free JSON Schema profile accepted in portable module manifests.
+ * Unknown extension keywords must use an `x-` prefix. Runtime validators may
+ * support more vocabulary, but exported entity contracts stay in this profile.
+ */
+interface PortableJsonSchema {
+    $schema?: string;
+    $id?: string;
+    $ref?: string;
+    $defs?: Record<string, PortableJsonSchema>;
+    title?: string;
+    description?: string;
+    type?: "null" | "boolean" | "object" | "array" | "number" | "integer" | "string" | Array<"null" | "boolean" | "object" | "array" | "number" | "integer" | "string">;
+    enum?: JsonValue[];
+    const?: JsonValue;
+    properties?: Record<string, PortableJsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean | PortableJsonSchema;
+    items?: PortableJsonSchema | PortableJsonSchema[];
+    allOf?: PortableJsonSchema[];
+    anyOf?: PortableJsonSchema[];
+    oneOf?: PortableJsonSchema[];
+    not?: PortableJsonSchema;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    default?: JsonValue;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    [key: `x-${string}`]: JsonValue | undefined;
+}
+declare function assertPortableJsonSchema(schema: unknown, path?: string): asserts schema is PortableJsonSchema;
 declare function assertObjectType(type: string): asserts type is FabricObjectType;
 declare function registerObjectType(type: string): void;
 declare function isValidObjectType(type: string): boolean;
 declare function getRegisteredObjectTypes(): string[];
 
-export { type FabricObjectType, assertObjectType, getRegisteredObjectTypes, isValidObjectType, registerObjectType };
+export { type FabricObjectType, type JsonPrimitive, type JsonValue, type PortableJsonSchema, assertObjectType, assertPortableJsonSchema, getRegisteredObjectTypes, isValidObjectType, registerObjectType };

package/dist/objects/index.js

@@ -1,3 +1,3 @@
-export { assertObjectType, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from '../chunk-I35B576X.js';
+export { assertObjectType, assertPortableJsonSchema, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from '../chunk-3S6UTP4X.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/projections/index.cjs

@@ -1,12 +1,36 @@
 'use strict';
 
-var chunkQ3WYIWCN_cjs = require('../chunk-Q3WYIWCN.cjs');
+var chunkO7IHZ53Y_cjs = require('../chunk-O7IHZ53Y.cjs');
 
 
 
+Object.defineProperty(exports, "getRegisteredViewContractKeys", {
+  enumerable: true,
+  get: function () { return chunkO7IHZ53Y_cjs.getRegisteredViewContractKeys; }
+});
+Object.defineProperty(exports, "registerViewContract", {
+  enumerable: true,
+  get: function () { return chunkO7IHZ53Y_cjs.registerViewContract; }
+});
+Object.defineProperty(exports, "registerViewContractIfMissing", {
+  enumerable: true,
+  get: function () { return chunkO7IHZ53Y_cjs.registerViewContractIfMissing; }
+});
 Object.defineProperty(exports, "replayEvents", {
   enumerable: true,
-  get: function () { return chunkQ3WYIWCN_cjs.replayEvents; }
+  get: function () { return chunkO7IHZ53Y_cjs.replayEvents; }
+});
+Object.defineProperty(exports, "replayView", {
+  enumerable: true,
+  get: function () { return chunkO7IHZ53Y_cjs.replayView; }
+});
+Object.defineProperty(exports, "resolveViewContract", {
+  enumerable: true,
+  get: function () { return chunkO7IHZ53Y_cjs.resolveViewContract; }
+});
+Object.defineProperty(exports, "viewContractKey", {
+  enumerable: true,
+  get: function () { return chunkO7IHZ53Y_cjs.viewContractKey; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/projections/index.d.cts

@@ -1,8 +1,11 @@
+import { PortableJsonSchema } from '../objects/index.cjs';
+
 interface ReplayableAssetEvent<Payload = unknown> {
     id: string;
     tenantId: string;
     spaceId: string;
     eventType: string;
+    eventSchemaVersion?: number;
     subjectType: string;
     subjectId: string;
     payload: Payload;
@@ -12,6 +15,39 @@ interface ReplayableAssetEvent<Payload = unknown> {
     actionInvocationId: string;
     correlationId: string;
 }
+
+interface ViewEventConsumption {
+    eventType: string;
+    schemaVersions: number[];
+}
+interface ViewContract<State = unknown, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {
+    /** Stable module-qualified logical identity, for example `orders/summary`. */
+    name: `${string}/${string}`;
+    version: string;
+    shape: PortableJsonSchema;
+    consumes: ViewEventConsumption[];
+    scope: "tenant-space";
+    snapshotVersion: number;
+    compatibleSnapshotVersions?: number[];
+    /** Required to transform any older compatible snapshot into the current state shape. */
+    upgradeSnapshot?: (data: unknown, fromVersion: number) => State | Promise<State>;
+    initialState: State;
+    applyEvent: (state: State, event: Event) => State | Promise<State>;
+}
+declare function viewContractKey(view: Pick<ViewContract, "name" | "version">): string;
+declare function registerViewContract(view: ViewContract): void;
+declare function registerViewContractIfMissing(view: ViewContract): void;
+declare function resolveViewContract(name: string, version: string): ViewContract | undefined;
+declare function getRegisteredViewContractKeys(): string[];
+interface ReplayViewOptions<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {
+    view: ViewContract<State, Event>;
+    events: Iterable<Event> | AsyncIterable<Event>;
+    scope: ReplayScope;
+    snapshot?: (ReplaySnapshot<State> & {
+        snapshotVersion: number;
+    }) | null;
+}
+declare function replayView<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent>({ view, events, scope, snapshot, }: ReplayViewOptions<State, Event>): Promise<ReplayEventsResult<State, Event>>;
 interface ReplayScope {
     tenantId: string;
     spaceId: string;
@@ -23,7 +59,7 @@ interface ReplaySnapshot<State = unknown> {
     eventCursor?: string | null;
     eventSequence?: number | null;
 }
-type ReplayWarningCode = "cursor_not_found" | "duplicate_event" | "missing_sequence" | "subject_scope_incomplete";
+type ReplayWarningCode = "cursor_not_found" | "duplicate_event" | "missing_sequence" | "subject_scope_incomplete" | "unsupported_event_version";
 interface ReplayWarning {
     code: ReplayWarningCode;
     message: string;
@@ -49,4 +85,4 @@ interface ReplayEventsResult<State, Event extends ReplayableAssetEvent = Replaya
 }
 declare function replayEvents<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent>({ events, scope, initialState, snapshot, applyEvent, }: ReplayEventsOptions<State, Event>): Promise<ReplayEventsResult<State, Event>>;
 
-export { type ReplayEventsOptions, type ReplayEventsResult, type ReplayScope, type ReplaySnapshot, type ReplayWarning, type ReplayWarningCode, type ReplayableAssetEvent, replayEvents };
+export { type ReplayEventsOptions, type ReplayEventsResult, type ReplayScope, type ReplaySnapshot, type ReplayViewOptions, type ReplayWarning, type ReplayWarningCode, type ReplayableAssetEvent, type ViewContract, type ViewEventConsumption, getRegisteredViewContractKeys, registerViewContract, registerViewContractIfMissing, replayEvents, replayView, resolveViewContract, viewContractKey };