@almadar/core 10.129.0 → 11.0.0

package/dist/chunk-VG7BRFUD.js

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+
+// src/types/identity.ts
+var ID_PREFIXES = {
+  orbital: "orb_",
+  entity: "ent_",
+  trait: "trt_",
+  event: "evt_",
+  page: "pag_",
+  service: "svc_",
+  theme: "thm_",
+  palette: "pal_"
+};
+function brand(value) {
+  return value;
+}
+function makeIdKind(kind) {
+  const prefix = ID_PREFIXES[kind];
+  const is = (value) => value.startsWith(prefix) && value.length > prefix.length;
+  const as = (value) => {
+    if (!is(value)) {
+      throw new Error(
+        `Expected ${kind} id (prefix "${prefix}"), got: ${JSON.stringify(value)}`
+      );
+    }
+    return brand(value);
+  };
+  return { prefix, is, as };
+}
+var orbitalKind = makeIdKind("orbital");
+var entityKind = makeIdKind("entity");
+var traitKind = makeIdKind("trait");
+var eventKind = makeIdKind("event");
+var pageKind = makeIdKind("page");
+var serviceKind = makeIdKind("service");
+var themeKind = makeIdKind("theme");
+var paletteKind = makeIdKind("palette");
+var isOrbitalId = orbitalKind.is;
+var asOrbitalId = orbitalKind.as;
+var isEntityId = entityKind.is;
+var asEntityId = entityKind.as;
+var isTraitId = traitKind.is;
+var asTraitId = traitKind.as;
+var isEventId = eventKind.is;
+var asEventId = eventKind.as;
+var isPageId = pageKind.is;
+var asPageId = pageKind.as;
+var isServiceId = serviceKind.is;
+var asServiceId = serviceKind.as;
+var isThemeId = themeKind.is;
+var asThemeId = themeKind.as;
+var isPaletteEntryId = paletteKind.is;
+var asPaletteEntryId = paletteKind.as;
+function idPrefix(kind) {
+  return ID_PREFIXES[kind];
+}
+function idKindOf(id) {
+  for (const kind of Object.keys(ID_PREFIXES)) {
+    const prefix = ID_PREFIXES[kind];
+    if (id.startsWith(prefix) && id.length > prefix.length) return kind;
+  }
+  return null;
+}
+var CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+var TIME_LEN = 10;
+var RANDOM_LEN = 16;
+function randomBytes(len) {
+  const g = globalThis;
+  if (g.crypto?.getRandomValues) {
+    return g.crypto.getRandomValues(new Uint8Array(len));
+  }
+  throw new Error("mintId: no crypto.getRandomValues available in this runtime");
+}
+function encodeTime(now) {
+  let value = now;
+  let out = "";
+  for (let i = 0; i < TIME_LEN; i++) {
+    const mod = value % 32;
+    out = CROCKFORD[mod] + out;
+    value = (value - mod) / 32;
+  }
+  return out;
+}
+function encodeRandom() {
+  const bytes = randomBytes(RANDOM_LEN);
+  let out = "";
+  for (let i = 0; i < RANDOM_LEN; i++) {
+    out += CROCKFORD[bytes[i] & 31];
+  }
+  return out;
+}
+function mintUlid() {
+  return encodeTime(Date.now()) + encodeRandom();
+}
+function mintId(kind) {
+  return brand(ID_PREFIXES[kind] + mintUlid());
+}
+function ledgerResolveName(ledger, kind, name) {
+  for (const [id, entry] of Object.entries(ledger.entries)) {
+    if (entry.kind === kind && entry.curName === name) return id;
+  }
+  return null;
+}
+function ledgerRename(ledger, id, to, at) {
+  const entry = ledger.entries[id];
+  if (entry === void 0 || entry.curName === to) return ledger;
+  const updated = {
+    ...entry,
+    curName: to,
+    renames: [...entry.renames, { from: entry.curName, to, at }]
+  };
+  return { ...ledger, entries: { ...ledger.entries, [id]: updated } };
+}
+function ledgerCurName(ledger, id) {
+  return ledger.entries[id]?.curName ?? null;
+}
+var OrbitalIdSchema = z.string().refine(isOrbitalId, { message: `Expected an orbital id (prefix "${ID_PREFIXES.orbital}")` });
+var EntityIdSchema = z.string().refine(isEntityId, { message: `Expected an entity id (prefix "${ID_PREFIXES.entity}")` });
+var TraitIdSchema = z.string().refine(isTraitId, { message: `Expected a trait id (prefix "${ID_PREFIXES.trait}")` });
+var EventIdSchema = z.string().refine(isEventId, { message: `Expected an event id (prefix "${ID_PREFIXES.event}")` });
+var PageIdSchema = z.string().refine(isPageId, { message: `Expected a page id (prefix "${ID_PREFIXES.page}")` });
+var ServiceIdSchema = z.string().refine(isServiceId, { message: `Expected a service id (prefix "${ID_PREFIXES.service}")` });
+var ThemeIdSchema = z.string().refine(isThemeId, { message: `Expected a theme id (prefix "${ID_PREFIXES.theme}")` });
+var PaletteEntryIdSchema = z.string().refine(isPaletteEntryId, { message: `Expected a palette-entry id (prefix "${ID_PREFIXES.palette}")` });
+var LedgerKindSchema = z.enum([
+  "orbital",
+  "entity",
+  "trait",
+  "event",
+  "page",
+  "service",
+  "theme"
+]);
+var LedgerEntrySchema = z.object({
+  id: z.string(),
+  kind: LedgerKindSchema,
+  bakedName: z.string(),
+  curName: z.string(),
+  renames: z.array(
+    z.object({ from: z.string(), to: z.string(), at: z.string() })
+  ),
+  owner: z.enum(["std", "io", "workspace"]),
+  parent: TraitIdSchema.optional()
+});
+var IdentityLedgerSchema = z.object({
+  schemaVersion: z.literal(1),
+  entries: z.record(z.string(), LedgerEntrySchema)
+});
+
+export { EntityIdSchema, EventIdSchema, IdentityLedgerSchema, LedgerEntrySchema, LedgerKindSchema, OrbitalIdSchema, PageIdSchema, PaletteEntryIdSchema, ServiceIdSchema, ThemeIdSchema, TraitIdSchema, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, idKindOf, idPrefix, isEntityId, isEventId, isOrbitalId, isPageId, isPaletteEntryId, isServiceId, isThemeId, isTraitId, ledgerCurName, ledgerRename, ledgerResolveName, mintId, mintUlid };
+//# sourceMappingURL=chunk-VG7BRFUD.js.map
+//# sourceMappingURL=chunk-VG7BRFUD.js.map

