@xemahq/contracts 0.1.0

package/dist/content-address/lib/content-address.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const Sha256HexSchema: z.ZodString;
+export declare const OPAQUE_TOKEN_PATTERN: RegExp;
+export interface ContentAddressedRef {
+    readonly ref: string;
+    readonly contentHash: string;
+}
+export declare const ContentAddressedRefSchema: z.ZodType<ContentAddressedRef>;
+export type CanonicalJsonValue = null | boolean | number | string | readonly CanonicalJsonValue[] | {
+    readonly [key: string]: CanonicalJsonValue | undefined;
+};
+export type DeepReadonly<T> = T extends null | string | number | boolean | undefined ? T : T extends readonly (infer Item)[] ? readonly DeepReadonly<Item>[] : T extends object ? {
+    readonly [Key in keyof T]: DeepReadonly<T[Key]>;
+} : never;
+export declare function canonicalJsonStringify(value: unknown): string;
+export declare function sha256Hex(bytes: Uint8Array): Promise<string>;
+export declare function canonicalContentHash(value: unknown): Promise<string>;
+export declare function deepFreezeCanonicalJson<T>(value: T): DeepReadonly<T>;
+//# sourceMappingURL=content-address.d.ts.map

package/dist/content-address/lib/content-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-address.d.ts","sourceRoot":"","sources":["../../../src/content-address/lib/content-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,eAAO,MAAM,eAAe,aAEyC,CAAC;AAWtE,eAAO,MAAM,oBAAoB,QAAoB,CAAC;AAStD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAY1D,CAAC;AASZ,MAAM,MAAM,kBAAkB,GAC1B,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,kBAAkB,EAAE,GAC7B;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAA;CAAE,CAAC;AAG/D,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAC3B,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,CAAC,GACD,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GAC/B,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GAC7B,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAAE,GACnD,KAAK,CAAC;AAwDd,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE7D;AAKD,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlE;AAMD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E;AAgBD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAIpE"}

