@xemahq/contracts 0.78.0 → 0.80.0

package/dist/setting/lib/setting-value.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingValueSchema = settingValueSchema;
+exports.settingAtRestValueSchema = settingAtRestValueSchema;
+const zod_1 = require("zod");
+const setting_duration_1 = require("./setting-duration");
+const setting_enums_1 = require("./setting-enums");
+function atRestSchema(shape) {
+    switch (shape.valueType) {
+        case setting_enums_1.SettingValueType.Boolean:
+            return zod_1.z.boolean();
+        case setting_enums_1.SettingValueType.Integer:
+            return zod_1.z
+                .number()
+                .int()
+                .min(shape.constraints.min)
+                .max(shape.constraints.max);
+        case setting_enums_1.SettingValueType.Duration:
+            return zod_1.z
+                .number()
+                .int()
+                .min(shape.constraints.minSeconds)
+                .max(shape.constraints.maxSeconds);
+        case setting_enums_1.SettingValueType.Enum:
+            return zod_1.z.enum(shape.constraints.values);
+    }
+}
+function settingValueSchema(shape) {
+    const rest = atRestSchema(shape);
+    if (shape.valueType !== setting_enums_1.SettingValueType.Duration)
+        return rest;
+    return zod_1.z.string().transform((raw, ctx) => {
+        let seconds;
+        try {
+            seconds = (0, setting_duration_1.parseIsoDurationSeconds)(raw);
+        }
+        catch (error) {
+            ctx.addIssue({
+                code: "custom",
+                message: error instanceof Error ? error.message : String(error),
+            });
+            return zod_1.z.NEVER;
+        }
+        const checked = rest.safeParse(seconds);
+        if (!checked.success) {
+            for (const issue of checked.error.issues) {
+                ctx.addIssue({ code: "custom", message: issue.message });
+            }
+            return zod_1.z.NEVER;
+        }
+        return checked.data;
+    });
+}
+function settingAtRestValueSchema(shape) {
+    return atRestSchema(shape);
+}
+//# sourceMappingURL=setting-value.js.map

package/dist/setting/lib/setting-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-value.js","sourceRoot":"","sources":["../../../src/setting/lib/setting-value.ts"],"names":[],"mappings":";;AAgCA,gDAyBC;AAGD,4DAIC;AAhED,6BAAwB;AAGxB,yDAA6D;AAC7D,mDAAmD;AAEnD,SAAS,YAAY,CAAC,KAAwB;IAC5C,QAAQ,KAAK,CAAC,SAAS,EAAE,CAAC;QACxB,KAAK,gCAAgB,CAAC,OAAO;YAC3B,OAAO,OAAC,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,gCAAgB,CAAC,OAAO;YAC3B,OAAO,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC;iBAC1B,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,KAAK,gCAAgB,CAAC,QAAQ;YAC5B,OAAO,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC;iBACjC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACvC,KAAK,gCAAgB,CAAC,IAAI;YACxB,OAAO,OAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAA+B,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAOD,SAAgB,kBAAkB,CAChC,KAAwB;IAExB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,SAAS,KAAK,gCAAgB,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,OAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,GAAG,EAAgB,EAAE;QACrD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,IAAA,0CAAuB,EAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC,CAAC;YACH,OAAO,OAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACzC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,OAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAGD,SAAgB,wBAAwB,CACtC,KAAwB;IAExB,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/space/index.d.ts

@@ -2,7 +2,6 @@ export * from './lib/space';
 export * from './lib/space-classification';
 export * from './lib/space-kind-rank';
 export * from './lib/scoped-resolution';
-export * from './lib/scoped-setting';
 export * from './lib/space-promotion';
 export * from './lib/space-ref-parser';
 export * from './lib/space-traversal';

package/dist/space/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC"}

package/dist/space/index.js

@@ -18,7 +18,6 @@ __exportStar(require("./lib/space"), exports);
 __exportStar(require("./lib/space-classification"), exports);
 __exportStar(require("./lib/space-kind-rank"), exports);
 __exportStar(require("./lib/scoped-resolution"), exports);
-__exportStar(require("./lib/scoped-setting"), exports);
 __exportStar(require("./lib/space-promotion"), exports);
 __exportStar(require("./lib/space-ref-parser"), exports);
 __exportStar(require("./lib/space-traversal"), exports);

package/dist/space/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6DAA2C;AAC3C,wDAAsC;AACtC,0DAAwC;AACxC,uDAAqC;AACrC,wDAAsC;AACtC,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,+DAA6C;AAC7C,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6DAA2C;AAC3C,wDAAsC;AACtC,0DAAwC;AACxC,wDAAsC;AACtC,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,+DAA6C;AAC7C,+DAA6C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/contracts",
-  "version": "0.78.0",
+  "version": "0.80.0",
   "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework deps; the one runtime dependency beside zod is the OpenFGA syntax transformer the authorization-module composer runs.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
