@kashscript/lexicons 0.1.0

package/dist/registry.js

@@ -0,0 +1,133 @@
+/**
+ * LexiconRegistry — agnostic storage for Lexicon definitions.
+ *
+ * The registry holds a map of Lexicon IDs (NSID@semver) to schema definitions.
+ * It is **empty by default**: no Identity, Social, or Trade lexicons are
+ * pre-registered. Consumers explicitly register a Standard Library or load
+ * Extensions at bootstrap time (see `./engine.ts` and the Standard Library /
+ * Extension exports).
+ *
+ * The class does ZERO validation work itself — it just stores and resolves.
+ * Validation is performed by `validateEvent` (see `./engine.ts`) which
+ * accepts a registry as a parameter. This decoupling preserves the
+ * Box-vs-Content separation: the registry (Box) never knows about any
+ * specific domain (Content).
+ */
+import { compareSemver, isForwardCompatible, parseLexiconId } from "./semver";
+/**
+ * In-memory map of registered lexicons.
+ *
+ * Multiple major versions for the same NSID may co-exist. The registry
+ * resolves by exact match first, then by forward-compatible major.
+ */
+export class LexiconRegistry {
+    byId = new Map();
+    byNsid = new Map();
+    /** Number of registered definitions. */
+    get size() {
+        return this.byId.size;
+    }
+    register(arg1, arg2, arg3) {
+        if (typeof arg1 === "string") {
+            if (arg2 === undefined) {
+                throw new TypeError("LexiconRegistry.register(id, schema): schema is required");
+            }
+            const parsed = parseLexiconId(arg1);
+            if (parsed === null) {
+                throw new TypeError(`LexiconRegistry.register: invalid lexicon ID "${arg1}"`);
+            }
+            const entry = {
+                id: arg1,
+                nsid: parsed.nsid,
+                semver: parsed.semver,
+                bodySchema: arg2,
+                ...(arg3?.title !== undefined ? { title: arg3.title } : {}),
+                ...(arg3?.description !== undefined ? { description: arg3.description } : {}),
+            };
+            return this.addEntry(entry);
+        }
+        return this.addEntry(arg1);
+    }
+    /** Register a batch of entries (typically a Standard Library or Extension export). */
+    registerAll(entries) {
+        for (const entry of entries)
+            this.addEntry(entry);
+        return this;
+    }
+    /** Exact-match lookup by full Lexicon ID. Returns undefined when not present. */
+    get(id) {
+        return this.byId.get(id);
+    }
+    /**
+     * Forward-compatible lookup by NSID + caller-supplied semver.
+     * Returns the highest-version registered entry whose major matches the caller.
+     */
+    resolve(nsid, semver) {
+        const candidates = this.byNsid.get(nsid);
+        if (!candidates)
+            return undefined;
+        for (const def of candidates) {
+            if (isForwardCompatible(def.semver, semver))
+                return def;
+        }
+        return undefined;
+    }
+    /** True if any version of the given NSID is registered. */
+    has(nsid) {
+        return this.byNsid.has(nsid);
+    }
+    /** True if the exact Lexicon ID is registered. */
+    hasId(id) {
+        return this.byId.has(id);
+    }
+    /** All registered Lexicon IDs, in insertion order. */
+    list() {
+        return Array.from(this.byId.keys());
+    }
+    /** All registered entries. */
+    entries() {
+        return Array.from(this.byId.values());
+    }
+    /** All NSIDs present in the registry. */
+    namespaces() {
+        return Array.from(this.byNsid.keys());
+    }
+    /** Drop every registered entry. */
+    clear() {
+        this.byId.clear();
+        this.byNsid.clear();
+    }
+    /** Remove a single entry by its full Lexicon ID. Returns whether anything was removed. */
+    unregister(id) {
+        const entry = this.byId.get(id);
+        if (!entry)
+            return false;
+        this.byId.delete(id);
+        const list = this.byNsid.get(entry.nsid);
+        if (list) {
+            const next = list.filter((e) => e.id !== id);
+            if (next.length === 0)
+                this.byNsid.delete(entry.nsid);
+            else
+                this.byNsid.set(entry.nsid, next);
+        }
+        return true;
+    }
+    /* ── internal ─────────────────────────────────────────────────── */
+    addEntry(entry) {
+        this.byId.set(entry.id, entry);
+        const list = this.byNsid.get(entry.nsid);
+        if (list) {
+            // remove any existing entry with the same full ID, then re-insert sorted descending
+            const next = list.filter((e) => e.id !== entry.id);
+            next.push(entry);
+            next.sort((a, b) => compareSemver(b.semver, a.semver));
+            this.byNsid.set(entry.nsid, next);
+        }
+        else {
+            this.byNsid.set(entry.nsid, [entry]);
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Zero-dependency schema DSL + validation engine.
+ *
+ * Schemas are plain data — no class methods, no closures — so they are
+ * trivially serialisable and comparable. The `S` namespace provides a
+ * Zod-style fluent builder for ergonomic authoring.
+ *
+ * Validation is depth-first and accumulates ALL errors (not fail-fast)
+ * so callers can render a complete diagnostic on first attempt.
+ */
+export type Schema = AnySchema | StringSchema | NumberSchema | BooleanSchema | LiteralSchema | EnumSchema | ArraySchema | ObjectSchema | UnionSchema | OptionalSchema | RecordSchema;
+export interface AnySchema {
+    readonly kind: "any";
+}
+export type SchemaStringFormat = "did-ks" | "cid" | "iso8601" | "url" | "multibase" | "bcp47" | "iso4217" | "lexicon-id" | "nsid";
+export interface StringSchema {
+    readonly kind: "string";
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: RegExp;
+    readonly format?: SchemaStringFormat;
+}
+export interface NumberSchema {
+    readonly kind: "number";
+    readonly min?: number;
+    readonly max?: number;
+    readonly integer?: boolean;
+}
+export interface BooleanSchema {
+    readonly kind: "boolean";
+}
+export interface LiteralSchema {
+    readonly kind: "literal";
+    readonly value: string | number | boolean | null;
+}
+export interface EnumSchema {
+    readonly kind: "enum";
+    readonly values: readonly (string | number)[];
+}
+export interface ArraySchema {
+    readonly kind: "array";
+    readonly items: Schema;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+}
+export interface ObjectSchema {
+    readonly kind: "object";
+    readonly properties: Readonly<Record<string, Schema>>;
+    readonly required: readonly string[];
+    /** When false, unknown keys cause validation failure. Default: false. */
+    readonly additionalProperties: boolean;
+}
+export interface UnionSchema {
+    readonly kind: "union";
+    readonly variants: readonly Schema[];
+}
+export interface OptionalSchema {
+    readonly kind: "optional";
+    readonly inner: Schema;
+}
+export interface RecordSchema {
+    readonly kind: "record";
+    readonly keys: StringSchema;
+    readonly values: Schema;
+}
+export declare const S: {
+    any(): AnySchema;
+    string(opts?: Omit<StringSchema, "kind">): StringSchema;
+    number(opts?: Omit<NumberSchema, "kind">): NumberSchema;
+    boolean(): BooleanSchema;
+    literal(value: string | number | boolean | null): LiteralSchema;
+    enum(...values: readonly (string | number)[]): EnumSchema;
+    array(items: Schema, opts?: {
+        readonly minItems?: number;
+        readonly maxItems?: number;
+    }): ArraySchema;
+    object(properties: Readonly<Record<string, Schema>>, required?: readonly string[], additionalProperties?: boolean): ObjectSchema;
+    union(...variants: readonly Schema[]): UnionSchema;
+    optional(inner: Schema): OptionalSchema;
+    record(values: Schema, keys?: StringSchema): RecordSchema;
+};
+export interface ValidationError {
+    readonly path: readonly (string | number)[];
+    readonly message: string;
+    readonly received?: unknown;
+}
+export type ValidationResult<T = unknown> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly errors: readonly ValidationError[];
+};
+/** Canonical source-of-truth for the built-in string formats.
+ *  Exported so the JSON-Schema exporter can read `.source` without
+ *  re-typing the regex literals. */
+export declare const FORMAT_PATTERNS: Record<SchemaStringFormat, RegExp>;
+export declare function validate<T = unknown>(schema: Schema, value: unknown): ValidationResult<T>;
+/** Convenience type-guard. Returns true iff `value` matches `schema`. */
+export declare function matches(schema: Schema, value: unknown): boolean;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

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

package/dist/schema.js

@@ -0,0 +1,224 @@
+/**
+ * Zero-dependency schema DSL + validation engine.
+ *
+ * Schemas are plain data — no class methods, no closures — so they are
+ * trivially serialisable and comparable. The `S` namespace provides a
+ * Zod-style fluent builder for ergonomic authoring.
+ *
+ * Validation is depth-first and accumulates ALL errors (not fail-fast)
+ * so callers can render a complete diagnostic on first attempt.
+ */
+/* ── fluent builders ────────────────────────────────────────────── */
+export const S = {
+    any() {
+        return { kind: "any" };
+    },
+    string(opts) {
+        return { kind: "string", ...opts };
+    },
+    number(opts) {
+        return { kind: "number", ...opts };
+    },
+    boolean() {
+        return { kind: "boolean" };
+    },
+    literal(value) {
+        return { kind: "literal", value };
+    },
+    enum(...values) {
+        return { kind: "enum", values };
+    },
+    array(items, opts) {
+        return { kind: "array", items, ...opts };
+    },
+    object(properties, required = [], additionalProperties = false) {
+        return { kind: "object", properties, required, additionalProperties };
+    },
+    union(...variants) {
+        return { kind: "union", variants };
+    },
+    optional(inner) {
+        return { kind: "optional", inner };
+    },
+    record(values, keys = { kind: "string" }) {
+        return { kind: "record", keys, values };
+    },
+};
+/* ── string format patterns ─────────────────────────────────────── */
+/** Canonical source-of-truth for the built-in string formats.
+ *  Exported so the JSON-Schema exporter can read `.source` without
+ *  re-typing the regex literals. */
+export const FORMAT_PATTERNS = {
+    // identity-core's DID method is `did:kash:` with a base58btc-encoded pubkey
+    // body. Ed25519 pubkeys (32 bytes) round-trip to 43-44 chars in base58btc.
+    // The format-id stays `did-ks` (schema-internal name) for backward
+    // compatibility; the regex now matches what `@kashscript/identity-core`
+    // emits via `deriveDid()`.
+    "did-ks": /^did:kash:[1-9A-HJ-NP-Za-km-z]{32,48}$/,
+    "cid": /^bafy[a-z2-7]{52,}$/,
+    "iso8601": /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/,
+    "url": /^https?:\/\/[^\s]+$/,
+    "multibase": /^z[1-9A-HJ-NP-Za-km-z]+$/,
+    "bcp47": /^[a-z]{2,3}(-[A-Z]{2})?$/,
+    "iso4217": /^[A-Z]{3}$/,
+    "lexicon-id": /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+@\d+\.\d+\.\d+$/,
+    "nsid": /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+$/,
+};
+/* ── public entry point ─────────────────────────────────────────── */
+export function validate(schema, value) {
+    const errors = [];
+    validateRec(schema, value, [], errors);
+    return errors.length === 0
+        ? { ok: true, value: value }
+        : { ok: false, errors };
+}
+/** Convenience type-guard. Returns true iff `value` matches `schema`. */
+export function matches(schema, value) {
+    const errors = [];
+    validateRec(schema, value, [], errors);
+    return errors.length === 0;
+}
+/* ── recursive validator ────────────────────────────────────────── */
+function validateRec(schema, value, path, errors) {
+    switch (schema.kind) {
+        case "any":
+            return;
+        case "string":
+            validateString(schema, value, path, errors);
+            return;
+        case "number":
+            validateNumber(schema, value, path, errors);
+            return;
+        case "boolean":
+            if (typeof value !== "boolean")
+                errors.push(err(path, "expected boolean", value));
+            return;
+        case "literal":
+            if (value !== schema.value) {
+                errors.push(err(path, `expected literal ${JSON.stringify(schema.value)}`, value));
+            }
+            return;
+        case "enum":
+            if (typeof value !== "string" && typeof value !== "number") {
+                errors.push(err(path, "expected string|number for enum", value));
+                return;
+            }
+            if (!schema.values.includes(value)) {
+                errors.push(err(path, `expected one of ${JSON.stringify(schema.values)}`, value));
+            }
+            return;
+        case "array":
+            validateArray(schema, value, path, errors);
+            return;
+        case "object":
+            validateObject(schema, value, path, errors);
+            return;
+        case "union":
+            validateUnion(schema, value, path, errors);
+            return;
+        case "optional":
+            if (value === undefined)
+                return;
+            validateRec(schema.inner, value, path, errors);
+            return;
+        case "record":
+            validateRecord(schema, value, path, errors);
+            return;
+    }
+}
+function err(path, message, received) {
+    return { path, message, received };
+}
+function validateString(s, value, path, errors) {
+    if (typeof value !== "string") {
+        errors.push(err(path, "expected string", value));
+        return;
+    }
+    if (s.minLength !== undefined && value.length < s.minLength) {
+        errors.push(err(path, `string too short (min ${s.minLength}, got ${value.length})`, value));
+    }
+    if (s.maxLength !== undefined && value.length > s.maxLength) {
+        errors.push(err(path, `string too long (max ${s.maxLength}, got ${value.length})`, value));
+    }
+    if (s.pattern && !s.pattern.test(value)) {
+        errors.push(err(path, `does not match pattern ${s.pattern.toString()}`, value));
+    }
+    if (s.format && !FORMAT_PATTERNS[s.format].test(value)) {
+        errors.push(err(path, `does not match format "${s.format}"`, value));
+    }
+}
+function validateNumber(s, value, path, errors) {
+    if (typeof value !== "number" || Number.isNaN(value)) {
+        errors.push(err(path, "expected number", value));
+        return;
+    }
+    if (s.integer && !Number.isInteger(value)) {
+        errors.push(err(path, "expected integer", value));
+    }
+    if (s.min !== undefined && value < s.min) {
+        errors.push(err(path, `below minimum ${s.min}`, value));
+    }
+    if (s.max !== undefined && value > s.max) {
+        errors.push(err(path, `above maximum ${s.max}`, value));
+    }
+}
+function validateArray(s, value, path, errors) {
+    if (!Array.isArray(value)) {
+        errors.push(err(path, "expected array", value));
+        return;
+    }
+    if (s.minItems !== undefined && value.length < s.minItems) {
+        errors.push(err(path, `array too short (min ${s.minItems}, got ${value.length})`, value));
+    }
+    if (s.maxItems !== undefined && value.length > s.maxItems) {
+        errors.push(err(path, `array too long (max ${s.maxItems}, got ${value.length})`, value));
+    }
+    for (let i = 0; i < value.length; i++) {
+        validateRec(s.items, value[i], [...path, i], errors);
+    }
+}
+function validateObject(s, value, path, errors) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        errors.push(err(path, "expected object", value));
+        return;
+    }
+    const obj = value;
+    for (const k of s.required) {
+        if (!(k in obj)) {
+            errors.push(err([...path, k], "missing required field", undefined));
+        }
+    }
+    for (const k of Object.keys(s.properties)) {
+        if (k in obj) {
+            const subSchema = s.properties[k];
+            validateRec(subSchema, obj[k], [...path, k], errors);
+        }
+    }
+    if (!s.additionalProperties) {
+        for (const k of Object.keys(obj)) {
+            if (!(k in s.properties)) {
+                errors.push(err([...path, k], "unknown field", obj[k]));
+            }
+        }
+    }
+}
+function validateUnion(s, value, path, errors) {
+    for (const variant of s.variants) {
+        const subErrors = [];
+        validateRec(variant, value, path, subErrors);
+        if (subErrors.length === 0)
+            return;
+    }
+    errors.push(err(path, `value matched none of ${s.variants.length} union variants`, value));
+}
+function validateRecord(s, value, path, errors) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        errors.push(err(path, "expected object (record)", value));
+        return;
+    }
+    for (const [k, v] of Object.entries(value)) {
+        validateRec(s.keys, k, [...path, k], errors);
+        validateRec(s.values, v, [...path, k], errors);
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/semver.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Semver parsing and forward-compat resolution for Lexicon IDs.
+ * Lexicon ID syntax: <nsid>@<major>.<minor>.<patch> — e.g., "kash.id.profile@1.2.0".
+ */
+import type { LexiconId } from "./types";
+export interface Semver {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+}
+export interface ParsedLexiconId {
+    readonly nsid: string;
+    readonly semver: Semver;
+}
+/** Parse a Lexicon ID. Returns null on malformed input. */
+export declare function parseLexiconId(id: string): ParsedLexiconId | null;
+/** Build a Lexicon ID string from parts. */
+export declare function formatLexiconId(nsid: string, semver: Semver): LexiconId;
+/** Lexicographic compare. Returns negative/zero/positive (like Array.sort). */
+export declare function compareSemver(a: Semver, b: Semver): number;
+/**
+ * Is the `record` semver forward-compatible with the `consumer` semver?
+ *
+ * v1.0 evolution rule: any record minted under <nsid>@X.Y.Z is acceptable to
+ * a consumer that knows <nsid>@X.*. Cross-major requires an explicit migrator
+ * (out of scope for this layer — handled by the consumer at a higher level).
+ */
+export declare function isForwardCompatible(consumer: Semver, record: Semver): boolean;
+//# sourceMappingURL=semver.d.ts.map

package/dist/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../src/semver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAID,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAWjE;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAEvE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7E"}

package/dist/semver.js

@@ -0,0 +1,42 @@
+/**
+ * Semver parsing and forward-compat resolution for Lexicon IDs.
+ * Lexicon ID syntax: <nsid>@<major>.<minor>.<patch> — e.g., "kash.id.profile@1.2.0".
+ */
+const LEXICON_ID_RE = /^([a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)+)@(\d+)\.(\d+)\.(\d+)$/;
+/** Parse a Lexicon ID. Returns null on malformed input. */
+export function parseLexiconId(id) {
+    const m = LEXICON_ID_RE.exec(id);
+    if (!m)
+        return null;
+    return {
+        nsid: m[1],
+        semver: {
+            major: Number.parseInt(m[2], 10),
+            minor: Number.parseInt(m[3], 10),
+            patch: Number.parseInt(m[4], 10),
+        },
+    };
+}
+/** Build a Lexicon ID string from parts. */
+export function formatLexiconId(nsid, semver) {
+    return `${nsid}@${semver.major}.${semver.minor}.${semver.patch}`;
+}
+/** Lexicographic compare. Returns negative/zero/positive (like Array.sort). */
+export function compareSemver(a, b) {
+    if (a.major !== b.major)
+        return a.major - b.major;
+    if (a.minor !== b.minor)
+        return a.minor - b.minor;
+    return a.patch - b.patch;
+}
+/**
+ * Is the `record` semver forward-compatible with the `consumer` semver?
+ *
+ * v1.0 evolution rule: any record minted under <nsid>@X.Y.Z is acceptable to
+ * a consumer that knows <nsid>@X.*. Cross-major requires an explicit migrator
+ * (out of scope for this layer — handled by the consumer at a higher level).
+ */
+export function isForwardCompatible(consumer, record) {
+    return consumer.major === record.major;
+}
+//# sourceMappingURL=semver.js.map

package/dist/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../src/semver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,aAAa,GAAG,+DAA+D,CAAC;AAEtF,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE;QACX,MAAM,EAAE;YACN,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;YACjC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;YACjC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;SAClC;KACF,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAc;IAC1D,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAe,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,MAAc;IAClE,OAAO,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC;AACzC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared brand types used across the lexicon framework.
+ * Phase-3 may re-export these from @kashscript/identity once that package
+ * publishes its own brand types.
+ */
+/** W3C DID restricted to the did:kash method emitted by `@kashscript/identity-core`. */
+export type DID = `did:kash:${string}`;
+/** CIDv1 multibase, base32, "bafy" prefix. */
+export type CID = `bafy${string}`;
+/** Lexicon ID — <nsid>@<semver>, e.g., "kash.id.profile@1.0.0". */
+export type LexiconId = `${string}@${number}.${number}.${number}`;
+/** Multibase-encoded byte string ("z"-prefixed base58-btc). */
+export type Multibase = `z${string}`;
+/** ISO-8601 timestamp with offset, e.g. "2026-05-09T12:34:56Z". */
+export type Iso8601 = string;
+/** Signature algorithm identifier. Phase-4 adds "es256"; Phase-5 adds "bls12-381-g2". */
+export type SignatureAlgorithm = "ed25519" | "es256" | "bls12-381-g2";
+/** Domain-Separation Tag for record-tier signatures (Identity Protocol §5.5). */
+export declare const KASH_RECORD_DST: "kash-record-v1\n";
+export type KashRecordDST = typeof KASH_RECORD_DST;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wFAAwF;AACxF,MAAM,MAAM,GAAG,GAAG,YAAY,MAAM,EAAE,CAAC;AAEvC,8CAA8C;AAC9C,MAAM,MAAM,GAAG,GAAG,OAAO,MAAM,EAAE,CAAC;AAElC,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAElE,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG,IAAI,MAAM,EAAE,CAAC;AAErC,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,yFAAyF;AACzF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;AAEtE,iFAAiF;AACjF,eAAO,MAAM,eAAe,EAAG,kBAA2B,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared brand types used across the lexicon framework.
+ * Phase-3 may re-export these from @kashscript/identity once that package
+ * publishes its own brand types.
+ */
+/** Domain-Separation Tag for record-tier signatures (Identity Protocol §5.5). */
+export const KASH_RECORD_DST = "kash-record-v1\n";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,kBAA2B,CAAC"}