package/dist/content-address/lib/content-address.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentAddressedRefSchema = exports.OPAQUE_TOKEN_PATTERN = exports.Sha256HexSchema = void 0;
+exports.canonicalJsonStringify = canonicalJsonStringify;
+exports.sha256Hex = sha256Hex;
+exports.canonicalContentHash = canonicalContentHash;
+exports.deepFreezeCanonicalJson = deepFreezeCanonicalJson;
+const zod_1 = require("zod");
+exports.Sha256HexSchema = zod_1.z
+    .string()
+    .regex(/^[a-f0-9]{64}$/, 'expected a lowercase SHA-256 hex digest');
+exports.OPAQUE_TOKEN_PATTERN = /^[^\s\p{Cc}]+$/u;
+exports.ContentAddressedRefSchema = zod_1.z
+    .object({
+    ref: zod_1.z
+        .string()
+        .min(1)
+        .max(2_048)
+        .regex(exports.OPAQUE_TOKEN_PATTERN, 'content-addressed ref must be opaque and contain no whitespace or control characters'),
+    contentHash: exports.Sha256HexSchema,
+})
+    .strict();
+function canonicalJsonStringify(value) {
+    return canonicalize(value, new WeakSet(), false);
+}
+async function sha256Hex(bytes) {
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', Uint8Array.from(bytes));
+    return [...new Uint8Array(digest)]
+        .map((byte) => byte.toString(16).padStart(2, '0'))
+        .join('');
+}
+async function canonicalContentHash(value) {
+    const bytes = new TextEncoder().encode(canonicalJsonStringify(value));
+    return sha256Hex(bytes);
+}
+function deepFreezeCanonicalJson(value) {
+    return deepFreeze(JSON.parse(canonicalJsonStringify(value)));
+}
+function canonicalize(value, ancestors, arrayEntry) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        if (arrayEntry) {
+            return 'null';
+        }
+        throw new Error('canonicalJsonStringify: top-level undefined is not JSON content.');
+    }
+    if (Array.isArray(value)) {
+        assertNotCircular(value, ancestors);
+        ancestors.add(value);
+        try {
+            return `[${value
+                .map((entry) => canonicalize(entry, ancestors, true))
+                .join(',')}]`;
+        }
+        finally {
+            ancestors.delete(value);
+        }
+    }
+    switch (typeof value) {
+        case 'string':
+        case 'boolean':
+            return JSON.stringify(value);
+        case 'number':
+            if (!Number.isFinite(value)) {
+                throw new Error('canonicalJsonStringify: non-finite numbers are not JSON content.');
+            }
+            return JSON.stringify(value);
+        case 'object': {
+            assertPlainObject(value);
+            assertNotCircular(value, ancestors);
+            ancestors.add(value);
+            try {
+                const object = value;
+                const keys = Object.keys(object)
+                    .filter((key) => object[key] !== undefined)
+                    .sort();
+                return `{${keys
+                    .map((key) => `${JSON.stringify(key)}:${canonicalize(object[key], ancestors, false)}`)
+                    .join(',')}}`;
+            }
+            finally {
+                ancestors.delete(value);
+            }
+        }
+        default:
+            throw new Error(`canonicalJsonStringify: unsupported value type "${typeof value}".`);
+    }
+}
+function assertPlainObject(value) {
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw new Error('canonicalJsonStringify: only plain JSON objects are supported.');
+    }
+}
+function assertNotCircular(value, ancestors) {
+    if (ancestors.has(value)) {
+        throw new Error('canonicalJsonStringify: circular reference.');
+    }
+}
+function deepFreeze(value) {
+    if (value !== null && typeof value === 'object') {
+        for (const nested of Object.values(value)) {
+            deepFreeze(nested);
+        }
+        Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=content-address.js.map

package/dist/content-address/lib/content-address.js.map

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

package/dist/content-address/server/index.d.ts

@@ -0,0 +1,2 @@
+export declare function canonicalJsonSha256(value: unknown): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/content-address/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/content-address/server/index.ts"],"names":[],"mappings":"AAoDA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI1D"}

package/dist/content-address/server/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalJsonSha256 = canonicalJsonSha256;
+const node_crypto_1 = require("node:crypto");
+const content_address_1 = require("../lib/content-address");
+function canonicalJsonSha256(value) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update((0, content_address_1.canonicalJsonStringify)(value), 'utf8')
+        .digest('hex');
+}
+//# sourceMappingURL=index.js.map

package/dist/content-address/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/content-address/server/index.ts"],"names":[],"mappings":";;AAoDA,kDAIC;AAnCD,6CAAyC;AAEzC,4DAAgE;AA6BhE,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,IAAA,wCAAsB,EAAC,KAAK,CAAC,EAAE,MAAM,CAAC;SAC7C,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/contribution/index.d.ts

@@ -0,0 +1,9 @@
+export * from './lib/contribution-kind';
+export * from './lib/contributed-contribution-kind';
+export * from './lib/contribution-kind-descriptor';
+export * from './lib/contribution-source';
+export * from './lib/contribution';
+export * from './lib/contribution-provenance-rank';
+export * from './lib/registry';
+export * from './lib/sync';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contribution/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/contribution/index.js

@@ -0,0 +1,25 @@
+"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/contribution-kind"), exports);
+__exportStar(require("./lib/contributed-contribution-kind"), exports);
+__exportStar(require("./lib/contribution-kind-descriptor"), exports);
+__exportStar(require("./lib/contribution-source"), exports);
+__exportStar(require("./lib/contribution"), exports);
+__exportStar(require("./lib/contribution-provenance-rank"), exports);
+__exportStar(require("./lib/registry"), exports);
+__exportStar(require("./lib/sync"), exports);
+//# sourceMappingURL=index.js.map

package/dist/contribution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contribution/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,sEAAoD;AACpD,qEAAmD;AACnD,4DAA0C;AAC1C,qDAAmC;AACnC,qEAAmD;AACnD,iDAA+B;AAC/B,6CAA2B"}

package/dist/contribution/lib/contributed-contribution-kind.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { ContributionKind } from './contribution-kind';
+export declare const CONTRIBUTION_NAMESPACE_SOURCE = "[a-z][a-z0-9-]*";
+export declare const CONTRIBUTION_NAMESPACE_PATTERN: RegExp;
+export declare const CONTRIBUTED_KIND_LOCAL_PATTERN: RegExp;
+export declare const CONTRIBUTED_KIND_SEPARATOR = ":";
+export type ContributedContributionKindValue = `${string}:${string}`;
+export interface ContributedContributionKind {
+    readonly biomeId: string;
+    readonly key: string;
+}
+export declare const ContributedContributionKindSchema: z.ZodType<ContributedContributionKind>;
+export declare class ContributionKindRefParseError extends Error {
+    readonly code = "CONTRIBUTION_KIND_REF_INVALID";
+    readonly raw: string;
+    constructor(message: string, raw: string);
+}
+export declare function isContributedContributionKindValue(raw: string): raw is ContributedContributionKindValue;
+export declare function formatContributedContributionKind(kind: ContributedContributionKind): ContributedContributionKindValue;
+export declare function parseContributedContributionKind(raw: string): ContributedContributionKind;
+export type ContributionKindRef = ContributionKind | ContributedContributionKindValue;
+export type ResolvedContributionKind = {
+    readonly platform: true;
+    readonly kind: ContributionKind;
+} | {
+    readonly platform: false;
+    readonly kind: ContributedContributionKind;
+    readonly ref: ContributedContributionKindValue;
+};
+export declare function resolveContributionKind(raw: string): ResolvedContributionKind;
+export declare function isPlatformContributionKind(raw: string): raw is ContributionKind;
+export declare const ContributionKindRefSchema: z.ZodType<ContributionKindRef>;
+export declare function assertContributedKindDeclaredBy(ref: ContributedContributionKindValue, declaringBiomeId: string): ContributedContributionKind;
+//# sourceMappingURL=contributed-contribution-kind.d.ts.map

