@prometheus-ags/entity-graph-sdl 3.2.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 # @prometheus-ags/entity-graph-sdl
 
+## 4.0.0
+
 ## 3.2.0
 
 ### Minor Changes

package/package.json

@@ -1,23 +1,17 @@
 {
   "name": "@prometheus-ags/entity-graph-sdl",
-  "version": "3.2.0",
+  "version": "4.0.1",
   "description": "Schema Definition Language (SDL) for the entity graph — the shared contract every code generator (Rust CLI, Flutter, framework bindings) consumes.",
   "author": "Travis James <travis@prometheus.dev>",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.cjs",
+  "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
     }
   },
   "sideEffects": false,
@@ -29,6 +23,13 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "refresh:exports": "pnpm run build && node ../../scripts/refresh-exports-ledger.mjs --pkg sdl",
+    "verify:skills": "node ../../scripts/verify-skills-exports.mjs --pkg sdl"
+  },
   "keywords": [
     "entity-graph",
     "schema",
@@ -46,12 +47,5 @@
   },
   "engines": {
     "node": "^22.14.0 || ^24.0.0 || >=26.0.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run",
-    "refresh:exports": "pnpm run build && node ../../scripts/refresh-exports-ledger.mjs --pkg sdl",
-    "verify:skills": "node ../../scripts/verify-skills-exports.mjs --pkg sdl"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Travis James / Prometheus AGS / KnowMe LLC
-
-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/dist/index.cjs

@@ -1,92 +0,0 @@
-'use strict';
-
-// src/index.ts
-var SdlValidationError = class extends Error {
-  path;
-  constructor(message, path) {
-    super(`${message} (at ${path})`);
-    this.name = "SdlValidationError";
-    this.path = path;
-  }
-};
-var SCALAR_TYPES = /* @__PURE__ */ new Set([
-  "string",
-  "number",
-  "integer",
-  "decimal",
-  "boolean",
-  "datetime",
-  "date",
-  "json",
-  "enum",
-  "uuid"
-]);
-function parseSdl(doc) {
-  if (!isObject(doc)) throw new SdlValidationError("SDL root must be an object", "$");
-  const version = typeof doc.version === "string" ? doc.version : "1.0";
-  if (!isObject(doc.entities)) throw new SdlValidationError("`entities` must be an object", "$.entities");
-  const entities = [];
-  for (const [name, raw] of Object.entries(doc.entities)) {
-    const path = `$.entities.${name}`;
-    if (!isObject(raw) || !isObject(raw.fields)) {
-      throw new SdlValidationError("entity must have a `fields` object", path);
-    }
-    const def = raw;
-    const fields = [];
-    let primaryKey = null;
-    for (const [fname, fdefRaw] of Object.entries(def.fields)) {
-      const fpath = `${path}.fields.${fname}`;
-      if (!isObject(fdefRaw)) throw new SdlValidationError("field must be an object", fpath);
-      const fdef = fdefRaw;
-      if (!SCALAR_TYPES.has(fdef.type)) throw new SdlValidationError(`unknown field type "${fdef.type}"`, fpath);
-      if (fdef.type === "enum" && (!Array.isArray(fdef.values) || fdef.values.length === 0)) {
-        throw new SdlValidationError("enum field requires non-empty `values`", fpath);
-      }
-      if (fdef.primary) {
-        if (primaryKey) throw new SdlValidationError("multiple primary keys not supported", fpath);
-        primaryKey = fname;
-      }
-      fields.push({ ...fdef, name: fname });
-    }
-    if (!primaryKey) throw new SdlValidationError("entity needs exactly one `primary: true` field", path);
-    const relations = [];
-    for (const [rname, rdefRaw] of Object.entries(def.relations ?? {})) {
-      const rpath = `${path}.relations.${rname}`;
-      if (!isObject(rdefRaw)) throw new SdlValidationError("relation must be an object", rpath);
-      const rdef = rdefRaw;
-      if (!["belongsTo", "hasMany", "manyToMany"].includes(rdef.type)) {
-        throw new SdlValidationError(`unknown relation type "${rdef.type}"`, rpath);
-      }
-      if (typeof rdef.target !== "string") throw new SdlValidationError("relation needs a `target`", rpath);
-      relations.push({ ...rdef, name: rname });
-    }
-    entities.push({ name, table: def.table ?? name, primaryKey, fields, relations });
-  }
-  const names = new Set(entities.map((e) => e.name));
-  for (const e of entities) {
-    for (const r of e.relations) {
-      if (!names.has(r.target)) {
-        throw new SdlValidationError(`relation target "${r.target}" is not a defined entity`, `$.entities.${e.name}.relations.${r.name}`);
-      }
-    }
-  }
-  return { version, entities, config: doc.config ?? {} };
-}
-function parseSdlJson(json) {
-  let doc;
-  try {
-    doc = JSON.parse(json);
-  } catch (cause) {
-    throw new SdlValidationError("invalid JSON", "$");
-  }
-  return parseSdl(doc);
-}
-function isObject(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-
-exports.SdlValidationError = SdlValidationError;
-exports.parseSdl = parseSdl;
-exports.parseSdlJson = parseSdlJson;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @prometheus-ags/entity-graph-sdl\n *\n * The Schema Definition Language (SDL) for the entity graph: a stable JSON/TOML\n * schema format + a parser that produces a validated intermediate\n * representation (IR). Every code generator (Rust CLI, Flutter, framework\n * bindings) consumes the SAME IR so generated targets never diverge.\n *\n * Format (schema.json):\n * {\n *   \"version\": \"1.0\",\n *   \"entities\": {\n *     \"user\": {\n *       \"fields\": { \"id\": {\"type\":\"string\",\"primary\":true}, \"name\": {\"type\":\"string\",\"required\":true} },\n *       \"relations\": { \"orders\": {\"type\":\"hasMany\",\"target\":\"order\",\"foreignKey\":\"userId\"} }\n *     }\n *   },\n *   \"config\": { \"localFirst\": {\"engine\":\"pglite\",\"sync\":\"electric\"}, \"ai\": {\"mcp\":true,\"a2a\":true} }\n * }\n */\n\n// ── Source format types ───────────────────────────────────────────────────\n\nexport type SdlScalarType =\n  | \"string\" | \"number\" | \"integer\" | \"decimal\" | \"boolean\"\n  | \"datetime\" | \"date\" | \"json\" | \"enum\" | \"uuid\";\n\nexport interface SdlFieldDef {\n  type: SdlScalarType;\n  primary?: boolean;\n  required?: boolean;\n  unique?: boolean;\n  default?: unknown;\n  /** For enum fields. */\n  values?: string[];\n  /** Auto-managed by the store/server (e.g. createdAt). */\n  auto?: boolean;\n}\n\nexport type SdlRelationKind = \"belongsTo\" | \"hasMany\" | \"manyToMany\";\n\nexport interface SdlRelationDef {\n  type: SdlRelationKind;\n  target: string;\n  foreignKey?: string;\n  /** For manyToMany. */\n  through?: string;\n}\n\nexport interface SdlEntityDef {\n  fields: Record<string, SdlFieldDef>;\n  relations?: Record<string, SdlRelationDef>;\n  /** Optional table name override (defaults to the entity key). */\n  table?: string;\n}\n\nexport interface SdlConfig {\n  localFirst?: { engine?: \"pglite\" | \"sqlite\" | \"none\"; sync?: \"electric\" | \"yjs\" | \"none\" };\n  ai?: { mcp?: boolean; a2a?: boolean };\n}\n\nexport interface SdlDocument {\n  version: string;\n  entities: Record<string, SdlEntityDef>;\n  config?: SdlConfig;\n}\n\n// ── Validated IR (what generators consume) ────────────────────────────────\n\nexport interface IrField extends SdlFieldDef {\n  name: string;\n}\nexport interface IrRelation extends SdlRelationDef {\n  name: string;\n}\nexport interface IrEntity {\n  name: string;\n  table: string;\n  primaryKey: string;\n  fields: IrField[];\n  relations: IrRelation[];\n}\nexport interface EntityGraphIR {\n  version: string;\n  entities: IrEntity[];\n  config: SdlConfig;\n}\n\nexport class SdlValidationError extends Error {\n  readonly path: string;\n  constructor(message: string, path: string) {\n    super(`${message} (at ${path})`);\n    this.name = \"SdlValidationError\";\n    this.path = path;\n  }\n}\n\nconst SCALAR_TYPES = new Set<SdlScalarType>([\n  \"string\", \"number\", \"integer\", \"decimal\", \"boolean\", \"datetime\", \"date\", \"json\", \"enum\", \"uuid\",\n]);\n\n/**\n * Parse + validate an SDL document into the generator IR. Throws\n * {@link SdlValidationError} with a precise path on the first problem.\n */\nexport function parseSdl(doc: unknown): EntityGraphIR {\n  if (!isObject(doc)) throw new SdlValidationError(\"SDL root must be an object\", \"$\");\n  const version = typeof doc.version === \"string\" ? doc.version : \"1.0\";\n  if (!isObject(doc.entities)) throw new SdlValidationError(\"`entities` must be an object\", \"$.entities\");\n\n  const entities: IrEntity[] = [];\n  for (const [name, raw] of Object.entries(doc.entities)) {\n    const path = `$.entities.${name}`;\n    if (!isObject(raw) || !isObject(raw.fields)) {\n      throw new SdlValidationError(\"entity must have a `fields` object\", path);\n    }\n    const def = raw as unknown as SdlEntityDef;\n\n    const fields: IrField[] = [];\n    let primaryKey: string | null = null;\n    for (const [fname, fdefRaw] of Object.entries(def.fields)) {\n      const fpath = `${path}.fields.${fname}`;\n      if (!isObject(fdefRaw)) throw new SdlValidationError(\"field must be an object\", fpath);\n      const fdef = fdefRaw as SdlFieldDef;\n      if (!SCALAR_TYPES.has(fdef.type)) throw new SdlValidationError(`unknown field type \"${fdef.type}\"`, fpath);\n      if (fdef.type === \"enum\" && (!Array.isArray(fdef.values) || fdef.values.length === 0)) {\n        throw new SdlValidationError(\"enum field requires non-empty `values`\", fpath);\n      }\n      if (fdef.primary) {\n        if (primaryKey) throw new SdlValidationError(\"multiple primary keys not supported\", fpath);\n        primaryKey = fname;\n      }\n      fields.push({ ...fdef, name: fname });\n    }\n    if (!primaryKey) throw new SdlValidationError(\"entity needs exactly one `primary: true` field\", path);\n\n    const relations: IrRelation[] = [];\n    for (const [rname, rdefRaw] of Object.entries(def.relations ?? {})) {\n      const rpath = `${path}.relations.${rname}`;\n      if (!isObject(rdefRaw)) throw new SdlValidationError(\"relation must be an object\", rpath);\n      const rdef = rdefRaw as SdlRelationDef;\n      if (![\"belongsTo\", \"hasMany\", \"manyToMany\"].includes(rdef.type)) {\n        throw new SdlValidationError(`unknown relation type \"${rdef.type}\"`, rpath);\n      }\n      if (typeof rdef.target !== \"string\") throw new SdlValidationError(\"relation needs a `target`\", rpath);\n      relations.push({ ...rdef, name: rname });\n    }\n\n    entities.push({ name, table: def.table ?? name, primaryKey, fields, relations });\n  }\n\n  // Cross-reference relation targets.\n  const names = new Set(entities.map((e) => e.name));\n  for (const e of entities) {\n    for (const r of e.relations) {\n      if (!names.has(r.target)) {\n        throw new SdlValidationError(`relation target \"${r.target}\" is not a defined entity`, `$.entities.${e.name}.relations.${r.name}`);\n      }\n    }\n  }\n\n  return { version, entities, config: (doc.config as SdlConfig) ?? {} };\n}\n\n/** Parse SDL from a JSON string. */\nexport function parseSdlJson(json: string): EntityGraphIR {\n  let doc: unknown;\n  try { doc = JSON.parse(json); } catch (cause) {\n    throw new SdlValidationError(\"invalid JSON\", \"$\");\n  }\n  return parseSdl(doc);\n}\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n"]}

package/dist/index.d.cts

@@ -1,92 +0,0 @@
-/**
- * @prometheus-ags/entity-graph-sdl
- *
- * The Schema Definition Language (SDL) for the entity graph: a stable JSON/TOML
- * schema format + a parser that produces a validated intermediate
- * representation (IR). Every code generator (Rust CLI, Flutter, framework
- * bindings) consumes the SAME IR so generated targets never diverge.
- *
- * Format (schema.json):
- * {
- *   "version": "1.0",
- *   "entities": {
- *     "user": {
- *       "fields": { "id": {"type":"string","primary":true}, "name": {"type":"string","required":true} },
- *       "relations": { "orders": {"type":"hasMany","target":"order","foreignKey":"userId"} }
- *     }
- *   },
- *   "config": { "localFirst": {"engine":"pglite","sync":"electric"}, "ai": {"mcp":true,"a2a":true} }
- * }
- */
-type SdlScalarType = "string" | "number" | "integer" | "decimal" | "boolean" | "datetime" | "date" | "json" | "enum" | "uuid";
-interface SdlFieldDef {
-    type: SdlScalarType;
-    primary?: boolean;
-    required?: boolean;
-    unique?: boolean;
-    default?: unknown;
-    /** For enum fields. */
-    values?: string[];
-    /** Auto-managed by the store/server (e.g. createdAt). */
-    auto?: boolean;
-}
-type SdlRelationKind = "belongsTo" | "hasMany" | "manyToMany";
-interface SdlRelationDef {
-    type: SdlRelationKind;
-    target: string;
-    foreignKey?: string;
-    /** For manyToMany. */
-    through?: string;
-}
-interface SdlEntityDef {
-    fields: Record<string, SdlFieldDef>;
-    relations?: Record<string, SdlRelationDef>;
-    /** Optional table name override (defaults to the entity key). */
-    table?: string;
-}
-interface SdlConfig {
-    localFirst?: {
-        engine?: "pglite" | "sqlite" | "none";
-        sync?: "electric" | "yjs" | "none";
-    };
-    ai?: {
-        mcp?: boolean;
-        a2a?: boolean;
-    };
-}
-interface SdlDocument {
-    version: string;
-    entities: Record<string, SdlEntityDef>;
-    config?: SdlConfig;
-}
-interface IrField extends SdlFieldDef {
-    name: string;
-}
-interface IrRelation extends SdlRelationDef {
-    name: string;
-}
-interface IrEntity {
-    name: string;
-    table: string;
-    primaryKey: string;
-    fields: IrField[];
-    relations: IrRelation[];
-}
-interface EntityGraphIR {
-    version: string;
-    entities: IrEntity[];
-    config: SdlConfig;
-}
-declare class SdlValidationError extends Error {
-    readonly path: string;
-    constructor(message: string, path: string);
-}
-/**
- * Parse + validate an SDL document into the generator IR. Throws
- * {@link SdlValidationError} with a precise path on the first problem.
- */
-declare function parseSdl(doc: unknown): EntityGraphIR;
-/** Parse SDL from a JSON string. */
-declare function parseSdlJson(json: string): EntityGraphIR;
-
-export { type EntityGraphIR, type IrEntity, type IrField, type IrRelation, type SdlConfig, type SdlDocument, type SdlEntityDef, type SdlFieldDef, type SdlRelationDef, type SdlRelationKind, type SdlScalarType, SdlValidationError, parseSdl, parseSdlJson };