@relkit/contracts 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @relkit/contracts
+
+Unsupported internal RELKIT contracts; use @relkit/app.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/descriptor.d.ts

@@ -0,0 +1,38 @@
+import { type DescriptorKind, type Ref } from "./id.js";
+/** The shared runtime brand used by every RelKit descriptor factory. */
+export declare const RELKIT_DESCRIPTOR: unique symbol;
+/** Common serializable metadata shared by all public descriptors. */
+export interface DescriptorMetadata {
+    readonly title?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+}
+/** The immutable common shape implemented by every public descriptor. */
+export interface DescriptorBase<Kind extends DescriptorKind, Id extends string = string> extends DescriptorMetadata {
+    readonly [RELKIT_DESCRIPTOR]: true;
+    readonly kind: Kind;
+    readonly id: Id;
+    readonly ref: Ref<Kind, Id>;
+}
+/** A descriptor whose concrete kind and ID are not known by the caller. */
+export type DescriptorAny = DescriptorBase<DescriptorKind, string>;
+/** Creates a normalized immutable reference without deriving identity from a path. */
+export declare function createRef<Kind extends DescriptorKind, Id extends string>(kind: Kind, id: Id): Ref<Kind, Id>;
+/** Returns whether a value is a supported descriptor kind. */
+export declare function isDescriptorKind(value: unknown): value is DescriptorKind;
+/** Returns whether a value has the exact portable descriptor-reference shape. */
+export declare function isRef(value: unknown): value is Ref<DescriptorKind, string>;
+export declare function isRef<Kind extends DescriptorKind>(value: unknown, kind: Kind): value is Ref<Kind, string>;
+/** Asserts that a value is a valid descriptor reference. */
+export declare function assertRef(value: unknown): asserts value is Ref<DescriptorKind, string>;
+export declare function assertRef<Kind extends DescriptorKind>(value: unknown, kind: Kind): asserts value is Ref<Kind, string>;
+/** Returns whether a value is a branded descriptor with a matching stable reference. */
+export declare function isDescriptor(value: unknown): value is DescriptorAny;
+export declare function isDescriptor<Kind extends DescriptorKind>(value: unknown, kind: Kind): value is DescriptorBase<Kind, string>;
+/** Asserts that a value is a branded descriptor with a valid stable reference. */
+export declare function assertDescriptor(value: unknown): asserts value is DescriptorAny;
+/** Builds the shared descriptor fields used by later pure public factories. */
+export declare function createDescriptorBase<Kind extends DescriptorKind, Id extends string>(kind: Kind, id: Id, metadata?: DescriptorMetadata): DescriptorBase<Kind, Id>;
+/** Recursively freezes object data without invoking accessors or looping on cycles. */
+export declare function deepFreeze<T>(value: T): T;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../src/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,GAAG,EAA2B,MAAM,SAAS,CAAC;AAEjF,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAwC,CAAC;AAEhF,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc,CAC7B,IAAI,SAAS,cAAc,EAC3B,EAAE,SAAS,MAAM,GAAG,MAAM,CAC1B,SAAQ,kBAAkB;IAC1B,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;CAC7B;AAED,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AAoBnE,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,SAAS,cAAc,EAAE,EAAE,SAAS,MAAM,EACtE,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,EAAE,GACL,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAEf;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AAC5E,wBAAgB,KAAK,CAAC,IAAI,SAAS,cAAc,EAC/C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,IAAI,GACT,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAW9B,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AACxF,wBAAgB,SAAS,CAAC,IAAI,SAAS,cAAc,EACnD,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAOtC,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC;AACrE,wBAAgB,YAAY,CAAC,IAAI,SAAS,cAAc,EACtD,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,IAAI,GACT,KAAK,IAAI,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAgBzC,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAE/E;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,IAAI,SAAS,cAAc,EAAE,EAAE,SAAS,MAAM,EACjF,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,EAAE,EACN,QAAQ,GAAE,kBAAuB,GAChC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAY1B;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAGzC"}

package/dist/descriptor.js