package/dist/contribution/lib/contributed-contribution-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributed-contribution-kind.d.ts","sourceRoot":"","sources":["../../../src/contribution/lib/contributed-contribution-kind.ts"],"names":[],"mappings":"AA2EA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAavD,eAAO,MAAM,6BAA6B,oBAAoB,CAAC;AAG/D,eAAO,MAAM,8BAA8B,QAE1C,CAAC;AAQF,eAAO,MAAM,8BAA8B,QAA2B,CAAC;AAGvE,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAG9C,MAAM,MAAM,gCAAgC,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AASrE,MAAM,WAAW,2BAA2B;IAE1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAgBxE,CAAC;AAGd,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,SAAgB,IAAI,mCAAmC;IACvD,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAET,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKhD;AAUD,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,gCAAgC,CAEzC;AAGD,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,2BAA2B,GAChC,gCAAgC,CAGlC;AASD,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,GACV,2BAA2B,CAwB7B;AAUD,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,gCAAgC,CAAC;AAOrC,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC5D;IACE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,GAAG,EAAE,gCAAgC,CAAC;CAChD,CAAC;AAgBN,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAkB7E;AAGD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,gBAAgB,CAEzB;AASD,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAWpB,CAAC;AAYlD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,gCAAgC,EACrC,gBAAgB,EAAE,MAAM,GACvB,2BAA2B,CAY7B"}

