graphddb 0.7.10 → 0.8.1

package/dist/chunk-S2NI4PBW.js

@@ -0,0 +1,187 @@
+import {
+  evaluateKey
+} from "./chunk-T44OB5GU.js";
+import {
+  SPEC_VERSION
+} from "./chunk-L4QRCHRQ.js";
+import {
+  MetadataRegistry
+} from "./chunk-L2NEDS7U.js";
+import {
+  TableMapping
+} from "./chunk-XTWXMOHD.js";
+
+// src/spec/manifest.ts
+var DYNAMO_TYPE_TO_FIELD_TYPE = {
+  S: "string",
+  N: "number",
+  BOOL: "boolean",
+  B: "binary",
+  SS: "stringSet",
+  NS: "numberSet",
+  L: "list",
+  M: "map"
+};
+function sortedRecord(record) {
+  const out = {};
+  for (const key of Object.keys(record).sort()) {
+    out[key] = record[key];
+  }
+  return out;
+}
+function buildKey(key) {
+  if (!key) return null;
+  const { pk, sk } = evaluateKey(key.segmented, "param");
+  return {
+    inputFields: [...key.inputFieldNames],
+    pkTemplate: pk,
+    skTemplate: sk ?? null
+  };
+}
+function buildGsis(metadata) {
+  return [...metadata.gsiDefinitions].sort((a, b) => a.indexName.localeCompare(b.indexName)).map((gsi) => {
+    const { pk, sk } = evaluateKey(gsi.segmented, "param");
+    return {
+      indexName: gsi.indexName,
+      unique: gsi.unique,
+      inputFields: [...gsi.inputFieldNames],
+      pkTemplate: pk,
+      skTemplate: sk ?? null,
+      // Purely-documentary GSI description (issue #166); emitted only when declared
+      // so an undescribed index is byte-identical to the pre-#166 manifest.
+      ...gsi.description !== void 0 ? { description: gsi.description } : {}
+    };
+  });
+}
+function buildRelations(metadata) {
+  const relations = {};
+  for (const rel of metadata.relations) {
+    const targetClass = rel.targetFactory();
+    relations[rel.propertyName] = {
+      type: rel.type,
+      target: targetClass.name,
+      keyBinding: { ...rel.keyBinding },
+      // List-valued source descriptor for a `refs` relation (issue #197); emitted
+      // only for `refs` so a scalar-keyed relation is byte-identical to the pre-#197
+      // manifest.
+      ...rel.refs !== void 0 ? { refs: { ...rel.refs } } : {},
+      // Purely-documentary relation description (issue #166); emitted only when
+      // declared so an undescribed relation is byte-identical to the pre-#166 manifest.
+      ...rel.options?.description !== void 0 ? { description: rel.options.description } : {}
+    };
+  }
+  return sortedRecord(relations);
+}
+function buildFields(metadata) {
+  const fields = {};
+  for (const field of metadata.fields) {
+    const format = field.options?.format;
+    const description = field.options?.description;
+    fields[field.propertyName] = {
+      type: DYNAMO_TYPE_TO_FIELD_TYPE[field.dynamoType],
+      ...format ? { format } : {},
+      ...description !== void 0 ? { description } : {}
+    };
+  }
+  return sortedRecord(fields);
+}
+function buildManifestEntity(metadata) {
+  return buildEntity(metadata);
+}
+function buildEntity(metadata) {
+  return {
+    table: metadata.tableName,
+    physicalName: TableMapping.resolve(metadata.tableName),
+    prefix: metadata.prefix,
+    fields: buildFields(metadata),
+    key: buildKey(metadata.primaryKey),
+    gsis: buildGsis(metadata),
+    relations: buildRelations(metadata),
+    ...metadata.description !== void 0 ? { description: metadata.description } : {},
+    // TTL (issue #172, Epic #167 — C4): a physical-schema fact carried on the
+    // manifest so the CFn emitter can render `TimeToLiveSpecification`. Absent
+    // when no `@ttl` field is declared (byte-identical to the pre-#172 manifest).
+    ...metadata.ttlAttribute !== void 0 ? { ttlAttribute: metadata.ttlAttribute } : {}
+  };
+}
+function buildManifest(registry = MetadataRegistry) {
+  const all = registry.getAll();
+  const entitiesByName = /* @__PURE__ */ new Map();
+  for (const [cls, metadata] of all) {
+    entitiesByName.set(cls.name, metadata);
+  }
+  const entities = {};
+  const tables = {};
+  const ttlByPhysicalTable = /* @__PURE__ */ new Map();
+  for (const name of [...entitiesByName.keys()].sort()) {
+    const metadata = entitiesByName.get(name);
+    entities[name] = buildEntity(metadata);
+    const physicalName = TableMapping.resolve(metadata.tableName);
+    tables[metadata.tableName] = {
+      physicalName
+    };
+    if (metadata.ttlAttribute !== void 0) {
+      const existing = ttlByPhysicalTable.get(physicalName);
+      if (existing && existing.attr !== metadata.ttlAttribute) {
+        throw new Error(
+          `Manifest build: physical table '${physicalName}' has more than one TTL attribute \u2014 entity '${existing.entity}' declares \`@ttl\` on '${existing.attr}' and entity '${name}' on '${metadata.ttlAttribute}'. DynamoDB allows exactly one TTL attribute per table; align the \`@ttl\` attribute across all entities sharing this table (or drop one).`
+        );
+      }
+      if (!existing) {
+        ttlByPhysicalTable.set(physicalName, {
+          entity: name,
+          attr: metadata.ttlAttribute
+        });
+      }
+    }
+  }
+  return {
+    version: SPEC_VERSION,
+    tables: sortedRecord(tables),
+    entities
+  };
+}
+
+// src/spec/prepared-artifact.ts
+var PREPARED_FORMAT_VERSION = "2";
+function canonicalJson(value) {
+  return JSON.stringify(value, (_k, v) => {
+    if (v !== null && typeof v === "object" && !Array.isArray(v)) {
+      const sorted = {};
+      for (const key of Object.keys(v).sort()) {
+        sorted[key] = v[key];
+      }
+      return sorted;
+    }
+    return v;
+  });
+}
+var FNV64_OFFSET_BASIS = 0xcbf29ce484222325n;
+var FNV64_PRIME = 0x100000001b3n;
+var U64_MASK = 0xffffffffffffffffn;
+function fnv1a64Hex(input) {
+  let hash = FNV64_OFFSET_BASIS;
+  for (let i = 0; i < input.length; i++) {
+    const unit = input.charCodeAt(i);
+    hash ^= BigInt(unit & 255);
+    hash = hash * FNV64_PRIME & U64_MASK;
+    hash ^= BigInt(unit >>> 8);
+    hash = hash * FNV64_PRIME & U64_MASK;
+  }
+  return hash.toString(16).padStart(16, "0");
+}
+function entityFingerprint(metadata) {
+  return fnv1a64Hex(canonicalJson(buildManifestEntity(metadata)));
+}
+function planFingerprint(plan) {
+  return fnv1a64Hex(canonicalJson(plan));
+}
+
+export {
+  buildManifestEntity,
+  buildManifest,
+  PREPARED_FORMAT_VERSION,
+  canonicalJson,
+  entityFingerprint,
+  planFingerprint
+};