@@ -57,6 +57,6 @@
     "test:authorization-models": "node scripts/run-authorization-model-tests.mjs"
   },
   "xemaRelease": {
-    "sourceDigest": "sha256:7c6b46b0b32470856b45199af7e3d110773a36d40704f75e1ce6c54354df3bb2"
+    "sourceDigest": "sha256:ebee17c030a9827de65387fb09c0a263f2a8f0f15db517501c8bd6bcbc88807c"
   }
 }

package/dist/space/lib/scoped-setting.d.ts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import { type ScopedResolution } from './scoped-resolution';
-import { SpaceKind } from './space';
-export declare const SCOPED_SETTING_KEY_PATTERN: RegExp;
-export declare const ScopedSettingKeySchema: z.ZodString;
-export declare enum ScopedSettingOwnership {
-    OrgOnly = "org-only",
-    ProjectOverridable = "project-overridable",
-    ProjectOnly = "project-only",
-    Other = "other"
-}
-export interface ScopedSettingDefinition<TValue = unknown> {
-    readonly key: string;
-    readonly schema: z.ZodType<TValue>;
-    readonly declarableAt: readonly SpaceKind[];
-}
-export declare const ScopedSettingDefinitionSchema: z.ZodObject<{
-    key: z.ZodString;
-    declarableAt: z.ZodArray<z.ZodEnum<typeof SpaceKind>>;
-}, z.core.$strict>;
-export declare function mayDeclareAt(definition: Pick<ScopedSettingDefinition, 'declarableAt'>, tier: SpaceKind): boolean;
-export declare function scopedSettingOwnership(definition: Pick<ScopedSettingDefinition, 'declarableAt'>): ScopedSettingOwnership;
-export interface ScopedSettingDeclaration<TValue = unknown> {
-    readonly ownerSpaceKind: SpaceKind;
-    readonly value: TValue;
-}
-export declare function resolveScopedSetting<TValue>(definition: Pick<ScopedSettingDefinition<TValue>, 'declarableAt'>, declarations: readonly ScopedSettingDeclaration<TValue>[]): ScopedResolution<TValue> | undefined;
-//# sourceMappingURL=scoped-setting.d.ts.map

package/dist/space/lib/scoped-setting.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scoped-setting.d.ts","sourceRoot":"","sources":["../../../src/space/lib/scoped-setting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAmB,MAAM,SAAS,CAAC;AA8DrD,eAAO,MAAM,0BAA0B,QACK,CAAC;AAE7C,eAAO,MAAM,sBAAsB,aAKhC,CAAC;AAGJ,oBAAY,sBAAsB;IAChC,OAAO,aAAa;IACpB,kBAAkB,wBAAwB;IAC1C,WAAW,iBAAiB;IAE5B,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAKnC,QAAQ,CAAC,YAAY,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7C;AAED,eAAO,MAAM,6BAA6B;;;kBAW/B,CAAC;AASZ,wBAAgB,YAAY,CAC1B,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,cAAc,CAAC,EACzD,IAAI,EAAE,SAAS,GACd,OAAO,CAET;AASD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,cAAc,CAAC,GACxD,sBAAsB,CAUxB;AAGD,MAAM,WAAW,wBAAwB,CAAC,MAAM,GAAG,OAAO;IACxD,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAWD,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,UAAU,EAAE,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,EACjE,YAAY,EAAE,SAAS,wBAAwB,CAAC,MAAM,CAAC,EAAE,GACxD,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,CAuBtC"}