package/dist/contribution/lib/contributed-contribution-kind.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContributionKindRefSchema = exports.ContributionKindRefParseError = exports.ContributedContributionKindSchema = exports.CONTRIBUTED_KIND_SEPARATOR = exports.CONTRIBUTED_KIND_LOCAL_PATTERN = exports.CONTRIBUTION_NAMESPACE_PATTERN = exports.CONTRIBUTION_NAMESPACE_SOURCE = void 0;
+exports.isContributedContributionKindValue = isContributedContributionKindValue;
+exports.formatContributedContributionKind = formatContributedContributionKind;
+exports.parseContributedContributionKind = parseContributedContributionKind;
+exports.resolveContributionKind = resolveContributionKind;
+exports.isPlatformContributionKind = isPlatformContributionKind;
+exports.assertContributedKindDeclaredBy = assertContributedKindDeclaredBy;
+const zod_1 = require("zod");
+const contribution_kind_1 = require("./contribution-kind");
+exports.CONTRIBUTION_NAMESPACE_SOURCE = '[a-z][a-z0-9-]*';
+exports.CONTRIBUTION_NAMESPACE_PATTERN = new RegExp(`^${exports.CONTRIBUTION_NAMESPACE_SOURCE}$`);
+exports.CONTRIBUTED_KIND_LOCAL_PATTERN = /^[a-z][a-z0-9-]{0,62}$/;
+exports.CONTRIBUTED_KIND_SEPARATOR = ':';
+exports.ContributedContributionKindSchema = zod_1.z
+    .object({
+    biomeId: zod_1.z
+        .string()
+        .regex(exports.CONTRIBUTION_NAMESPACE_PATTERN, 'the declaring biome id must be kebab-case (a-z, 0-9, -), starting with a letter'),
+    key: zod_1.z
+        .string()
+        .regex(exports.CONTRIBUTED_KIND_LOCAL_PATTERN, 'a declared kind key must be lower-kebab (a-z, 0-9, -), starting with a letter, at most 63 characters'),
+})
+    .strict();
+class ContributionKindRefParseError extends Error {
+    code = 'CONTRIBUTION_KIND_REF_INVALID';
+    raw;
+    constructor(message, raw) {
+        super(message);
+        this.name = 'ContributionKindRefParseError';
+        this.raw = raw;
+    }
+}
+exports.ContributionKindRefParseError = ContributionKindRefParseError;
+function isContributedContributionKindValue(raw) {
+    return raw.includes(exports.CONTRIBUTED_KIND_SEPARATOR);
+}
+function formatContributedContributionKind(kind) {
+    const parsed = exports.ContributedContributionKindSchema.parse(kind);
+    return `${parsed.biomeId}${exports.CONTRIBUTED_KIND_SEPARATOR}${parsed.key}`;
+}
+function parseContributedContributionKind(raw) {
+    const at = raw.indexOf(exports.CONTRIBUTED_KIND_SEPARATOR);
+    if (at <= 0 || at === raw.length - 1) {
+        throw new ContributionKindRefParseError(`A biome-declared contribution kind must be "<biomeId>${exports.CONTRIBUTED_KIND_SEPARATOR}<key>" ` +
+            `(e.g. "document-buddy${exports.CONTRIBUTED_KIND_SEPARATOR}template-pack"); got "${raw}".`, raw);
+    }
+    const candidate = {
+        biomeId: raw.slice(0, at),
+        key: raw.slice(at + exports.CONTRIBUTED_KIND_SEPARATOR.length),
+    };
+    const parsed = exports.ContributedContributionKindSchema.safeParse(candidate);
+    if (!parsed.success) {
+        throw new ContributionKindRefParseError(`"${raw}" is not a legal biome-declared contribution kind: ` +
+            parsed.error.issues
+                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                .join('; '), raw);
+    }
+    return parsed.data;
+}
+const PLATFORM_KIND_VALUES = new Set(Object.values(contribution_kind_1.ContributionKind));
+function resolveContributionKind(raw) {
+    if (isContributedContributionKindValue(raw)) {
+        const kind = parseContributedContributionKind(raw);
+        return {
+            platform: false,
+            kind,
+            ref: formatContributedContributionKind(kind),
+        };
+    }
+    if (PLATFORM_KIND_VALUES.has(raw)) {
+        return { platform: true, kind: raw };
+    }
+    throw new ContributionKindRefParseError(`"${raw}" is neither a kernel ContributionKind nor a biome-declared kind. ` +
+        `A kernel kind must be one of: ${[...PLATFORM_KIND_VALUES].sort().join(', ')}. ` +
+        `A biome-declared kind must be written "<biomeId>${exports.CONTRIBUTED_KIND_SEPARATOR}<key>".`, raw);
+}
+function isPlatformContributionKind(raw) {
+    return PLATFORM_KIND_VALUES.has(raw);
+}
+exports.ContributionKindRefSchema = zod_1.z
+    .string()
+    .superRefine((value, ctx) => {
+    try {
+        resolveContributionKind(value);
+    }
+    catch (error) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+});
+function assertContributedKindDeclaredBy(ref, declaringBiomeId) {
+    const kind = parseContributedContributionKind(ref);
+    if (kind.biomeId !== declaringBiomeId) {
+        throw new ContributionKindRefParseError(`Declared kind "${ref}" names biome "${kind.biomeId}", but it is declared by ` +
+            `"${declaringBiomeId}". The biome half of a declared kind is PROVENANCE — it is ` +
+            `stamped from the contribution owner, never authored — so a biome may not declare ` +
+            `a kind in another biome's namespace.`, ref);
+    }
+    return kind;
+}
+//# sourceMappingURL=contributed-contribution-kind.js.map

package/dist/contribution/lib/contributed-contribution-kind.js.map

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

package/dist/contribution/lib/contribution-kind-descriptor.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { type CapabilityRef } from '../../capability';
+export interface ContributionKindDescriptorContributionManifest {
+    readonly key: string;
+    readonly version: string;
+    readonly displayName: string;
+    readonly description?: string | undefined;
+    readonly contentSchema: Record<string, unknown>;
+    readonly handler: CapabilityRef;
+    readonly validator?: CapabilityRef | undefined;
+}
+export declare const ContributionKindDescriptorContributionManifestSchema: z.ZodType<ContributionKindDescriptorContributionManifest>;
+//# sourceMappingURL=contribution-kind-descriptor.d.ts.map

package/dist/contribution/lib/contribution-kind-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-kind-descriptor.d.ts","sourceRoot":"","sources":["../../../src/contribution/lib/contribution-kind-descriptor.ts"],"names":[],"mappings":"AAqDA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAa3E,MAAM,WAAW,8CAA8C;IAW7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAMrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAY1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKhD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAShC,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAChD;AAiBD,eAAO,MAAM,oDAAoD,EAAE,CAAC,CAAC,OAAO,CAAC,8CAA8C,CAkBtC,CAAC"}