@@ -0,0 +1,96 @@
+import { isStableId, normalizeId } from "./id.js";
+/** The shared runtime brand used by every RelKit descriptor factory. */
+export const RELKIT_DESCRIPTOR = Symbol.for("relkit.descriptor");
+const descriptorKinds = [
+    "app",
+    "function",
+    "service",
+    "route",
+    "middleware",
+    "job",
+    "event",
+    "event-trigger",
+    "bucket",
+    "cache",
+    "tool",
+    "agent",
+    "data-model",
+    "constants",
+    "prompt",
+];
+/** Creates a normalized immutable reference without deriving identity from a path. */
+export function createRef(kind, id) {
+    return Object.freeze({ kind, id: normalizeId(id) });
+}
+/** Returns whether a value is a supported descriptor kind. */
+export function isDescriptorKind(value) {
+    return typeof value === "string" && descriptorKinds.includes(value);
+}
+export function isRef(value, kind) {
+    if (!isRecord(value) || !hasOwn(value, "kind") || !hasOwn(value, "id"))
+        return false;
+    return (Reflect.ownKeys(value).length === 2 &&
+        isDescriptorKind(value.kind) &&
+        isStableId(value.id) &&
+        (kind === undefined || value.kind === kind));
+}
+export function assertRef(value, kind) {
+    if (!isRef(value) || (kind !== undefined && value.kind !== kind)) {
+        throw new TypeError("Invalid RelKit descriptor reference");
+    }
+}
+export function isDescriptor(value, kind) {
+    if (!isRecord(value) || !hasOwn(value, RELKIT_DESCRIPTOR) || value[RELKIT_DESCRIPTOR] !== true) {
+        return false;
+    }
+    if (!hasOwn(value, "kind") || !hasOwn(value, "id") || !hasOwn(value, "ref"))
+        return false;
+    return (isDescriptorKind(value.kind) &&
+        (kind === undefined || value.kind === kind) &&
+        isStableId(value.id) &&
+        isRef(value.ref) &&
+        value.ref.kind === value.kind &&
+        value.ref.id === value.id);
+}
+/** Asserts that a value is a branded descriptor with a valid stable reference. */
+export function assertDescriptor(value) {
+    if (!isDescriptor(value))
+        throw new TypeError("Invalid RelKit descriptor");
+}
+/** Builds the shared descriptor fields used by later pure public factories. */
+export function createDescriptorBase(kind, id, metadata = {}) {
+    const tags = metadata.tags === undefined ? undefined : Object.freeze([...metadata.tags]);
+    const value = {
+        [RELKIT_DESCRIPTOR]: true,
+        kind,
+        id: normalizeId(id),
+        ...(metadata.title === undefined ? {} : { title: metadata.title }),
+        ...(metadata.description === undefined ? {} : { description: metadata.description }),
+        ...(tags === undefined ? {} : { tags }),
+        ref: createRef(kind, id),
+    };
+    return deepFreeze(value);
+}
+/** Recursively freezes object data without invoking accessors or looping on cycles. */
+export function deepFreeze(value) {
+    freezeObject(value, new WeakSet());
+    return value;
+}
+function freezeObject(value, seen) {
+    if (value === null || typeof value !== "object" || seen.has(value))
+        return;
+    seen.add(value);
+    for (const key of Reflect.ownKeys(value)) {
+        const property = Object.getOwnPropertyDescriptor(value, key);
+        if (property && "value" in property)
+            freezeObject(property.value, seen);
+    }
+    Object.freeze(value);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/descriptor.js.map

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

package/dist/id.d.ts

@@ -0,0 +1,49 @@
+declare const StableIdBrand: unique symbol;
+declare const ProtocolIdBrand: unique symbol;
+/** A validated identifier whose value is independent of a source path. */
+export type StableId = string & {
+    readonly [StableIdBrand]: "StableId";
+};
+/** Alias used by descriptor contracts for stable IDs. */
+export type DescriptorId = StableId;
+/** A stable identifier used to address a versioned protocol value. */
+export type ProtocolId<Name extends string = "ProtocolId"> = StableId & {
+    readonly [ProtocolIdBrand]: Name;
+};
+export type GraphHash = ProtocolId<"GraphHash">;
+export type GenerationId = ProtocolId<"GenerationId">;
+export type RequestId = ProtocolId<"RequestId">;
+export type TraceId = ProtocolId<"TraceId">;
+export type InvocationId = ProtocolId<"InvocationId">;
+export type EventInstanceId = ProtocolId<"EventInstanceId">;
+/** The descriptor kinds represented by the public v3 contracts. */
+export type DescriptorKind = "app" | "function" | "service" | "route" | "middleware" | "job" | "event" | "event-trigger" | "bucket" | "cache" | "tool" | "agent" | "data-model" | "constants" | "prompt";
+/** A typed reference to a descriptor identified by an explicit stable ID. */
+export interface Ref<Kind extends DescriptorKind, Id extends string = string> {
+    readonly kind: Kind;
+    readonly id: Id;
+}
+/** Raised when an identifier is missing or cannot be normalized safely. */
+export declare class StableIdError extends TypeError {
+    constructor(reason: string);
+}
+export { StableIdError as IdError, StableIdError as IdValidationError };
+/** Trims and validates an explicit stable ID without deriving it from a path. */
+export declare function normalizeId(value: unknown): StableId;
+/** Returns whether a value is already a canonical stable ID. */
+export declare function isStableId(value: unknown): value is StableId;
+export declare const isValidId: typeof isStableId;
+/** Asserts that a value is already a canonical stable ID. */
+export declare function assertStableId(value: unknown): asserts value is StableId;
+export declare const assertValidId: typeof assertStableId;
+/** Normalizes an explicit protocol ID while preserving its nominal type. */
+export declare function normalizeProtocolId(value: unknown): ProtocolId;
+/** Returns whether a value is a canonical protocol ID. */
+export declare function isProtocolId(value: unknown): value is ProtocolId;
+export declare const toGraphHash: (value: unknown) => GraphHash;
+export declare const toGenerationId: (value: unknown) => GenerationId;
+export declare const toRequestId: (value: unknown) => RequestId;
+export declare const toTraceId: (value: unknown) => TraceId;
+export declare const toInvocationId: (value: unknown) => InvocationId;
+export declare const toEventInstanceId: (value: unknown) => EventInstanceId;
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC;AAE7C,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzE,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AAEpC,sEAAsE;AACtE,MAAM,MAAM,UAAU,CAAC,IAAI,SAAS,MAAM,GAAG,YAAY,IAAI,QAAQ,GAAG;IACtE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAE5D,mEAAmE;AACnE,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,UAAU,GACV,SAAS,GACT,OAAO,GACP,YAAY,GACZ,KAAK,GACL,OAAO,GACP,eAAe,GACf,QAAQ,GACR,OAAO,GACP,MAAM,GACN,OAAO,GACP,YAAY,GACZ,WAAW,GACX,QAAQ,CAAC;AAEb,6EAA6E;AAC7E,MAAM,WAAW,GAAG,CAAC,IAAI,SAAS,cAAc,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM;IAC1E,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;CACjB;AAED,2EAA2E;AAC3E,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,MAAM,EAAE,MAAM;CAI3B;AAED,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,CAAC;AAExE,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAapD;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAG5D;AAED,eAAO,MAAM,SAAS,mBAAa,CAAC;AAEpC,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAIxE;AAED,eAAO,MAAM,aAAa,uBAAiB,CAAC;AAE5C,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAE9D;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,SACO,CAAC;AACrD,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,YACO,CAAC;AACxD,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,SACO,CAAC;AACrD,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,OACO,CAAC;AACnD,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,YACO,CAAC;AACxD,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,eACO,CAAC"}

package/dist/id.js

@@ -0,0 +1,52 @@
+const STABLE_ID_PATTERN = /^[A-Za-z0-9]+(?:[._-][A-Za-z0-9]+)*$/;
+/** Raised when an identifier is missing or cannot be normalized safely. */
+export class StableIdError extends TypeError {
+    constructor(reason) {
+        super(`Invalid stable ID: ${reason}`);
+        this.name = "StableIdError";
+    }
+}
+export { StableIdError as IdError, StableIdError as IdValidationError };
+/** Trims and validates an explicit stable ID without deriving it from a path. */
+export function normalizeId(value) {
+    if (typeof value !== "string") {
+        throw new StableIdError("expected a string");
+    }
+    const normalized = value.normalize("NFC").trim();
+    if (normalized.length === 0) {
+        throw new StableIdError("expected a non-empty value");
+    }
+    if (!STABLE_ID_PATTERN.test(normalized)) {
+        throw new StableIdError("use letters, numbers, '.', '_' or '-' between alphanumeric segments");
+    }
+    return normalized;
+}
+/** Returns whether a value is already a canonical stable ID. */
+export function isStableId(value) {
+    if (typeof value !== "string" || value !== value.trim())
+        return false;
+    return STABLE_ID_PATTERN.test(value);
+}
+export const isValidId = isStableId;
+/** Asserts that a value is already a canonical stable ID. */
+export function assertStableId(value) {
+    if (!isStableId(value)) {
+        throw new StableIdError("expected a canonical stable ID");
+    }
+}
+export const assertValidId = assertStableId;
+/** Normalizes an explicit protocol ID while preserving its nominal type. */
+export function normalizeProtocolId(value) {
+    return normalizeId(value);
+}
+/** Returns whether a value is a canonical protocol ID. */
+export function isProtocolId(value) {
+    return isStableId(value);
+}
+export const toGraphHash = (value) => normalizeProtocolId(value);
+export const toGenerationId = (value) => normalizeProtocolId(value);
+export const toRequestId = (value) => normalizeProtocolId(value);
+export const toTraceId = (value) => normalizeProtocolId(value);
+export const toInvocationId = (value) => normalizeProtocolId(value);
+export const toEventInstanceId = (value) => normalizeProtocolId(value);
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,sCAAsC,CAAC;AA+CjE,2EAA2E;AAC3E,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,YAAY,MAAc;QACxB,KAAK,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,CAAC;AAExE,iFAAiF;AACjF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CAAC,4BAA4B,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,aAAa,CAAC,qEAAqE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,UAAsB,CAAC;AAChC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IACtE,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;AAEpC,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,aAAa,CAAC,gCAAgC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,WAAW,CAAC,KAAK,CAAe,CAAC;AAC1C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAa,EAAE,CACvD,mBAAmB,CAAC,KAAK,CAAyB,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAgB,EAAE,CAC7D,mBAAmB,CAAC,KAAK,CAA4B,CAAC;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAa,EAAE,CACvD,mBAAmB,CAAC,KAAK,CAAyB,CAAC;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAW,EAAE,CACnD,mBAAmB,CAAC,KAAK,CAAuB,CAAC;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAgB,EAAE,CAC7D,mBAAmB,CAAC,KAAK,CAA4B,CAAC;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAmB,EAAE,CACnE,mBAAmB,CAAC,KAAK,CAA+B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./id.js";
+export * from "./descriptor.js";
+export * from "./json.js";
+export * from "./source-location.js";
+export * from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./id.js";
+export * from "./descriptor.js";
+export * from "./json.js";
+export * from "./source-location.js";
+export * from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/json.d.ts

@@ -0,0 +1,27 @@
+/** A value or a promise of that value. */
+export type MaybePromise<T> = T | Promise<T>;
+/** Values represented directly by JSON. Non-finite numbers are rejected at runtime. */
+export type JsonPrimitive = string | number | boolean | null;
+/** A recursively JSON-serializable value. */
+export type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+/** Raised when a value cannot cross the JSON boundary. */
+export declare class JsonValueError extends TypeError {
+    readonly path: string;
+    constructor(path: string, reason: string);
+}
+/** Returns whether a value is a JSON primitive accepted by RelKit. */
+export declare function isJsonPrimitive(value: unknown): value is JsonPrimitive;
+/** Returns whether a value is recursively JSON-safe. */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+/** Asserts that a value is recursively JSON-safe. */
+export declare function assertJsonValue(value: unknown): asserts value is JsonValue;
+/**
+ * Serializes JSON deterministically by sorting every object key at every depth.
+ * Undefined values, executable values, cycles, and non-JSON objects are errors.
+ */
+export declare function serializeJson(value: unknown): string;
+/** Alias for the one canonical JSON serializer. */
+export declare const canonicalJson: typeof serializeJson;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GACnB,aAAa,GAAG,SAAS,SAAS,EAAE,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/E,0DAA0D;AAC1D,qBAAa,cAAe,SAAQ,SAAS;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAKzC;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAO9D;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAE1E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,mDAAmD;AACnD,eAAO,MAAM,aAAa,sBAAgB,CAAC"}

package/dist/json.js

@@ -0,0 +1,125 @@
+/** Raised when a value cannot cross the JSON boundary. */
+export class JsonValueError extends TypeError {
+    path;
+    constructor(path, reason) {
+        super(`Invalid JSON value at ${path}: ${reason}`);
+        this.name = "JsonValueError";
+        this.path = path;
+    }
+}
+/** Returns whether a value is a JSON primitive accepted by RelKit. */
+export function isJsonPrimitive(value) {
+    return (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean" ||
+        (typeof value === "number" && Number.isFinite(value)));
+}
+/** Returns whether a value is recursively JSON-safe. */
+export function isJsonValue(value) {
+    try {
+        serializeJson(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Asserts that a value is recursively JSON-safe. */
+export function assertJsonValue(value) {
+    serializeJson(value);
+}
+/**
+ * Serializes JSON deterministically by sorting every object key at every depth.
+ * Undefined values, executable values, cycles, and non-JSON objects are errors.
+ */
+export function serializeJson(value) {
+    return serialize(value, "$", new Set());
+}
+/** Alias for the one canonical JSON serializer. */
+export const canonicalJson = serializeJson;
+function serialize(value, path, active) {
+    if (isJsonPrimitive(value))
+        return JSON.stringify(value);
+    switch (typeof value) {
+        case "undefined":
+            throw new JsonValueError(path, "undefined is not JSON data");
+        case "function":
+            throw new JsonValueError(path, "functions are not JSON data");
+        case "symbol":
+            throw new JsonValueError(path, "symbols are not JSON data");
+        case "bigint":
+            throw new JsonValueError(path, "bigints are not JSON data");
+        case "number":
+            throw new JsonValueError(path, "non-finite numbers are not JSON data");
+        case "object":
+            return serializeObject(value, path, active);
+        default:
+            throw new JsonValueError(path, "value is not JSON data");
+    }
+}
+function serializeObject(value, path, active) {
+    if (active.has(value))
+        throw new JsonValueError(path, "cycles are not JSON data");
+    active.add(value);
+    try {
+        if (Array.isArray(value))
+            return serializeArray(value, path, active);
+        if (!isPlainObject(value)) {
+            throw new JsonValueError(path, "only arrays and plain objects are JSON data");
+        }
+        return serializeRecord(value, path, active);
+    }
+    finally {
+        active.delete(value);
+    }
+}
+function serializeArray(value, path, active) {
+    if (Object.getPrototypeOf(value) !== Array.prototype) {
+        throw new JsonValueError(path, "only ordinary arrays are JSON data");
+    }
+    rejectSymbolKeys(value, path);
+    for (const key of Object.getOwnPropertyNames(value)) {
+        if (key !== "length" && !isArrayIndex(key, value.length)) {
+            throw new JsonValueError(path, "array properties are not JSON data");
+        }
+    }
+    const items = [];
+    for (let index = 0; index < value.length; index += 1) {
+        if (!Object.prototype.hasOwnProperty.call(value, index)) {
+            throw new JsonValueError(`${path}[${index}]`, "sparse arrays are not JSON data");
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+        if (!descriptor || !("value" in descriptor)) {
+            throw new JsonValueError(`${path}[${index}]`, "accessor properties are not JSON data");
+        }
+        items.push(serialize(descriptor.value, `${path}[${index}]`, active));
+    }
+    return `[${items.join(",")}]`;
+}
+function serializeRecord(value, path, active) {
+    rejectSymbolKeys(value, path);
+    const keys = Object.keys(value).sort();
+    const entries = [];
+    for (const key of keys) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor || !("value" in descriptor)) {
+            throw new JsonValueError(`${path}[${JSON.stringify(key)}]`, "accessor properties are not JSON data");
+        }
+        entries.push(`${JSON.stringify(key)}:${serialize(descriptor.value, `${path}[${JSON.stringify(key)}]`, active)}`);
+    }
+    return `{${entries.join(",")}}`;
+}
+function rejectSymbolKeys(value, path) {
+    if (Object.getOwnPropertySymbols(value).length > 0) {
+        throw new JsonValueError(path, "symbol keys are not JSON data");
+    }
+}
+function isPlainObject(value) {
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === null || prototype === Object.prototype;
+}
+function isArrayIndex(key, length) {
+    const index = Number(key);
+    return Number.isInteger(index) && index >= 0 && index < length && String(index) === key;
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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

package/dist/source-location.d.ts

@@ -0,0 +1,23 @@
+/** A source file path normalized relative to a project root. */
+export type ProjectRelativePath = string;
+/** A portable source position used by diagnostics and graph metadata. */
+export interface SourceLocation {
+    readonly file: ProjectRelativePath;
+    readonly line: number;
+    readonly column: number;
+}
+/** Raised when a source path or position cannot be represented portably. */
+export declare class SourceLocationError extends TypeError {
+    constructor(reason: string);
+}
+/**
+ * Returns a project-relative path with `/` separators.
+ * Absolute inputs require an absolute project root and must remain inside it.
+ */
+export declare function normalizeSourcePath(filePath: string, projectRoot?: string): ProjectRelativePath;
+export declare const toProjectRelativePath: typeof normalizeSourcePath;
+/** Creates a portable source location from a path and one-based coordinates. */
+export declare function createSourceLocation(filePath: string, line: number, column: number, projectRoot?: string): SourceLocation;
+/** Normalizes a source-location record without changing its identity fields. */
+export declare function normalizeSourceLocation(location: SourceLocation, projectRoot?: string): SourceLocation;
+//# sourceMappingURL=source-location.d.ts.map

package/dist/source-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.d.ts","sourceRoot":"","sources":["../src/source-location.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,4EAA4E;AAC5E,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,MAAM,EAAE,MAAM;CAI3B;AASD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,mBAAmB,CA4B/F;AAED,eAAO,MAAM,qBAAqB,4BAAsB,CAAC;AAEzD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,cAAc,CAShB;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,cAAc,CAEhB"}

package/dist/source-location.js

@@ -0,0 +1,104 @@
+/** Raised when a source path or position cannot be represented portably. */
+export class SourceLocationError extends TypeError {
+    constructor(reason) {
+        super(`Invalid source location: ${reason}`);
+        this.name = "SourceLocationError";
+    }
+}
+/**
+ * Returns a project-relative path with `/` separators.
+ * Absolute inputs require an absolute project root and must remain inside it.
+ */
+export function normalizeSourcePath(filePath, projectRoot) {
+    if (typeof filePath !== "string") {
+        throw new SourceLocationError("file must be a string");
+    }
+    const file = parsePath(filePath, "file");
+    if (projectRoot === undefined) {
+        if (file.absolute) {
+            throw new SourceLocationError("an absolute file requires an absolute project root");
+        }
+        return joinSegments(file.segments);
+    }
+    if (typeof projectRoot !== "string") {
+        throw new SourceLocationError("project root must be a string");
+    }
+    const root = parsePath(projectRoot, "project root");
+    if (!root.absolute) {
+        throw new SourceLocationError("project root must be absolute");
+    }
+    if (!file.absolute)
+        return joinSegments(file.segments);
+    if (file.caseInsensitive !== root.caseInsensitive || !isWithin(file, root)) {
+        throw new SourceLocationError("file must be inside the project root");
+    }
+    const relative = file.segments.slice(root.segments.length);
+    return joinSegments(relative);
+}
+export const toProjectRelativePath = normalizeSourcePath;
+/** Creates a portable source location from a path and one-based coordinates. */
+export function createSourceLocation(filePath, line, column, projectRoot) {
+    const file = normalizeSourcePath(filePath, projectRoot);
+    if (!Number.isInteger(line) || line < 1) {
+        throw new SourceLocationError("line must be a positive integer");
+    }
+    if (!Number.isInteger(column) || column < 1) {
+        throw new SourceLocationError("column must be a positive integer");
+    }
+    return { file, line, column };
+}
+/** Normalizes a source-location record without changing its identity fields. */
+export function normalizeSourceLocation(location, projectRoot) {
+    return createSourceLocation(location.file, location.line, location.column, projectRoot);
+}
+function parsePath(value, label) {
+    if (value.length === 0 || value.includes("\0")) {
+        throw new SourceLocationError(`${label} must be a non-empty path`);
+    }
+    const slashPath = value.replaceAll("\\", "/");
+    const drive = /^([A-Za-z]):(?:\/|$)/.exec(slashPath);
+    const isUnc = slashPath.startsWith("//");
+    const absolute = Boolean(drive) || isUnc || slashPath.startsWith("/");
+    const caseInsensitive = Boolean(drive) || isUnc;
+    const rootKey = drive ? `${drive[1]?.toLowerCase()}:` : isUnc ? "unc" : absolute ? "/" : "";
+    const body = drive
+        ? slashPath.slice(2)
+        : isUnc
+            ? slashPath.slice(2)
+            : absolute
+                ? slashPath.slice(1)
+                : slashPath;
+    const segments = [];
+    for (const segment of body.split("/")) {
+        if (segment === "" || segment === ".")
+            continue;
+        if (segment.includes(":")) {
+            throw new SourceLocationError(`${label} contains an invalid ':' segment`);
+        }
+        if (segment === "..") {
+            if (segments.length === 0) {
+                if (absolute)
+                    continue;
+                throw new SourceLocationError(`${label} cannot escape its root`);
+            }
+            segments.pop();
+            continue;
+        }
+        segments.push(segment);
+    }
+    return { absolute, caseInsensitive, rootKey, segments };
+}
+function isWithin(file, root) {
+    if (file.rootKey !== root.rootKey || file.segments.length <= root.segments.length)
+        return false;
+    return root.segments.every((segment, index) => file.caseInsensitive
+        ? segment.toLowerCase() === file.segments[index]?.toLowerCase()
+        : segment === file.segments[index]);
+}
+function joinSegments(segments) {
+    if (segments.length === 0) {
+        throw new SourceLocationError("file must be below the project root");
+    }
+    return segments.join("/");
+}
+//# sourceMappingURL=source-location.js.map

package/dist/source-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.js","sourceRoot":"","sources":["../src/source-location.ts"],"names":[],"mappings":"AAUA,4EAA4E;AAC5E,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD,YAAY,MAAc;QACxB,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AASD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,WAAoB;IACxE,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,mBAAmB,CAAC,oDAAoD,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,mBAAmB,CAAC,+BAA+B,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,mBAAmB,CAAC,+BAA+B,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,mBAAmB,CAAC,sCAAsC,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,IAAY,EACZ,MAAc,EACd,WAAoB;IAEpB,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,uBAAuB,CACrC,QAAwB,EACxB,WAAoB;IAEpB,OAAO,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,KAAa;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,mBAAmB,CAAC,GAAG,KAAK,2BAA2B,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,MAAM,IAAI,GAAG,KAAK;QAChB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,KAAK;YACL,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACpB,CAAC,CAAC,QAAQ;gBACR,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpB,CAAC,CAAC,SAAS,CAAC;IAClB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;YAAE,SAAS;QAChD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,mBAAmB,CAAC,GAAG,KAAK,kCAAkC,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,IAAI,QAAQ;oBAAE,SAAS;gBACvB,MAAM,IAAI,mBAAmB,CAAC,GAAG,KAAK,yBAAyB,CAAC,CAAC;YACnE,CAAC;YACD,QAAQ,CAAC,GAAG,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,IAAgB,EAAE,IAAgB;IAClD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChG,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAC5C,IAAI,CAAC,eAAe;QAClB,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE;QAC/D,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAA2B;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAmB,CAAC,qCAAqC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,14 @@
+/** Current version of the public contract payloads. */
+export declare const CONTRACT_VERSION: 2;
+/** Current version of generated RelKit artifacts. */
+export declare const GENERATOR_VERSION: 2;
+/** Current version of the canonical application graph. */
+export declare const GRAPH_VERSION: 5;
+/** Current version of the executable runtime manifest. */
+export declare const MANIFEST_VERSION: 5;
+/** Current version of the internal inspector/API protocol. */
+export declare const API_VERSION: 1;
+/** Shared protocol version used by versioned internal contracts. */
+export declare const PROTOCOL_VERSION: 1;
+export declare const API_BASE_PATH: "/_relkit/v1";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAE3C,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,EAAG,CAAU,CAAC;AAE5C,0DAA0D;AAC1D,eAAO,MAAM,aAAa,EAAG,CAAU,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAE3C,8DAA8D;AAC9D,eAAO,MAAM,WAAW,EAAG,CAAU,CAAC;AAEtC,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,GAAc,CAAC;AAE5C,eAAO,MAAM,aAAa,EAAG,aAAsB,CAAC"}

package/dist/version.js

@@ -0,0 +1,14 @@
+/** Current version of the public contract payloads. */
+export const CONTRACT_VERSION = 2;
+/** Current version of generated RelKit artifacts. */
+export const GENERATOR_VERSION = 2;
+/** Current version of the canonical application graph. */
+export const GRAPH_VERSION = 5;
+/** Current version of the executable runtime manifest. */
+export const MANIFEST_VERSION = 5;
+/** Current version of the internal inspector/API protocol. */
+export const API_VERSION = 1;
+/** Shared protocol version used by versioned internal contracts. */
+export const PROTOCOL_VERSION = API_VERSION;
+export const API_BASE_PATH = "/_relkit/v1";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAE3C,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAU,CAAC;AAE5C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAU,CAAC;AAExC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAE3C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAU,CAAC;AAEtC,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAsB,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@relkit/contracts",
+  "version": "0.0.0",
+  "description": "Unsupported internal RELKIT contracts; use @relkit/app.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/contracts"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false"
+  }
+}