@xemahq/kernel-contracts 0.50.0 → 0.56.0

package/dist/space/lib/space-ref-parser.js

@@ -1,149 +1,113 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SpaceRefParseError = void 0;
+exports.parseSpaceRefScopeSegments = parseSpaceRefScopeSegments;
 exports.parseSpaceRef = parseSpaceRef;
 exports.formatSpaceRef = formatSpaceRef;
 const space_1 = require("./space");
+Object.defineProperty(exports, "SpaceRefParseError", { enumerable: true, get: function () { return space_1.SpaceRefParseError; } });
 const SCHEME = 'xema://';
-const IDENT_REGEX = /^[a-z0-9][a-z0-9_-]*$/;
-const SEGMENT_KEYS = ['org', 'project', 'app', 'session', 'biome', 'user'];
-const SEGMENT_KEY_SET = new Set(SEGMENT_KEYS);
-const KIND_BY_DEEPEST_SEGMENT = {
-    org: space_1.SpaceKind.Org,
-    project: space_1.SpaceKind.Project,
-    app: space_1.SpaceKind.App,
-    session: space_1.SpaceKind.Session,
-    biome: space_1.SpaceKind.Biome,
-    user: space_1.SpaceKind.User,
-};
-const FIELD_OF = {
-    org: 'orgId',
-    project: 'projectId',
-    app: 'appId',
-    session: 'sessionId',
-    biome: 'biomeId',
-    user: 'userId',
-};
-const PARENT_OF = {
-    org: null,
-    project: 'org',
-    app: 'project',
-    session: 'app',
-    biome: 'app',
-    user: null,
-};
-class SpaceRefParseError extends Error {
-    raw;
-    constructor(message, raw) {
-        super(message);
-        this.name = 'SpaceRefParseError';
-        this.raw = raw;
+var SpaceRefScopeHead;
+(function (SpaceRefScopeHead) {
+    SpaceRefScopeHead["System"] = "system";
+    SpaceRefScopeHead["Users"] = "users";
+    SpaceRefScopeHead["Biomes"] = "biomes";
+    SpaceRefScopeHead["Sessions"] = "sessions";
+    SpaceRefScopeHead["Orgs"] = "orgs";
+    SpaceRefScopeHead["Projects"] = "projects";
+    SpaceRefScopeHead["Apps"] = "apps";
+})(SpaceRefScopeHead || (SpaceRefScopeHead = {}));
+const SPACE_REF_SCOPE_HEADS = Object.values(SpaceRefScopeHead);
+function requireSegment(segments, index, raw, label) {
+    const value = segments[index];
+    if (value === undefined || value.length === 0) {
+        throw new space_1.SpaceRefParseError(`SpaceRef URI is missing the "${label}" segment.`, raw);
+    }
+    return value;
+}
+function takeId(segments, index, raw, field) {
+    const value = requireSegment(segments, index, raw, String(field));
+    (0, space_1.assertValidSpaceSegmentId)(field, value, raw);
+    return value;
+}
+function parseSpaceRefScopeSegments(segments, raw) {
+    const head = requireSegment(segments, 0, raw, 'scope');
+    switch (head) {
+        case SpaceRefScopeHead.System:
+            return { scope: { tier: space_1.SpaceKind.System }, consumed: 1 };
+        case SpaceRefScopeHead.Biomes:
+            return {
+                scope: {
+                    tier: space_1.SpaceKind.Biome,
+                    biomeId: takeId(segments, 1, raw, 'biomeId'),
+                },
+                consumed: 2,
+            };
+        case SpaceRefScopeHead.Users:
+            return {
+                scope: {
+                    tier: space_1.SpaceKind.User,
+                    userId: takeId(segments, 1, raw, 'userId'),
+                },
+                consumed: 2,
+            };
+        case SpaceRefScopeHead.Sessions:
+            return {
+                scope: {
+                    tier: space_1.SpaceKind.Session,
+                    sessionId: takeId(segments, 1, raw, 'sessionId'),
+                },
+                consumed: 2,
+            };
+        case SpaceRefScopeHead.Orgs: {
+            const orgId = takeId(segments, 1, raw, 'orgId');
+            if (segments.length >= 4 && segments[2] === SpaceRefScopeHead.Projects) {
+                const projectId = takeId(segments, 3, raw, 'projectId');
+                if (segments.length >= 6 && segments[4] === SpaceRefScopeHead.Apps) {
+                    return {
+                        scope: {
+                            tier: space_1.SpaceKind.App,
+                            orgId,
+                            projectId,
+                            appId: takeId(segments, 5, raw, 'appId'),
+                        },
+                        consumed: 6,
+                    };
+                }
+                return {
+                    scope: { tier: space_1.SpaceKind.Project, orgId, projectId },
+                    consumed: 4,
+                };
+            }
+            return { scope: { tier: space_1.SpaceKind.Org, orgId }, consumed: 2 };
+        }
+        default:
+            throw new space_1.SpaceRefParseError(`SpaceRef URI has unknown scope head "${head}". Allowed: ${SPACE_REF_SCOPE_HEADS.join(', ')}.`, raw);
     }
 }
-exports.SpaceRefParseError = SpaceRefParseError;
 function parseSpaceRef(uri) {
     if (typeof uri !== 'string' || uri.length === 0) {
-        throw new SpaceRefParseError('SpaceRef URI must be a non-empty string.', String(uri));
+        throw new space_1.SpaceRefParseError('SpaceRef URI must be a non-empty string.', String(uri));
     }
     if (!uri.startsWith(SCHEME)) {
-        throw new SpaceRefParseError(`SpaceRef URI must start with "${SCHEME}".`, uri);
+        throw new space_1.SpaceRefParseError(`SpaceRef URI must start with "${SCHEME}".`, uri);
     }
     const body = uri.slice(SCHEME.length);
     if (body.length === 0) {
-        throw new SpaceRefParseError('SpaceRef URI has empty body after scheme.', uri);
-    }
-    const parts = body.split('/');
-    if (parts.length === 1 && parts[0] === 'system') {
-        return { tier: space_1.SpaceKind.System, path: uri };
+        throw new space_1.SpaceRefParseError('SpaceRef URI has empty body after scheme.', uri);
     }
-    if (parts.length % 2 !== 0) {
-        throw new SpaceRefParseError(`SpaceRef URI body must be pairs of <segment>/<id> (got ${parts.length} parts).`, uri);
+    const segments = body.split('/');
+    if (segments.some((segment) => segment.length === 0)) {
+        throw new space_1.SpaceRefParseError('SpaceRef URI has an empty path segment (leading, trailing or doubled "/").', uri);
     }
-    const segments = {};
-    let lastSegment = null;
-    for (let i = 0; i < parts.length; i += 2) {
-        const key = parts[i];
-        const value = parts[i + 1];
-        if (!SEGMENT_KEY_SET.has(key)) {
-            throw new SpaceRefParseError(`SpaceRef URI has unknown segment key "${key}". Allowed: ${SEGMENT_KEYS.join(', ')}.`, uri);
-        }
-        const typedKey = key;
-        if (segments[typedKey] !== undefined) {
-            throw new SpaceRefParseError(`SpaceRef URI repeats segment "${key}".`, uri);
-        }
-        if (!IDENT_REGEX.test(value)) {
-            throw new SpaceRefParseError(`SpaceRef URI segment "${key}" has invalid id "${value}".`, uri);
-        }
-        const expectedParent = PARENT_OF[typedKey];
-        if (expectedParent !== lastSegment) {
-            throw new SpaceRefParseError(`SpaceRef URI segment "${key}" must follow "${expectedParent ?? '(root)'}", got "${lastSegment ?? '(root)'}".`, uri);
-        }
-        segments[typedKey] = value;
-        lastSegment = typedKey;
+    const { scope, consumed } = parseSpaceRefScopeSegments(segments, uri);
+    if (consumed !== segments.length) {
+        throw new space_1.SpaceRefParseError(`SpaceRef URI has ${segments.length - consumed} trailing segment(s) after the scope — a Space ref addresses a Space, not an object inside it.`, uri);
     }
-    if (lastSegment === null) {
-        throw new SpaceRefParseError('SpaceRef URI parsed no segments.', uri);
-    }
-    const tier = KIND_BY_DEEPEST_SEGMENT[lastSegment];
-    const ref = { tier, path: uri };
-    for (const segKey of SEGMENT_KEYS) {
-        const segValue = segments[segKey];
-        if (segValue !== undefined) {
-            const fieldName = FIELD_OF[segKey];
-            ref[fieldName] = segValue;
-        }
-    }
-    return ref;
+    scope.path = formatSpaceRef(scope);
+    return scope;
 }
 function formatSpaceRef(ref) {
-    if (ref.tier === space_1.SpaceKind.System) {
-        return `${SCHEME}system`;
-    }
-    const out = [SCHEME];
-    const append = (key, value) => {
-        if (value === undefined) {
-            throw new SpaceRefParseError(`formatSpaceRef: missing required segment "${key}" for tier "${ref.tier}".`, ref.tier);
-        }
-        if (!IDENT_REGEX.test(value)) {
-            throw new SpaceRefParseError(`formatSpaceRef: segment "${key}" id "${value}" violates grammar.`, ref.tier);
-        }
-        if (out.length > 1)
-            out.push('/');
-        out.push(`${key}/${value}`);
-    };
-    switch (ref.tier) {
-        case space_1.SpaceKind.User:
-            append('user', ref.userId);
-            break;
-        case space_1.SpaceKind.Org:
-            append('org', ref.orgId);
-            break;
-        case space_1.SpaceKind.Project:
-            append('org', ref.orgId);
-            append('project', ref.projectId);
-            break;
-        case space_1.SpaceKind.App:
-            append('org', ref.orgId);
-            append('project', ref.projectId);
-            append('app', ref.appId);
-            break;
-        case space_1.SpaceKind.Session:
-            append('org', ref.orgId);
-            append('project', ref.projectId);
-            append('app', ref.appId);
-            append('session', ref.sessionId);
-            break;
-        case space_1.SpaceKind.Biome:
-            append('org', ref.orgId);
-            append('project', ref.projectId);
-            append('app', ref.appId);
-            append('biome', ref.biomeId);
-            break;
-        default: {
-            const exhaustive = ref.tier;
-            throw new SpaceRefParseError(`formatSpaceRef: unhandled SpaceKind "${String(exhaustive)}".`, String(exhaustive));
-        }
-    }
-    return out.join('');
+    return `${SCHEME}${(0, space_1.spaceRefToPath)(ref).slice(1)}`;
 }
 //# sourceMappingURL=space-ref-parser.js.map

package/dist/space/lib/space-ref-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"space-ref-parser.js","sourceRoot":"","sources":["../../../src/space/lib/space-ref-parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"space-ref-parser.js","sourceRoot":"","sources":["../../../src/space/lib/space-ref-parser.ts"],"names":[],"mappings":"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"}

package/dist/space/lib/space-traversal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"space-traversal.d.ts","sourceRoot":"","sources":["../../../src/space/lib/space-traversal.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AASnD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAQvD"}
+{"version":3,"file":"space-traversal.d.ts","sourceRoot":"","sources":["../../../src/space/lib/space-traversal.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAwBnD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAQvD"}

package/dist/space/lib/space-traversal.js

@@ -12,13 +12,21 @@ function walkAncestors(ref) {
     }
     return out;
 }
+function systemParent() {
+    return {
+        tier: space_1.SpaceKind.System,
+        path: (0, space_ref_parser_1.formatSpaceRef)({ tier: space_1.SpaceKind.System }),
+    };
+}
 function parentOf(ref) {
     switch (ref.tier) {
         case space_1.SpaceKind.System:
             return null;
         case space_1.SpaceKind.User:
         case space_1.SpaceKind.Org:
-            return { tier: space_1.SpaceKind.System, path: (0, space_ref_parser_1.formatSpaceRef)({ tier: space_1.SpaceKind.System }) };
+        case space_1.SpaceKind.Session:
+        case space_1.SpaceKind.Biome:
+            return systemParent();
         case space_1.SpaceKind.Project: {
             const parent = { tier: space_1.SpaceKind.Org };
             if (ref.orgId !== undefined)
@@ -35,18 +43,6 @@ function parentOf(ref) {
             parent.path = (0, space_ref_parser_1.formatSpaceRef)(parent);
             return parent;
         }
-        case space_1.SpaceKind.Session:
-        case space_1.SpaceKind.Biome: {
-            const parent = { tier: space_1.SpaceKind.App };
-            if (ref.orgId !== undefined)
-                parent.orgId = ref.orgId;
-            if (ref.projectId !== undefined)
-                parent.projectId = ref.projectId;
-            if (ref.appId !== undefined)
-                parent.appId = ref.appId;
-            parent.path = (0, space_ref_parser_1.formatSpaceRef)(parent);
-            return parent;
-        }
         default: {
             const exhaustive = ref.tier;
             throw new Error(`walkAncestors: unhandled SpaceKind "${String(exhaustive)}".`);

package/dist/space/lib/space-traversal.js.map

@@ -1 +1 @@
-{"version":3,"file":"space-traversal.js","sourceRoot":"","sources":["../../../src/space/lib/space-traversal.ts"],"names":[],"mappings":";;AAUA,sCAQC;AAlBD,yDAAoD;AACpD,mCAAmD;AASnD,SAAgB,aAAa,CAAC,GAAa;IACzC,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAoB,GAAG,CAAC;IACnC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,GAAa;IAC7B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,iBAAS,CAAC,MAAM;YACnB,OAAO,IAAI,CAAC;QACd,KAAK,iBAAS,CAAC,IAAI,CAAC;QACpB,KAAK,iBAAS,CAAC,GAAG;YAChB,OAAO,EAAE,IAAI,EAAE,iBAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAA,iCAAc,EAAC,EAAE,IAAI,EAAE,iBAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACtF,KAAK,iBAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACvB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,GAAG,EAAE,CAAC;YACjD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,iBAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,OAAO,EAAE,CAAC;YACrD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAClE,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,iBAAS,CAAC,OAAO,CAAC;QACvB,KAAK,iBAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,GAAG,EAAE,CAAC;YACjD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAClE,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,GAAG,CAAC,IAAI,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"space-traversal.js","sourceRoot":"","sources":["../../../src/space/lib/space-traversal.ts"],"names":[],"mappings":";;AAyBA,sCAQC;AAjCD,yDAAoD;AACpD,mCAAmD;AAwBnD,SAAgB,aAAa,CAAC,GAAa;IACzC,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAoB,GAAG,CAAC;IACnC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY;IACnB,OAAO;QACL,IAAI,EAAE,iBAAS,CAAC,MAAM;QACtB,IAAI,EAAE,IAAA,iCAAc,EAAC,EAAE,IAAI,EAAE,iBAAS,CAAC,MAAM,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,GAAa;IAC7B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,iBAAS,CAAC,MAAM;YACnB,OAAO,IAAI,CAAC;QACd,KAAK,iBAAS,CAAC,IAAI,CAAC;QACpB,KAAK,iBAAS,CAAC,GAAG,CAAC;QACnB,KAAK,iBAAS,CAAC,OAAO,CAAC;QACvB,KAAK,iBAAS,CAAC,KAAK;YAClB,OAAO,YAAY,EAAE,CAAC;QACxB,KAAK,iBAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACvB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,GAAG,EAAE,CAAC;YACjD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,iBAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,OAAO,EAAE,CAAC;YACrD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAClE,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,GAAG,CAAC,IAAI,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,uCAAuC,MAAM,CAAC,UAAU,CAAC,IAAI,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/space/lib/space.d.ts

@@ -41,6 +41,13 @@ export declare const SpaceRefSchema: z.ZodObject<{
     path: z.ZodOptional<z.ZodString>;
     classification: z.ZodOptional<z.ZodEnum<typeof DataClassification>>;
 }, z.core.$strip>;
+export declare class SpaceRefParseError extends Error {
+    readonly code = "SPACE_REF_INVALID";
+    readonly raw: string;
+    constructor(message: string, raw: string);
+}
+export declare const SPACE_SEGMENT_ID_PATTERN: RegExp;
+export declare function assertValidSpaceSegmentId(segment: keyof SpaceRef, value: string, raw: string): void;
 export declare function spaceRefToPath(ref: SpaceRef): string;
 export interface Space {
     id: string;

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

@@ -1 +1 @@
-{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../src/space/lib/space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAGD,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;IAC7B,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAeD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,eAAO,MAAM,eAAe,6BAA0B,CAAC;AACvD,eAAO,MAAM,wBAAwB,sCAAmC,CAAC;AAkBzE,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAC7C,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAOnC,CAAC;AAOF,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,kBAAkB,EAC7B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAET;AAyCD,eAAO,MAAM,cAAc;;;;;;;;;;iBAEa,CAAC;AAiBzC,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAuCpD;AAOD,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,QAAQ,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC"}
+{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../src/space/lib/space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAGD,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;IAC7B,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAeD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,eAAO,MAAM,eAAe,6BAA0B,CAAC;AACvD,eAAO,MAAM,wBAAwB,sCAAmC,CAAC;AAkBzE,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAC7C,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAOnC,CAAC;AAOF,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,kBAAkB,EAC7B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAET;AAyCD,eAAO,MAAM,cAAc;;;;;;;;;;iBAEa,CAAC;AAkBzC,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,IAAI,uBAAuB;IAC3C,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAET,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKhD;AAUD,eAAO,MAAM,wBAAwB,QAAiC,CAAC;AAQvE,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,QAAQ,EACvB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,IAAI,CAON;AA2CD,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAgCpD;AAOD,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,QAAQ,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC"}

package/dist/space/lib/space.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SpaceRefSchema = exports.DATA_CLASSIFICATION_RANK = exports.DataClassificationSchema = exports.SpaceKindSchema = exports.DataClassification = exports.SpaceKind = void 0;
+exports.SPACE_SEGMENT_ID_PATTERN = exports.SpaceRefParseError = exports.SpaceRefSchema = exports.DATA_CLASSIFICATION_RANK = exports.DataClassificationSchema = exports.SpaceKindSchema = exports.DataClassification = exports.SpaceKind = void 0;
 exports.dataClassificationExceeds = dataClassificationExceeds;
+exports.assertValidSpaceSegmentId = assertValidSpaceSegmentId;
 exports.spaceRefToPath = spaceRefToPath;
 const zod_1 = require("zod");
 var SpaceKind;
@@ -70,40 +71,58 @@ const REQUIRED_SEGMENTS = {
     [SpaceKind.Biome]: ['biomeId'],
     [SpaceKind.User]: ['userId'],
 };
+class SpaceRefParseError extends Error {
+    code = 'SPACE_REF_INVALID';
+    raw;
+    constructor(message, raw) {
+        super(message);
+        this.name = 'SpaceRefParseError';
+        this.raw = raw;
+    }
+}
+exports.SpaceRefParseError = SpaceRefParseError;
+exports.SPACE_SEGMENT_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/;
+function assertValidSpaceSegmentId(segment, value, raw) {
+    if (!exports.SPACE_SEGMENT_ID_PATTERN.test(value)) {
+        throw new SpaceRefParseError(`Space segment "${String(segment)}" id "${value}" must match ${exports.SPACE_SEGMENT_ID_PATTERN}.`, raw);
+    }
+}
+function requireSpaceSegment(ref, segment, raw) {
+    const value = ref[segment];
+    if (value === undefined || value.length === 0) {
+        throw new SpaceRefParseError(`SpaceKind.${ref.tier} requires "${segment}".`, raw);
+    }
+    assertValidSpaceSegmentId(segment, value, raw);
+    return value;
+}
 function spaceRefToPath(ref) {
+    const raw = ref.path ?? `<SpaceKind.${ref.tier}>`;
     switch (ref.tier) {
         case SpaceKind.System:
             return '/system';
         case SpaceKind.Biome:
-            if (!ref.biomeId) {
-                throw new Error('spaceRefToPath: SpaceKind.Biome requires biomeId');
-            }
-            return `/biomes/${ref.biomeId}`;
-        case SpaceKind.Org:
-            if (!ref.orgId) {
-                throw new Error('spaceRefToPath: SpaceKind.Org requires orgId');
-            }
-            return `/orgs/${ref.orgId}`;
-        case SpaceKind.Project:
-            if (!ref.orgId || !ref.projectId) {
-                throw new Error('spaceRefToPath: SpaceKind.Project requires orgId and projectId');
-            }
-            return `/orgs/${ref.orgId}/projects/${ref.projectId}`;
-        case SpaceKind.App:
-            if (!ref.orgId || !ref.projectId || !ref.appId) {
-                throw new Error('spaceRefToPath: SpaceKind.App requires orgId, projectId, and appId');
-            }
-            return `/orgs/${ref.orgId}/projects/${ref.projectId}/apps/${ref.appId}`;
-        case SpaceKind.Session:
-            if (!ref.sessionId) {
-                throw new Error('spaceRefToPath: SpaceKind.Session requires sessionId');
-            }
-            return `/sessions/${ref.sessionId}`;
+            return `/biomes/${requireSpaceSegment(ref, 'biomeId', raw)}`;
         case SpaceKind.User:
-            if (!ref.userId) {
-                throw new Error('spaceRefToPath: SpaceKind.User requires userId');
-            }
-            return `/users/${ref.userId}`;
+            return `/users/${requireSpaceSegment(ref, 'userId', raw)}`;
+        case SpaceKind.Session:
+            return `/sessions/${requireSpaceSegment(ref, 'sessionId', raw)}`;
+        case SpaceKind.Org:
+            return `/orgs/${requireSpaceSegment(ref, 'orgId', raw)}`;
+        case SpaceKind.Project: {
+            const orgId = requireSpaceSegment(ref, 'orgId', raw);
+            const projectId = requireSpaceSegment(ref, 'projectId', raw);
+            return `/orgs/${orgId}/projects/${projectId}`;
+        }
+        case SpaceKind.App: {
+            const orgId = requireSpaceSegment(ref, 'orgId', raw);
+            const projectId = requireSpaceSegment(ref, 'projectId', raw);
+            const appId = requireSpaceSegment(ref, 'appId', raw);
+            return `/orgs/${orgId}/projects/${projectId}/apps/${appId}`;
+        }
+        default: {
+            const exhaustive = ref.tier;
+            throw new SpaceRefParseError(`spaceRefToPath: unhandled SpaceKind "${String(exhaustive)}".`, raw);
+        }
     }
 }
 //# sourceMappingURL=space.js.map

package/dist/space/lib/space.js.map

@@ -1 +1 @@
-{"version":3,"file":"space.js","sourceRoot":"","sources":["../../../src/space/lib/space.ts"],"names":[],"mappings":";;;AAyFA,8DAKC;AA4DD,wCAuCC;AAjMD,6BAAwB;AAWxB,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,wBAAW,CAAA;IACX,gCAAmB,CAAA;IACnB,wBAAW,CAAA;IACX,gCAAmB,CAAA;IACnB,4BAAe,CAAA;IACf,0BAAa,CAAA;AACf,CAAC,EARW,SAAS,yBAAT,SAAS,QAQpB;AAGD,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;IACrB,mDAA6B,CAAA;IAC7B,uCAAiB,CAAA;IACjB,6CAAuB,CAAA;AACzB,CAAC,EANW,kBAAkB,kCAAlB,kBAAkB,QAM7B;AA2BY,QAAA,eAAe,GAAG,OAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAC1C,QAAA,wBAAwB,GAAG,OAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAkB5D,QAAA,wBAAwB,GAEjC;IACF,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAChC,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC;IACpC,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9B,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;CAClC,CAAC;AAOF,SAAgB,yBAAyB,CACvC,SAA6B,EAC7B,GAAuB;IAEvB,OAAO,gCAAwB,CAAC,SAAS,CAAC,GAAG,gCAAwB,CAAC,GAAG,CAAC,CAAC;AAC7E,CAAC;AAUD,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,uBAAe;IACrB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,gCAAwB,CAAC,QAAQ,EAAE;CAC3C,CAAC;AAIX,SAAS,wBAAwB,CAC/B,KAAwB,EACxB,GAAoB;IAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAA8B,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,OAAO,EAAE,aAAa,KAAK,CAAC,IAAI,aAAa,GAAG,EAAE;gBAClD,IAAI,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAEY,QAAA,cAAc,GAAG,OAAC;KAC5B,MAAM,CAAC,iBAAiB,CAAC;KACzB,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAEzC,MAAM,iBAAiB,GAAuD;IAC5E,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE;IACtB,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC;IAC1B,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;IAC3C,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC;IAChD,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC;IAClC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC;IAC9B,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC;CAC7B,CAAC;AAOF,SAAgB,cAAc,CAAC,GAAa;IAC1C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,SAAS,CAAC,MAAM;YACnB,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS,CAAC,KAAK;YAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACtE,CAAC;YACD,OAAO,WAAW,GAAG,CAAC,OAAO,EAAE,CAAC;QAClC,KAAK,SAAS,CAAC,GAAG;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,SAAS,GAAG,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,SAAS,CAAC,OAAO;YACpB,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;YACJ,CAAC;YACD,OAAO,SAAS,GAAG,CAAC,KAAK,aAAa,GAAG,CAAC,SAAS,EAAE,CAAC;QACxD,KAAK,SAAS,CAAC,GAAG;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;YACJ,CAAC;YACD,OAAO,SAAS,GAAG,CAAC,KAAK,aAAa,GAAG,CAAC,SAAS,SAAS,GAAG,CAAC,KAAK,EAAE,CAAC;QAC1E,KAAK,SAAS,CAAC,OAAO;YACpB,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO,aAAa,GAAG,CAAC,SAAS,EAAE,CAAC;QACtC,KAAK,SAAS,CAAC,IAAI;YACjB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,UAAU,GAAG,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;AACH,CAAC"}
+{"version":3,"file":"space.js","sourceRoot":"","sources":["../../../src/space/lib/space.ts"],"names":[],"mappings":"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"}

package/dist/subject/lib/subject.d.ts

@@ -15,6 +15,7 @@ export declare const SubjectKindSchema: z.ZodEnum<typeof SubjectKind>;
 export interface ActingForRef {
     kind: SubjectKind;
     id: string;
+    clientId?: string;
 }
 export declare const ActingForRefSchema: z.ZodType<ActingForRef>;
 export interface SubjectRef {

package/dist/subject/lib/subject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../../../src/subject/lib/subject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,SAAS,eAAe;IACxB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,eAAe,qBAAqB;IACpC,IAAI,SAAS;CACd;AAED,eAAO,MAAM,iBAAiB,+BAA4B,CAAC;AAY3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,kBAAkB,EAGzB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAW9B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,EAKvB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAQ5B,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC,GACvC,MAAM,CAER;AAOD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAgBvD"}
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../../../src/subject/lib/subject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,SAAS,eAAe;IACxB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,eAAe,qBAAqB;IACpC,IAAI,SAAS;CACd;AAED,eAAO,MAAM,iBAAiB,+BAA4B,CAAC;AAY3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IAeX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,EAIzB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAW9B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,EAKvB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAQ5B,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC,GACvC,MAAM,CAER;AAOD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAgBvD"}

package/dist/subject/lib/subject.js

@@ -21,6 +21,7 @@ exports.SubjectKindSchema = zod_1.z.nativeEnum(SubjectKind);
 exports.ActingForRefSchema = zod_1.z.object({
     kind: exports.SubjectKindSchema,
     id: zod_1.z.string().min(1),
+    clientId: zod_1.z.string().min(1).optional(),
 });
 exports.SubjectRefSchema = zod_1.z.object({
     kind: exports.SubjectKindSchema,

package/dist/subject/lib/subject.js.map

@@ -1 +1 @@
-{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../../src/subject/lib/subject.ts"],"names":[],"mappings":";;;AAmFA,gDAIC;AAOD,0CAgBC;AA9GD,6BAAwB;AAmBxB,IAAY,WAWX;AAXD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,0BAAW,CAAA;IACX,uCAAwB,CAAA;IACxB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,4BAAa,CAAA;IACb,gCAAiB,CAAA;IACjB,mDAAoC,CAAA;IACpC,4BAAa,CAAA;AACf,CAAC,EAXW,WAAW,2BAAX,WAAW,QAWtB;AAEY,QAAA,iBAAiB,GAAG,OAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAiB9C,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,yBAAiB;IACvB,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACtB,CAA4B,CAAC;AAkBjB,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,yBAAiB;IACvB,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,0BAAkB,CAAC,QAAQ,EAAE;CACzC,CAA0B,CAAC;AAQ5B,SAAgB,kBAAkB,CAChC,OAAwC;IAExC,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;AACzC,CAAC;AAOD,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,UAAU,IAAI,CAAC,IAAI,UAAU,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,yDAAyD,CACrF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,yBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,OAAO,IAAI,+BAA+B,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../../src/subject/lib/subject.ts"],"names":[],"mappings":";;;AAmGA,gDAIC;AAOD,0CAgBC;AA9HD,6BAAwB;AAmBxB,IAAY,WAWX;AAXD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,0BAAW,CAAA;IACX,uCAAwB,CAAA;IACxB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,4BAAa,CAAA;IACb,gCAAiB,CAAA;IACjB,mDAAoC,CAAA;IACpC,4BAAa,CAAA;AACf,CAAC,EAXW,WAAW,2BAAX,WAAW,QAWtB;AAEY,QAAA,iBAAiB,GAAG,OAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAgC9C,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,yBAAiB;IACvB,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvC,CAA4B,CAAC;AAkBjB,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,yBAAiB;IACvB,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,0BAAkB,CAAC,QAAQ,EAAE;CACzC,CAA0B,CAAC;AAQ5B,SAAgB,kBAAkB,CAChC,OAAwC;IAExC,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;AACzC,CAAC;AAOD,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,UAAU,IAAI,CAAC,IAAI,UAAU,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,yDAAyD,CACrF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,yBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,OAAO,IAAI,+BAA+B,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC"}

package/dist/surface/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/surface-kind';
+export * from './lib/vista-surface';
+export * from './lib/surface-contribution';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surface/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/dist/surface/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/surface-kind"), exports);
+__exportStar(require("./lib/vista-surface"), exports);
+__exportStar(require("./lib/surface-contribution"), exports);
+//# sourceMappingURL=index.js.map

package/dist/surface/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/surface/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,sDAAoC;AACpC,6DAA2C"}

package/dist/surface/lib/surface-contribution.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export interface SurfaceContributionManifest {
+    readonly kind: string;
+    readonly version: number;
+    readonly displayName: string;
+    readonly summary: string;
+    readonly payloadSchema: Record<string, unknown>;
+}
+export declare const SurfaceContributionManifestSchema: z.ZodType<SurfaceContributionManifest>;
+export declare enum SurfaceKindSource {
+    FirstParty = "first-party",
+    Biome = "biome"
+}
+export declare const SurfaceKindSourceSchema: z.ZodEnum<typeof SurfaceKindSource>;
+export interface SurfaceKindCatalogueEntry {
+    readonly kind: string;
+    readonly version: number;
+    readonly displayName: string;
+    readonly summary: string;
+    readonly payloadSchema: Record<string, unknown>;
+    readonly source: SurfaceKindSource;
+    readonly biomeId?: string;
+}
+//# sourceMappingURL=surface-contribution.d.ts.map

package/dist/surface/lib/surface-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-contribution.d.ts","sourceRoot":"","sources":["../../../src/surface/lib/surface-contribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB,MAAM,WAAW,2BAA2B;IAM1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAUD,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAcvC,CAAC;AAG/C,oBAAY,iBAAiB;IAC3B,UAAU,gBAAgB;IAC1B,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,uBAAuB,qCAAkC,CAAC;AAavE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/surface/lib/surface-contribution.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SurfaceKindSourceSchema = exports.SurfaceKindSource = exports.SurfaceContributionManifestSchema = void 0;
+const zod_1 = require("zod");
+const SURFACE_KIND_SLUG_REGEX = /^[a-z][a-z0-9-]*$/;
+exports.SurfaceContributionManifestSchema = zod_1.z.object({
+    kind: zod_1.z
+        .string()
+        .min(1)
+        .max(100)
+        .regex(SURFACE_KIND_SLUG_REGEX, 'Surface kind slug must be lowercase letters, digits, and hyphens (start with a letter).'),
+    version: zod_1.z.number().int().positive(),
+    displayName: zod_1.z.string().min(1).max(200),
+    summary: zod_1.z.string().min(1).max(1000),
+    payloadSchema: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+});
+var SurfaceKindSource;
+(function (SurfaceKindSource) {
+    SurfaceKindSource["FirstParty"] = "first-party";
+    SurfaceKindSource["Biome"] = "biome";
+})(SurfaceKindSource || (exports.SurfaceKindSource = SurfaceKindSource = {}));
+exports.SurfaceKindSourceSchema = zod_1.z.nativeEnum(SurfaceKindSource);
+//# sourceMappingURL=surface-contribution.js.map

package/dist/surface/lib/surface-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-contribution.js","sourceRoot":"","sources":["../../../src/surface/lib/surface-contribution.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAgDxB,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAQvC,QAAA,iCAAiC,GAC5C,OAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,KAAK,CACJ,uBAAuB,EACvB,yFAAyF,CAC1F;IACH,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACpC,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;CACjD,CAA2C,CAAC;AAG/C,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,+CAA0B,CAAA;IAC1B,oCAAe,CAAA;AACjB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B;AAEY,QAAA,uBAAuB,GAAG,OAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC"}