package/dist/contribution/lib/contribution-kind-descriptor.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContributionKindDescriptorContributionManifestSchema = void 0;
+const zod_1 = require("zod");
+const capability_1 = require("../../capability");
+const contributed_contribution_kind_1 = require("./contributed-contribution-kind");
+const CONTRIBUTION_KIND_STRING_MAX = 200;
+const KeySchema = zod_1.z
+    .string()
+    .regex(contributed_contribution_kind_1.CONTRIBUTED_KIND_LOCAL_PATTERN, 'a declared kind key must be lower-kebab (a-z, 0-9, -), starting with a letter, at most 63 characters')
+    .refine((value) => !value.includes(contributed_contribution_kind_1.CONTRIBUTED_KIND_SEPARATOR), {
+    message: `a declared kind key is BARE — the "<biomeId>${contributed_contribution_kind_1.CONTRIBUTED_KIND_SEPARATOR}" qualifier is ` +
+        'provenance, stamped by the receiver from the contribution owner, and must not be authored here',
+});
+exports.ContributionKindDescriptorContributionManifestSchema = zod_1.z
+    .object({
+    key: KeySchema,
+    version: zod_1.z
+        .string()
+        .regex(/^\d+\.\d+\.\d+$/, 'version must be semver MAJOR.MINOR.PATCH'),
+    displayName: zod_1.z.string().min(1).max(CONTRIBUTION_KIND_STRING_MAX),
+    description: zod_1.z.string().max(2000).optional(),
+    contentSchema: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.unknown())
+        .refine((schema) => Object.keys(schema).length > 0, 'contentSchema must be a non-empty JSON Schema object — a declared kind whose shape admits anything cannot be validated at the two seams that would otherwise catch a malformed contribution'),
+    handler: capability_1.CapabilityRefSchema,
+    validator: capability_1.CapabilityRefSchema.optional(),
+})
+    .strict();
+//# sourceMappingURL=contribution-kind-descriptor.js.map