package/dist/space/lib/scoped-setting.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScopedSettingDefinitionSchema = exports.ScopedSettingOwnership = exports.ScopedSettingKeySchema = exports.SCOPED_SETTING_KEY_PATTERN = void 0;
-exports.mayDeclareAt = mayDeclareAt;
-exports.scopedSettingOwnership = scopedSettingOwnership;
-exports.resolveScopedSetting = resolveScopedSetting;
-const zod_1 = require("zod");
-const scoped_resolution_1 = require("./scoped-resolution");
-const space_1 = require("./space");
-const space_kind_rank_1 = require("./space-kind-rank");
-exports.SCOPED_SETTING_KEY_PATTERN = /^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)+$/u;
-exports.ScopedSettingKeySchema = zod_1.z
-    .string()
-    .regex(exports.SCOPED_SETTING_KEY_PATTERN, 'A setting key is dotted lower-kebab, e.g. "xema.llm.default-strategy".');
-var ScopedSettingOwnership;
-(function (ScopedSettingOwnership) {
-    ScopedSettingOwnership["OrgOnly"] = "org-only";
-    ScopedSettingOwnership["ProjectOverridable"] = "project-overridable";
-    ScopedSettingOwnership["ProjectOnly"] = "project-only";
-    ScopedSettingOwnership["Other"] = "other";
-})(ScopedSettingOwnership || (exports.ScopedSettingOwnership = ScopedSettingOwnership = {}));
-exports.ScopedSettingDefinitionSchema = zod_1.z
-    .object({
-    key: exports.ScopedSettingKeySchema,
-    declarableAt: zod_1.z
-        .array(space_1.SpaceKindSchema)
-        .min(1, 'A scoped setting must be declarable somewhere.')
-        .refine((kinds) => new Set(kinds).size === kinds.length, 'A tier may appear at most once in `declarableAt`.'),
-})
-    .strict();
-function mayDeclareAt(definition, tier) {
-    return definition.declarableAt.includes(tier);
-}
-function scopedSettingOwnership(definition) {
-    const tiers = new Set(definition.declarableAt);
-    const org = tiers.has(space_1.SpaceKind.Org);
-    const project = tiers.has(space_1.SpaceKind.Project);
-    if (tiers.size === 1 && org)
-        return ScopedSettingOwnership.OrgOnly;
-    if (tiers.size === 1 && project)
-        return ScopedSettingOwnership.ProjectOnly;
-    if (tiers.size === 2 && org && project) {
-        return ScopedSettingOwnership.ProjectOverridable;
-    }
-    return ScopedSettingOwnership.Other;
-}
-function resolveScopedSetting(definition, declarations) {
-    for (const declaration of declarations) {
-        if (!mayDeclareAt(definition, declaration.ownerSpaceKind)) {
-            throw new Error(`A value was declared at "${declaration.ownerSpaceKind}", which this ` +
-                `setting does not admit (declarable at: ${definition.declarableAt.join(', ')}).`);
-        }
-        (0, space_kind_rank_1.spaceKindRank)(declaration.ownerSpaceKind);
-    }
-    return (0, scoped_resolution_1.resolveScopedCandidate)(declarations.map((declaration) => ({
-        ownerSpaceKind: declaration.ownerSpaceKind,
-        value: declaration.value,
-    })), () => 0);
-}
-//# sourceMappingURL=scoped-setting.js.map

package/dist/space/lib/scoped-setting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scoped-setting.js","sourceRoot":"","sources":["../../../src/space/lib/scoped-setting.ts"],"names":[],"mappings":";;;AAmHA,oCAKC;AASD,wDAYC;AAiBD,oDA0BC;AAxLD,6BAAwB;AAExB,2DAAoF;AACpF,mCAAqD;AACrD,uDAAkD;AA6DrC,QAAA,0BAA0B,GACrC,0CAA0C,CAAC;AAEhC,QAAA,sBAAsB,GAAG,OAAC;KACpC,MAAM,EAAE;KACR,KAAK,CACJ,kCAA0B,EAC1B,wEAAwE,CACzE,CAAC;AAGJ,IAAY,sBAMX;AAND,WAAY,sBAAsB;IAChC,8CAAoB,CAAA;IACpB,oEAA0C,CAAA;IAC1C,sDAA4B,CAAA;IAE5B,yCAAe,CAAA;AACjB,CAAC,EANW,sBAAsB,sCAAtB,sBAAsB,QAMjC;AAaY,QAAA,6BAA6B,GAAG,OAAC;KAC3C,MAAM,CAAC;IACN,GAAG,EAAE,8BAAsB;IAC3B,YAAY,EAAE,OAAC;SACZ,KAAK,CAAC,uBAAe,CAAC;SACtB,GAAG,CAAC,CAAC,EAAE,gDAAgD,CAAC;SACxD,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAC/C,mDAAmD,CACpD;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AASZ,SAAgB,YAAY,CAC1B,UAAyD,EACzD,IAAe;IAEf,OAAO,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AASD,SAAgB,sBAAsB,CACpC,UAAyD;IAEzD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAS,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAS,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG;QAAE,OAAO,sBAAsB,CAAC,OAAO,CAAC;IACnE,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,OAAO;QAAE,OAAO,sBAAsB,CAAC,WAAW,CAAC;IAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC,kBAAkB,CAAC;IACnD,CAAC;IACD,OAAO,sBAAsB,CAAC,KAAK,CAAC;AACtC,CAAC;AAiBD,SAAgB,oBAAoB,CAClC,UAAiE,EACjE,YAAyD;IAEzD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,CAAC,cAAc,gBAAgB;gBACpE,0CAA0C,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACnF,CAAC;QACJ,CAAC;QAGD,IAAA,+BAAa,EAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAA,0CAAsB,EAC3B,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACjC,cAAc,EAAE,WAAW,CAAC,cAAc;QAC1C,KAAK,EAAE,WAAW,CAAC,KAAK;KACzB,CAAC,CAAC,EAKH,GAAG,EAAE,CAAC,CAAC,CACR,CAAC;AACJ,CAAC"}