@relkit/contracts 0.1.0 → 0.2.0

package/dist/activation.d.ts

@@ -0,0 +1,10 @@
+export declare const RUNTIME_ACTIVATION_FILE: "runtime-activation.json";
+export interface RuntimeActivationFingerprint {
+    readonly graphHash: string;
+    readonly manifestHash: string;
+    readonly runtimeIntegrationsPlanHash: string;
+    readonly localServicesPlanHash?: string;
+    readonly providerOverridesGeneration?: string;
+}
+export declare function isRuntimeActivationFingerprint(value: unknown): value is RuntimeActivationFingerprint;
+//# sourceMappingURL=activation.d.ts.map

package/dist/activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.d.ts","sourceRoot":"","sources":["../src/activation.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,EAAG,yBAAkC,CAAC;AAE1E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CAC/C;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CAUvC"}

package/dist/activation.js

@@ -0,0 +1,15 @@
+export const RUNTIME_ACTIVATION_FILE = "runtime-activation.json";
+export function isRuntimeActivationFingerprint(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const record = value;
+    return (text(record.graphHash) &&
+        text(record.manifestHash) &&
+        text(record.runtimeIntegrationsPlanHash) &&
+        (record.localServicesPlanHash === undefined || text(record.localServicesPlanHash)) &&
+        (record.providerOverridesGeneration === undefined || text(record.providerOverridesGeneration)));
+}
+function text(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+//# sourceMappingURL=activation.js.map

package/dist/activation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.js","sourceRoot":"","sources":["../src/activation.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAkC,CAAC;AAU1E,MAAM,UAAU,8BAA8B,CAC5C,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,CACL,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC;QACxC,CAAC,MAAM,CAAC,qBAAqB,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAClF,CAAC,MAAM,CAAC,2BAA2B,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAC/F,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -3,4 +3,6 @@ export * from "./descriptor.js";
 export * from "./json.js";
 export * from "./source-location.js";
 export * from "./version.js";
+export * from "./runtime-integration.js";
+export * from "./activation.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -3,4 +3,6 @@ export * from "./descriptor.js";
 export * from "./json.js";
 export * from "./source-location.js";
 export * from "./version.js";
+export * from "./runtime-integration.js";
+export * from "./activation.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/dist/runtime-integration.d.ts

@@ -0,0 +1,37 @@
+export declare const RUNTIME_INTEGRATION_PLAN_VERSION: 1;
+export declare const RUNTIME_INTEGRATION_PLAN_FILE: "runtime-integrations.plan.json";
+export interface RuntimeIntegrationPlanReference {
+    readonly version: typeof RUNTIME_INTEGRATION_PLAN_VERSION;
+    readonly fileName: typeof RUNTIME_INTEGRATION_PLAN_FILE;
+    readonly graphHash: string;
+}
+export interface RuntimeIntegrationRegistrationMetadata {
+    readonly capability: string;
+    readonly adapterId: string;
+    readonly protocolVersion: number;
+}
+export interface RuntimeIntegrationModuleMetadata {
+    readonly kind: "runtime-integration";
+    readonly integrationId: string;
+    readonly registrations: readonly RuntimeIntegrationRegistrationMetadata[];
+}
+export interface RuntimeIntegrationPlanEntry {
+    readonly integrationId: string;
+    readonly capability: string;
+    readonly adapterId: string;
+    readonly protocolVersion: number;
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly exportName: string;
+}
+export interface RuntimeIntegrationPlan {
+    readonly version: typeof RUNTIME_INTEGRATION_PLAN_VERSION;
+    readonly graphHash: string;
+    readonly integrations: readonly RuntimeIntegrationPlanEntry[];
+}
+export declare class RuntimeIntegrationPlanVersionError extends TypeError {
+    readonly code: "RELKIT_RUNTIME_INTEGRATION_PLAN_VERSION_UNSUPPORTED";
+    constructor(version: unknown);
+}
+export declare function assertRuntimeIntegrationPlanVersion(value: unknown): asserts value is RuntimeIntegrationPlan;
+//# sourceMappingURL=runtime-integration.d.ts.map

package/dist/runtime-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-integration.d.ts","sourceRoot":"","sources":["../src/runtime-integration.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAC3D,eAAO,MAAM,6BAA6B,EAAG,gCAAyC,CAAC;AAEvF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,gCAAgC,CAAC;IAC1D,QAAQ,CAAC,QAAQ,EAAE,OAAO,6BAA6B,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,SAAS,sCAAsC,EAAE,CAAC;CAC3E;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,gCAAgC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC/D;AAED,qBAAa,kCAAmC,SAAQ,SAAS;IAC/D,QAAQ,CAAC,IAAI,EAAG,qDAAqD,CAAU;gBAEnE,OAAO,EAAE,OAAO;CAM7B;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,sBAAsB,CAGzC"}

package/dist/runtime-integration.js

@@ -0,0 +1,17 @@
+export const RUNTIME_INTEGRATION_PLAN_VERSION = 1;
+export const RUNTIME_INTEGRATION_PLAN_FILE = "runtime-integrations.plan.json";
+export class RuntimeIntegrationPlanVersionError extends TypeError {
+    code = "RELKIT_RUNTIME_INTEGRATION_PLAN_VERSION_UNSUPPORTED";
+    constructor(version) {
+        super(`Runtime-integration plan version ${String(version)} is unsupported; expected ${RUNTIME_INTEGRATION_PLAN_VERSION}. Regenerate with \`relkit check\`.`);
+        this.name = "RuntimeIntegrationPlanVersionError";
+    }
+}
+export function assertRuntimeIntegrationPlanVersion(value) {
+    if (!isRecord(value) || value.version !== RUNTIME_INTEGRATION_PLAN_VERSION)
+        throw new RuntimeIntegrationPlanVersionError(isRecord(value) ? value.version : undefined);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-integration.js.map

package/dist/runtime-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-integration.js","sourceRoot":"","sources":["../src/runtime-integration.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAU,CAAC;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,gCAAyC,CAAC;AAoCvF,MAAM,OAAO,kCAAmC,SAAQ,SAAS;IACtD,IAAI,GAAG,qDAA8D,CAAC;IAE/E,YAAY,OAAgB;QAC1B,KAAK,CACH,oCAAoC,MAAM,CAAC,OAAO,CAAC,6BAA6B,gCAAgC,qCAAqC,CACtJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,UAAU,mCAAmC,CACjD,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,gCAAgC;QACxE,MAAM,IAAI,kCAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/version.d.ts

@@ -1,11 +1,11 @@
 /** Current version of the public contract payloads. */
-export declare const CONTRACT_VERSION: 4;
+export declare const CONTRACT_VERSION: 5;
 /** Current version of generated RelKit artifacts. */
-export declare const GENERATOR_VERSION: 4;
+export declare const GENERATOR_VERSION: 5;
 /** Current version of the canonical application graph. */
-export declare const GRAPH_VERSION: 7;
+export declare const GRAPH_VERSION: 8;
 /** Current version of the executable runtime manifest. */
-export declare const MANIFEST_VERSION: 7;
+export declare const MANIFEST_VERSION: 8;
 /** Current version of the internal inspector/API protocol. */
 export declare const API_VERSION: 1;
 /** Shared protocol version used by versioned internal contracts. */

package/dist/version.js

@@ -1,11 +1,11 @@
 /** Current version of the public contract payloads. */
-export const CONTRACT_VERSION = 4;
+export const CONTRACT_VERSION = 5;
 /** Current version of generated RelKit artifacts. */
-export const GENERATOR_VERSION = 4;
+export const GENERATOR_VERSION = 5;
 /** Current version of the canonical application graph. */
-export const GRAPH_VERSION = 7;
+export const GRAPH_VERSION = 8;
 /** Current version of the executable runtime manifest. */
-export const MANIFEST_VERSION = 7;
+export const MANIFEST_VERSION = 8;
 /** Current version of the internal inspector/API protocol. */
 export const API_VERSION = 1;
 /** Shared protocol version used by versioned internal contracts. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relkit/contracts",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Unsupported internal RELKIT contracts; use @relkit/app.",
   "license": "MIT",
   "repository": {