package/dist/contribution/lib/contribution-kind-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-kind-descriptor.js","sourceRoot":"","sources":["../../../src/contribution/lib/contribution-kind-descriptor.ts"],"names":[],"mappings":";;;AAqDA,6BAAwB;AAExB,iDAA2E;AAC3E,mFAGyC;AAGzC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAwDzC,MAAM,SAAS,GAAG,OAAC;KAChB,MAAM,EAAE;KACR,KAAK,CACJ,8DAA8B,EAC9B,sGAAsG,CACvG;KACA,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,0DAA0B,CAAC,EAAE;IAI9D,OAAO,EACL,+CAA+C,0DAA0B,iBAAiB;QAC1F,gGAAgG;CACnG,CAAC,CAAC;AAEQ,QAAA,oDAAoD,GAC/D,OAAC;KACE,MAAM,CAAC;IACN,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,iBAAiB,EAAE,0CAA0C,CAAC;IACvE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,4BAA4B,CAAC;IAChE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC5C,aAAa,EAAE,OAAC;SACb,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAC1C,6LAA6L,CAC9L;IACH,OAAO,EAAE,gCAAmB;IAC5B,SAAS,EAAE,gCAAmB,CAAC,QAAQ,EAAE;CAC1C,CAAC;KACD,MAAM,EAA0E,CAAC"}

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

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+export declare enum ContributionKind {
+    WorkflowStep = "workflow-step",
+    AgentSkill = "agent-skill",
+    AgentKernel = "agent-kernel",
+    WorkKind = "work-kind",
+    WidgetKind = "widget-kind",
+    SurfaceKind = "surface-kind",
+    ArtifactType = "artifact-type",
+    TemplateKind = "template-kind",
+    DesignSystemKind = "design-system-kind",
+    Template = "template",
+    DesignSystem = "design-system",
+    InquiryKind = "inquiry-kind",
+    RoleCapability = "role-capability",
+    BiomeInstallSchema = "biome-install-schema",
+    Icon = "icon",
+    ProjectKit = "project-kit",
+    ProvisioningScaffold = "provisioning-scaffold",
+    ConnectorAdapter = "connector-adapter",
+    InboundEndpoint = "inbound-endpoint",
+    WorkflowConfig = "workflow-config",
+    DeliverableSpec = "deliverable-spec",
+    WorkspaceManifest = "workspace-manifest",
+    ToolProfile = "tool-profile",
+    McpCatalog = "mcp-catalog",
+    OpenCodeTool = "opencode-tool",
+    OpenCodePlugin = "opencode-plugin",
+    Capability = "capability",
+    ResourceOwnership = "resource-ownership",
+    ResourceDefinition = "resource-definition",
+    StageMachine = "stage-machine",
+    SearchType = "search-type",
+    CredentialStrategy = "credential-strategy",
+    CanonicalObjectType = "canonical-object-type",
+    ResourceRole = "resource-role",
+    IngestionSource = "ingestion-source",
+    ContributionKindDescriptor = "contribution-kind"
+}
+export declare const ContributionKindSchema: z.ZodEnum<typeof ContributionKind>;
+export type ContributionKindValue = `${ContributionKind}`;
+//# sourceMappingURL=contribution-kind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-kind.d.ts","sourceRoot":"","sources":["../../../src/contribution/lib/contribution-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqFxB,oBAAY,gBAAgB;IAW1B,YAAY,kBAAkB;IAC9B,UAAU,gBAAgB;IAC1B,WAAW,iBAAiB;IAkC5B,QAAQ,cAAc;IACtB,UAAU,gBAAgB;IA2B1B,WAAW,iBAAiB;IAQ5B,YAAY,kBAAkB;IAE9B,YAAY,kBAAkB;IAE9B,gBAAgB,uBAAuB;IAEvC,QAAQ,aAAa;IAErB,YAAY,kBAAkB;IAM9B,WAAW,iBAAiB;IAW5B,cAAc,oBAAoB;IAclC,kBAAkB,yBAAyB;IAY3C,IAAI,SAAS;IAEb,UAAU,gBAAgB;IAe1B,oBAAoB,0BAA0B;IAG9C,gBAAgB,sBAAsB;IAmBtC,eAAe,qBAAqB;IAIpC,cAAc,oBAAoB;IAElC,eAAe,qBAAqB;IAEpC,iBAAiB,uBAAuB;IAMxC,WAAW,iBAAiB;IAI5B,UAAU,gBAAgB;IA4C1B,YAAY,kBAAkB;IAuB9B,cAAc,oBAAoB;IAmClC,UAAU,eAAe;IAezB,iBAAiB,uBAAuB;IAaxC,kBAAkB,wBAAwB;IAc1C,YAAY,kBAAkB;IAkB9B,UAAU,gBAAgB;IAoB1B,kBAAkB,wBAAwB;IAmB1C,mBAAmB,0BAA0B;IA4B7C,YAAY,kBAAkB;IAkB9B,eAAe,qBAAqB;IAoCpC,0BAA0B,sBAAsB;CACjD;AAMD,eAAO,MAAM,sBAAsB,oCAAiC,CAAC;AAErE,MAAM,MAAM,qBAAqB,GAAG,GAAG,gBAAgB,EAAE,CAAC"}

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContributionKindSchema = exports.ContributionKind = void 0;
+const zod_1 = require("zod");
+var ContributionKind;
+(function (ContributionKind) {
+    ContributionKind["WorkflowStep"] = "workflow-step";
+    ContributionKind["AgentSkill"] = "agent-skill";
+    ContributionKind["AgentKernel"] = "agent-kernel";
+    ContributionKind["WorkKind"] = "work-kind";
+    ContributionKind["WidgetKind"] = "widget-kind";
+    ContributionKind["SurfaceKind"] = "surface-kind";
+    ContributionKind["ArtifactType"] = "artifact-type";
+    ContributionKind["TemplateKind"] = "template-kind";
+    ContributionKind["DesignSystemKind"] = "design-system-kind";
+    ContributionKind["Template"] = "template";
+    ContributionKind["DesignSystem"] = "design-system";
+    ContributionKind["InquiryKind"] = "inquiry-kind";
+    ContributionKind["RoleCapability"] = "role-capability";
+    ContributionKind["BiomeInstallSchema"] = "biome-install-schema";
+    ContributionKind["Icon"] = "icon";
+    ContributionKind["ProjectKit"] = "project-kit";
+    ContributionKind["ProvisioningScaffold"] = "provisioning-scaffold";
+    ContributionKind["ConnectorAdapter"] = "connector-adapter";
+    ContributionKind["InboundEndpoint"] = "inbound-endpoint";
+    ContributionKind["WorkflowConfig"] = "workflow-config";
+    ContributionKind["DeliverableSpec"] = "deliverable-spec";
+    ContributionKind["WorkspaceManifest"] = "workspace-manifest";
+    ContributionKind["ToolProfile"] = "tool-profile";
+    ContributionKind["McpCatalog"] = "mcp-catalog";
+    ContributionKind["OpenCodeTool"] = "opencode-tool";
+    ContributionKind["OpenCodePlugin"] = "opencode-plugin";
+    ContributionKind["Capability"] = "capability";
+    ContributionKind["ResourceOwnership"] = "resource-ownership";
+    ContributionKind["ResourceDefinition"] = "resource-definition";
+    ContributionKind["StageMachine"] = "stage-machine";
+    ContributionKind["SearchType"] = "search-type";
+    ContributionKind["CredentialStrategy"] = "credential-strategy";
+    ContributionKind["CanonicalObjectType"] = "canonical-object-type";
+    ContributionKind["ResourceRole"] = "resource-role";
+    ContributionKind["IngestionSource"] = "ingestion-source";
+    ContributionKind["ContributionKindDescriptor"] = "contribution-kind";
+})(ContributionKind || (exports.ContributionKind = ContributionKind = {}));
+exports.ContributionKindSchema = zod_1.z.nativeEnum(ContributionKind);
+//# sourceMappingURL=contribution-kind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-kind.js","sourceRoot":"","sources":["../../../src/contribution/lib/contribution-kind.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAqFxB,IAAY,gBA2dX;AA3dD,WAAY,gBAAgB;IAW1B,kDAA8B,CAAA;IAC9B,8CAA0B,CAAA;IAC1B,gDAA4B,CAAA;IAkC5B,0CAAsB,CAAA;IACtB,8CAA0B,CAAA;IA2B1B,gDAA4B,CAAA;IAQ5B,kDAA8B,CAAA;IAE9B,kDAA8B,CAAA;IAE9B,2DAAuC,CAAA;IAEvC,yCAAqB,CAAA;IAErB,kDAA8B,CAAA;IAM9B,gDAA4B,CAAA;IAW5B,sDAAkC,CAAA;IAclC,+DAA2C,CAAA;IAY3C,iCAAa,CAAA;IAEb,8CAA0B,CAAA;IAe1B,kEAA8C,CAAA;IAG9C,0DAAsC,CAAA;IAmBtC,wDAAoC,CAAA;IAIpC,sDAAkC,CAAA;IAElC,wDAAoC,CAAA;IAEpC,4DAAwC,CAAA;IAMxC,gDAA4B,CAAA;IAI5B,8CAA0B,CAAA;IA4C1B,kDAA8B,CAAA;IAuB9B,sDAAkC,CAAA;IAmClC,6CAAyB,CAAA;IAezB,4DAAwC,CAAA;IAaxC,8DAA0C,CAAA;IAc1C,kDAA8B,CAAA;IAkB9B,8CAA0B,CAAA;IAoB1B,8DAA0C,CAAA;IAmB1C,iEAA6C,CAAA;IA4B7C,kDAA8B,CAAA;IAkB9B,wDAAoC,CAAA;IAoCpC,oEAAgD,CAAA;AAClD,CAAC,EA3dW,gBAAgB,gCAAhB,gBAAgB,QA2d3B;AAMY,QAAA,sBAAsB,GAAG,OAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/contribution/lib/contribution-provenance-rank.d.ts