package/dist/chunk-VG7BRFUD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/identity.ts"],"names":[],"mappings":"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","file":"chunk-VG7BRFUD.js","sourcesContent":["/**\n * Identity model (Almadar Rabit V4, Phase 1 — types only).\n *\n * Branded, prefix-tagged node ids + a workspace-scoped name ledger. Ids are\n * the durable edge keys of the identity-keyed schema graph; the ledger is the\n * sole name↔id map (names are display labels, one row per rename). This module\n * is pure: no I/O, no side effects. Minting is the only impurity (clock +\n * crypto randomness for the ULID suffix).\n *\n * @packageDocumentation\n */\n\nimport { z } from 'zod';\n\n// ============================================================================\n// Branded id types\n// ============================================================================\n\ntype Branded<K extends string> = string & { readonly __idBrand: K };\n\nexport type OrbitalId = Branded<'OrbitalId'>;\nexport type EntityId = Branded<'EntityId'>;\nexport type TraitId = Branded<'TraitId'>;\nexport type EventId = Branded<'EventId'>;\nexport type PageId = Branded<'PageId'>;\nexport type ServiceId = Branded<'ServiceId'>;\nexport type ThemeId = Branded<'ThemeId'>;\nexport type PaletteEntryId = Branded<'PaletteEntryId'>;\n\n/** Node kind ↔ id-prefix table. The single source of truth for every prefix. */\nconst ID_PREFIXES = {\n  orbital: 'orb_',\n  entity: 'ent_',\n  trait: 'trt_',\n  event: 'evt_',\n  page: 'pag_',\n  service: 'svc_',\n  theme: 'thm_',\n  palette: 'pal_',\n} as const;\n\nexport type IdKind = keyof typeof ID_PREFIXES;\n\n/** Compile-time map from kind to its branded id type. */\nexport interface IdForKind {\n  orbital: OrbitalId;\n  entity: EntityId;\n  trait: TraitId;\n  event: EventId;\n  page: PageId;\n  service: ServiceId;\n  theme: ThemeId;\n  palette: PaletteEntryId;\n}\n\n/**\n * The one controlled brand assertion in this module. A prefix-checked string\n * is asserted into its branded form here and nowhere else.\n */\nfunction brand<Id extends string>(value: string): Id {\n  return value as Id;\n}\n\n// ============================================================================\n// Kind guards + constructors (one shared factory, eight kinds)\n// ============================================================================\n\ninterface IdKindApi<Id extends string> {\n  readonly prefix: string;\n  is(value: string): value is Id;\n  as(value: string): Id;\n}\n\nfunction makeIdKind<Id extends string>(kind: IdKind): IdKindApi<Id> {\n  const prefix = ID_PREFIXES[kind];\n  const is = (value: string): value is Id =>\n    value.startsWith(prefix) && value.length > prefix.length;\n  const as = (value: string): Id => {\n    if (!is(value)) {\n      throw new Error(\n        `Expected ${kind} id (prefix \"${prefix}\"), got: ${JSON.stringify(value)}`,\n      );\n    }\n    return brand<Id>(value);\n  };\n  return { prefix, is, as };\n}\n\nconst orbitalKind = makeIdKind<OrbitalId>('orbital');\nconst entityKind = makeIdKind<EntityId>('entity');\nconst traitKind = makeIdKind<TraitId>('trait');\nconst eventKind = makeIdKind<EventId>('event');\nconst pageKind = makeIdKind<PageId>('page');\nconst serviceKind = makeIdKind<ServiceId>('service');\nconst themeKind = makeIdKind<ThemeId>('theme');\nconst paletteKind = makeIdKind<PaletteEntryId>('palette');\n\nexport const isOrbitalId = orbitalKind.is;\nexport const asOrbitalId = orbitalKind.as;\nexport const isEntityId = entityKind.is;\nexport const asEntityId = entityKind.as;\nexport const isTraitId = traitKind.is;\nexport const asTraitId = traitKind.as;\nexport const isEventId = eventKind.is;\nexport const asEventId = eventKind.as;\nexport const isPageId = pageKind.is;\nexport const asPageId = pageKind.as;\nexport const isServiceId = serviceKind.is;\nexport const asServiceId = serviceKind.as;\nexport const isThemeId = themeKind.is;\nexport const asThemeId = themeKind.as;\nexport const isPaletteEntryId = paletteKind.is;\nexport const asPaletteEntryId = paletteKind.as;\n\n/**\n * The id-prefix for a node kind (`'entity' → 'ent_'`). The JS mirror of the\n * Rust `IdKind::prefix`. Single source of truth is {@link ID_PREFIXES}.\n */\nexport function idPrefix(kind: IdKind): string {\n  return ID_PREFIXES[kind];\n}\n\n/**\n * The node kind an id's prefix denotes, or `null` for an unrecognized /\n * bare-prefix string. The JS mirror of the Rust `id_kind_of`. Prefixes are\n * mutually non-overlapping, so match order is irrelevant.\n */\nexport function idKindOf(id: string): IdKind | null {\n  for (const kind of Object.keys(ID_PREFIXES) as IdKind[]) {\n    const prefix = ID_PREFIXES[kind];\n    if (id.startsWith(prefix) && id.length > prefix.length) return kind;\n  }\n  return null;\n}\n\n// ============================================================================\n// Minting — prefix + ULID\n// ============================================================================\n\nconst CROCKFORD = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';\nconst TIME_LEN = 10;\nconst RANDOM_LEN = 16;\n\nfunction randomBytes(len: number): Uint8Array {\n  const g = globalThis as { crypto?: { getRandomValues?: (a: Uint8Array) => Uint8Array } };\n  if (g.crypto?.getRandomValues) {\n    return g.crypto.getRandomValues(new Uint8Array(len));\n  }\n  throw new Error('mintId: no crypto.getRandomValues available in this runtime');\n}\n\nfunction encodeTime(now: number): string {\n  let value = now;\n  let out = '';\n  for (let i = 0; i < TIME_LEN; i++) {\n    const mod = value % 32;\n    out = CROCKFORD[mod] + out;\n    value = (value - mod) / 32;\n  }\n  return out;\n}\n\nfunction encodeRandom(): string {\n  const bytes = randomBytes(RANDOM_LEN);\n  let out = '';\n  for (let i = 0; i < RANDOM_LEN; i++) {\n    out += CROCKFORD[bytes[i] & 31];\n  }\n  return out;\n}\n\n/** A 26-char Crockford-base32 ULID: 48-bit ms timestamp + 80 bits of randomness. Needs only `getRandomValues`, so it also runs on a plain-http page where `randomUUID` is absent. */\nexport function mintUlid(): string {\n  return encodeTime(Date.now()) + encodeRandom();\n}\n\n/** Mint a fresh, opaque, kind-tagged id: `<prefix><ULID>`. */\nexport function mintId<K extends IdKind>(kind: K): IdForKind[K] {\n  return brand<IdForKind[K]>(ID_PREFIXES[kind] + mintUlid());\n}\n\n// ============================================================================\n// Identity ledger\n// ============================================================================\n\n/** Ledger row kind. `palette` entries are manifest ids, not name-ledger rows. */\nexport type LedgerKind =\n  | 'orbital'\n  | 'entity'\n  | 'trait'\n  | 'event'\n  | 'page'\n  | 'service'\n  | 'theme';\n\n/**\n * One ledger row: the workspace's name history for a single node id.\n *\n * For kind `'event'` the row is minted per-(trait, declared event) per the\n * Phase-0 freeze — the owning trait is recorded in `parent`; a call-site event\n * rename is a one-row edit on this same id (the baked-vs-current key namespaces\n * collapse into `bakedName` vs `curName`).\n */\nexport interface LedgerEntry {\n  id: string;\n  kind: LedgerKind;\n  bakedName: string;\n  curName: string;\n  renames: ReadonlyArray<{ from: string; to: string; at: string }>;\n  owner: 'std' | 'io' | 'workspace';\n  /** Owning trait for kind `'event'` (per-trait event-id namespace). */\n  parent?: TraitId;\n}\n\nexport interface IdentityLedger {\n  schemaVersion: 1;\n  entries: Record<string, LedgerEntry>;\n}\n\n/** Resolve a name to its id via exact `curName` match within `kind`, else null. */\nexport function ledgerResolveName(\n  ledger: IdentityLedger,\n  kind: LedgerKind,\n  name: string,\n): string | null {\n  for (const [id, entry] of Object.entries(ledger.entries)) {\n    if (entry.kind === kind && entry.curName === name) return id;\n  }\n  return null;\n}\n\n/** Immutable rename: returns a new ledger with the id's `curName` + `renames` updated; renaming to the current name is a no-op. */\nexport function ledgerRename(\n  ledger: IdentityLedger,\n  id: string,\n  to: string,\n  at: string,\n): IdentityLedger {\n  const entry = ledger.entries[id];\n  if (entry === undefined || entry.curName === to) return ledger;\n  const updated: LedgerEntry = {\n    ...entry,\n    curName: to,\n    renames: [...entry.renames, { from: entry.curName, to, at }],\n  };\n  return { ...ledger, entries: { ...ledger.entries, [id]: updated } };\n}\n\n/** Current display name for an id, or null when the id is not in the ledger. */\nexport function ledgerCurName(ledger: IdentityLedger, id: string): string | null {\n  return ledger.entries[id]?.curName ?? null;\n}\n\n// ============================================================================\n// Zod schemas — the `.orb` load-time activation surface (Rabit V4, Phase 4)\n// ============================================================================\n\n/**\n * Prefix-checked, kind-tagged id schemas. Each narrows a validated string to\n * its branded id type via the module's own kind guard, so a schema that reads\n * `TraitIdSchema.optional()` yields `TraitId | undefined` with no cast. The\n * guard is the single source of prefix truth (`ID_PREFIXES`); the schema is a\n * thin zod wrapper over it.\n */\nexport const OrbitalIdSchema = z\n  .string()\n  .refine(isOrbitalId, { message: `Expected an orbital id (prefix \"${ID_PREFIXES.orbital}\")` });\nexport const EntityIdSchema = z\n  .string()\n  .refine(isEntityId, { message: `Expected an entity id (prefix \"${ID_PREFIXES.entity}\")` });\nexport const TraitIdSchema = z\n  .string()\n  .refine(isTraitId, { message: `Expected a trait id (prefix \"${ID_PREFIXES.trait}\")` });\nexport const EventIdSchema = z\n  .string()\n  .refine(isEventId, { message: `Expected an event id (prefix \"${ID_PREFIXES.event}\")` });\nexport const PageIdSchema = z\n  .string()\n  .refine(isPageId, { message: `Expected a page id (prefix \"${ID_PREFIXES.page}\")` });\nexport const ServiceIdSchema = z\n  .string()\n  .refine(isServiceId, { message: `Expected a service id (prefix \"${ID_PREFIXES.service}\")` });\nexport const ThemeIdSchema = z\n  .string()\n  .refine(isThemeId, { message: `Expected a theme id (prefix \"${ID_PREFIXES.theme}\")` });\nexport const PaletteEntryIdSchema = z\n  .string()\n  .refine(isPaletteEntryId, { message: `Expected a palette-entry id (prefix \"${ID_PREFIXES.palette}\")` });\n\nexport const LedgerKindSchema = z.enum([\n  'orbital',\n  'entity',\n  'trait',\n  'event',\n  'page',\n  'service',\n  'theme',\n]);\n\nexport const LedgerEntrySchema = z.object({\n  id: z.string(),\n  kind: LedgerKindSchema,\n  bakedName: z.string(),\n  curName: z.string(),\n  renames: z.array(\n    z.object({ from: z.string(), to: z.string(), at: z.string() }),\n  ),\n  owner: z.enum(['std', 'io', 'workspace']),\n  parent: TraitIdSchema.optional(),\n});\n\nexport const IdentityLedgerSchema = z.object({\n  schemaVersion: z.literal(1),\n  entries: z.record(z.string(), LedgerEntrySchema),\n});\n"]}