@@ -0,0 +1,13 @@
+import { BiomeContributionOriginKind } from "./sync";
+export declare const AUTHORED_CONTRIBUTION_RANK = 0;
+export declare const BIOME_CONTRIBUTION_ORIGIN_RANK: Readonly<Record<BiomeContributionOriginKind, number>>;
+export declare const UNSCOPED_CONTRIBUTION_RANK: number;
+export declare function biomeContributionOriginRank(origin: BiomeContributionOriginKind | string): number;
+export interface ContributionProvenance {
+    readonly contributionOriginKind: BiomeContributionOriginKind | string | null | undefined;
+    readonly orgId: string | null;
+}
+export declare function contributionProvenanceRank(row: ContributionProvenance, viewerOrgId: string | null): number;
+export declare function pickContributionProvenanceWinner<T extends ContributionProvenance>(rows: readonly T[], viewerOrgId: string | null): T | undefined;
+export declare function collapseByContributionProvenance<T extends ContributionProvenance>(rows: readonly T[], keyOf: (row: T) => string, viewerOrgId: string | null, onAmbiguous: (key: string, incumbent: T, challenger: T) => T): readonly T[];
+//# sourceMappingURL=contribution-provenance-rank.d.ts.map

package/dist/contribution/lib/contribution-provenance-rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-provenance-rank.d.ts","sourceRoot":"","sources":["../../../src/contribution/lib/contribution-provenance-rank.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAgBrD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAc5C,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CACnD,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAI3C,CAAC;AAeH,eAAO,MAAM,0BAA0B,QACmC,CAAC;AAc3E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAAG,MAAM,GAC3C,MAAM,CAYR;AAcD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,sBAAsB,EAC3B,2BAA2B,GAC3B,MAAM,GACN,IAAI,GACJ,SAAS,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAmBD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,sBAAsB,EAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CAiBR;AAYD,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS,sBAAsB,EAChC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,SAAS,CAW/D;AAaD,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS,sBAAsB,EAEhC,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,EACzB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,GAC3D,SAAS,CAAC,EAAE,CAoBd"}

package/dist/contribution/lib/contribution-provenance-rank.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNSCOPED_CONTRIBUTION_RANK = exports.BIOME_CONTRIBUTION_ORIGIN_RANK = exports.AUTHORED_CONTRIBUTION_RANK = void 0;
+exports.biomeContributionOriginRank = biomeContributionOriginRank;
+exports.contributionProvenanceRank = contributionProvenanceRank;
+exports.pickContributionProvenanceWinner = pickContributionProvenanceWinner;
+exports.collapseByContributionProvenance = collapseByContributionProvenance;
+const sync_1 = require("./sync");
+exports.AUTHORED_CONTRIBUTION_RANK = 0;
+exports.BIOME_CONTRIBUTION_ORIGIN_RANK = Object.freeze({
+    [sync_1.BiomeContributionOriginKind.OrgInstallation]: 1,
+    [sync_1.BiomeContributionOriginKind.Distribution]: 2,
+});
+exports.UNSCOPED_CONTRIBUTION_RANK = exports.BIOME_CONTRIBUTION_ORIGIN_RANK[sync_1.BiomeContributionOriginKind.Distribution];
+function biomeContributionOriginRank(origin) {
+    const rank = exports.BIOME_CONTRIBUTION_ORIGIN_RANK[origin];
+    if (rank === undefined) {
+        throw new Error(`Unknown BiomeContributionOriginKind '${String(origin)}' — cannot rank ` +
+            `it for precedence. Known origins: ` +
+            `${Object.keys(exports.BIOME_CONTRIBUTION_ORIGIN_RANK).join(", ")}.`);
+    }
+    return rank;
+}
+function contributionProvenanceRank(row, viewerOrgId) {
+    const isViewers = row.orgId === viewerOrgId;
+    if (row.contributionOriginKind === null ||
+        row.contributionOriginKind === undefined) {
+        return isViewers ? exports.AUTHORED_CONTRIBUTION_RANK : exports.UNSCOPED_CONTRIBUTION_RANK;
+    }
+    const rank = biomeContributionOriginRank(row.contributionOriginKind);
+    if (row.contributionOriginKind ===
+        sync_1.BiomeContributionOriginKind.OrgInstallation &&
+        !isViewers) {
+        return exports.UNSCOPED_CONTRIBUTION_RANK;
+    }
+    return rank;
+}
+function pickContributionProvenanceWinner(rows, viewerOrgId) {
+    let winner;
+    let winningRank = Number.POSITIVE_INFINITY;
+    for (const row of rows) {
+        const rank = contributionProvenanceRank(row, viewerOrgId);
+        if (rank < winningRank) {
+            winner = row;
+            winningRank = rank;
+        }
+    }
+    return winner;
+}
+function collapseByContributionProvenance(rows, keyOf, viewerOrgId, onAmbiguous) {
+    const byKey = new Map();
+    for (const row of rows) {
+        const key = keyOf(row);
+        const incumbent = byKey.get(key);
+        if (incumbent === undefined) {
+            byKey.set(key, row);
+            continue;
+        }
+        const rank = contributionProvenanceRank(row, viewerOrgId);
+        const incumbentRank = contributionProvenanceRank(incumbent, viewerOrgId);
+        if (rank === incumbentRank) {
+            byKey.set(key, onAmbiguous(key, incumbent, row));
+            continue;
+        }
+        if (rank < incumbentRank) {
+            byKey.set(key, row);
+        }
+    }
+    return [...byKey.values()];
+}
+//# sourceMappingURL=contribution-provenance-rank.js.map

package/dist/contribution/lib/contribution-provenance-rank.js.map

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

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

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { SpaceKind, type SpaceKindSubset } from '../../space';
+export declare const CONTRIBUTION_SPACE_KINDS: SpaceKindSubset;
+export declare const ContributionSourceSchema: z.ZodEnum<typeof SpaceKind>;
+export type ContributionSourceValue = `${SpaceKind}`;
+//# sourceMappingURL=contribution-source.d.ts.map