@metaobjectsdev/codegen-ts 0.5.0-rc.1

package/dist/naming.d.ts

@@ -0,0 +1,29 @@
+import type { ColumnNamingStrategy } from "./metaobjects-config.js";
+/**
+ * Convert PascalCase or camelCase to snake_case.
+ * Treats consecutive capitals (e.g., "APIKey") as a single word: "api_key".
+ */
+export declare function toSnakeCase(s: string): string;
+/**
+ * Convert snake_case to camelCase. Preserves already-camelCase input.
+ */
+export declare function toCamelCase(s: string): string;
+/**
+ * Simple English pluralization. Documented imperfection per design §13 #1:
+ * irregular plurals (Person → Persons, not People) are not handled.
+ * Users override via source[dbTable]@name in metadata.
+ */
+export declare function pluralize(s: string): string;
+/** PascalCase entity → strategy-applied plural for DB table name. */
+export declare function tableNameFromEntity(entityName: string, strategy?: ColumnNamingStrategy): string;
+/** camelCase or PascalCase field → strategy-applied DB column name. */
+export declare function columnNameFromField(fieldName: string, strategy?: ColumnNamingStrategy): string;
+/**
+ * PascalCase projection name → "v_" prefix + strategy applied (not pluralized).
+ * E.g. "ProgramSummary" + snake_case → "v_program_summary".
+ * With kebab-case the separator prefix is "v-" to stay consistent.
+ */
+export declare function viewNameFromProjection(projectionName: string, strategy: ColumnNamingStrategy): string;
+/** PascalCase entity → camelCase plural for the Drizzle table variable. */
+export declare function variableNameFromEntity(entityName: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAgBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,oBAAmC,GAC5C,MAAM,CAER;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,oBAAmC,GAC5C,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAMR;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/naming.js

@@ -0,0 +1,67 @@
+// Naming helpers — case conversion + pluralization for codegen output.
+// All functions are pure.
+/**
+ * Convert PascalCase or camelCase to snake_case.
+ * Treats consecutive capitals (e.g., "APIKey") as a single word: "api_key".
+ */
+export function toSnakeCase(s) {
+    return s
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .toLowerCase();
+}
+/** Convert PascalCase or camelCase to kebab-case. */
+function toKebabCase(s) {
+    return toSnakeCase(s).replace(/_/g, "-");
+}
+/** Apply a ColumnNamingStrategy to a name. */
+function applyStrategy(name, strategy) {
+    switch (strategy) {
+        case "snake_case": return toSnakeCase(name);
+        case "literal": return name;
+        case "kebab-case": return toKebabCase(name);
+    }
+}
+/**
+ * Convert snake_case to camelCase. Preserves already-camelCase input.
+ */
+export function toCamelCase(s) {
+    return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * Simple English pluralization. Documented imperfection per design §13 #1:
+ * irregular plurals (Person → Persons, not People) are not handled.
+ * Users override via source[dbTable]@name in metadata.
+ */
+export function pluralize(s) {
+    if (/(s|x|z|ch|sh)$/i.test(s))
+        return s + "es";
+    if (/[^aeiou]y$/i.test(s))
+        return s.slice(0, -1) + "ies";
+    return s + "s";
+}
+/** PascalCase entity → strategy-applied plural for DB table name. */
+export function tableNameFromEntity(entityName, strategy = "snake_case") {
+    return applyStrategy(pluralize(entityName), strategy);
+}
+/** camelCase or PascalCase field → strategy-applied DB column name. */
+export function columnNameFromField(fieldName, strategy = "snake_case") {
+    return applyStrategy(fieldName, strategy);
+}
+/**
+ * PascalCase projection name → "v_" prefix + strategy applied (not pluralized).
+ * E.g. "ProgramSummary" + snake_case → "v_program_summary".
+ * With kebab-case the separator prefix is "v-" to stay consistent.
+ */
+export function viewNameFromProjection(projectionName, strategy) {
+    switch (strategy) {
+        case "snake_case": return "v_" + toSnakeCase(projectionName);
+        case "literal": return "v_" + projectionName;
+        case "kebab-case": return "v-" + toKebabCase(projectionName);
+    }
+}
+/** PascalCase entity → camelCase plural for the Drizzle table variable. */
+export function variableNameFromEntity(entityName) {
+    return pluralize(toCamelCase(entityName.charAt(0).toLowerCase() + entityName.slice(1)));
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,0BAA0B;AAI1B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC;SACL,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,qDAAqD;AACrD,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,8CAA8C;AAC9C,SAAS,aAAa,CAAC,IAAY,EAAE,QAA8B;IACjE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY,CAAC,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5C,KAAK,SAAS,CAAC,CAAI,OAAO,IAAI,CAAC;QAC/B,KAAK,YAAY,CAAC,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACzD,OAAO,CAAC,GAAG,GAAG,CAAC;AACjB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,WAAiC,YAAY;IAE7C,OAAO,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,WAAiC,YAAY;IAE7C,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAsB,EACtB,QAA8B;IAE9B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY,CAAC,CAAC,OAAO,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;QAC7D,KAAK,SAAS,CAAC,CAAI,OAAO,IAAI,GAAG,cAAc,CAAC;QAChD,KAAK,YAAY,CAAC,CAAC,OAAO,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC"}

package/dist/overwrite-policy.d.ts

@@ -0,0 +1,8 @@
+export type WriteStatus = "new" | "overwrite" | "refused" | "skipped";
+export type MergeStrategy = "overwrite" | "skip-existing";
+export interface WriteResult {
+    path: string;
+    status: WriteStatus;
+}
+export declare function decideAndWrite(path: string, content: string, strategy?: MergeStrategy): WriteResult;
+//# sourceMappingURL=overwrite-policy.d.ts.map

package/dist/overwrite-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overwrite-policy.d.ts","sourceRoot":"","sources":["../src/overwrite-policy.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,eAAe,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAA2B,GACpC,WAAW,CAmBb"}

package/dist/overwrite-policy.js

@@ -0,0 +1,23 @@
+// Overwrite policy: drives the per-file write decision based on the @generated header.
+// Per design §8 — read-only generated files; refuse to clobber hand-written code.
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { GENERATED_HEADER } from "./constants.js";
+export function decideAndWrite(path, content, strategy = "overwrite") {
+    // 'skip-existing' only skips overwrites, not new files.
+    if (!existsSync(path)) {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content);
+        return { path, status: "new" };
+    }
+    const current = readFileSync(path, "utf-8");
+    if (!current.includes(GENERATED_HEADER)) {
+        return { path, status: "refused" };
+    }
+    if (strategy === "skip-existing") {
+        return { path, status: "skipped" };
+    }
+    writeFileSync(path, content);
+    return { path, status: "overwrite" };
+}
+//# sourceMappingURL=overwrite-policy.js.map

package/dist/overwrite-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overwrite-policy.js","sourceRoot":"","sources":["../src/overwrite-policy.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,kFAAkF;AAElF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAUlD,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAe,EACf,WAA0B,WAAW;IAErC,wDAAwD;IACxD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC"}

package/dist/pk-resolver.d.ts

@@ -0,0 +1,18 @@
+import type { MetaRoot } from "@metaobjectsdev/metadata";
+export interface PkInfo {
+    /** Field name within the entity (e.g., "id"). */
+    fieldName: string;
+    /** Field subType (e.g., "long", "string", "int"). */
+    fieldSubType: string;
+    /** Generation strategy: 'increment' | 'uuid' | 'assigned' (or undefined). */
+    generation?: string;
+}
+/**
+ * Walk the loaded metadata root, find each object's primary identity,
+ * resolve the referenced field's subType, and build a name → PkInfo map.
+ *
+ * Used by FK column emission: when Post.authorId references User, codegen
+ * looks up User's PK info to choose the matching FK column type.
+ */
+export declare function buildPkMap(root: MetaRoot): Map<string, PkInfo>;
+//# sourceMappingURL=pk-resolver.d.ts.map

package/dist/pk-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pk-resolver.d.ts","sourceRoot":"","sources":["../src/pk-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOzD,MAAM,WAAW,MAAM;IACrB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB9D"}

package/dist/pk-resolver.js

@@ -0,0 +1,36 @@
+// PK resolver — pre-pass over the loaded metadata to build a name → PK info map.
+// codegen uses this when emitting FK columns (per design §13 #2).
+import { FIELD_SUBTYPE_LONG, IDENTITY_ATTR_FIELDS, IDENTITY_ATTR_GENERATION, } from "@metaobjectsdev/metadata";
+/**
+ * Walk the loaded metadata root, find each object's primary identity,
+ * resolve the referenced field's subType, and build a name → PkInfo map.
+ *
+ * Used by FK column emission: when Post.authorId references User, codegen
+ * looks up User's PK info to choose the matching FK column type.
+ */
+export function buildPkMap(root) {
+    const result = new Map();
+    for (const obj of root.objects()) {
+        // primaryIdentity() resolves the primary identity across the super-chain.
+        const primary = obj.primaryIdentity();
+        if (!primary)
+            continue;
+        const fields = primary.ownAttr(IDENTITY_ATTR_FIELDS);
+        if (!Array.isArray(fields) && typeof fields !== "string")
+            continue;
+        const fieldsList = Array.isArray(fields) ? fields : [fields];
+        if (fieldsList.length === 0)
+            continue;
+        const pkFieldName = String(fieldsList[0]);
+        // findField() resolves the field across the super-chain (handles extends:).
+        const pkField = obj.findField(pkFieldName);
+        const fieldSubType = pkField?.subType ?? FIELD_SUBTYPE_LONG; // sane default
+        const generation = primary.ownAttr(IDENTITY_ATTR_GENERATION);
+        const info = { fieldName: pkFieldName, fieldSubType };
+        if (typeof generation === "string")
+            info.generation = generation;
+        result.set(obj.name, info);
+    }
+    return result;
+}
+//# sourceMappingURL=pk-resolver.js.map

package/dist/pk-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pk-resolver.js","sourceRoot":"","sources":["../src/pk-resolver.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kEAAkE;AAGlE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAWlC;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACjC,0EAA0E;QAC1E,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,SAAS;QACnE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,4EAA4E;QAC5E,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,OAAO,EAAE,OAAO,IAAI,kBAAkB,CAAC,CAAC,eAAe;QAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAW,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;QAC9D,IAAI,OAAO,UAAU,KAAK,QAAQ;YAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QACjE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/projection/extract-view-spec.d.ts

@@ -0,0 +1,18 @@
+import { type MetaRoot, MetaObject } from "@metaobjectsdev/metadata";
+import type { ColumnNamingStrategy } from "../metaobjects-config.js";
+import type { ViewSpec } from "./view-spec.js";
+export interface ExtractContext {
+    readonly columnNamingStrategy: ColumnNamingStrategy;
+}
+/**
+ * Walk a projection's origin children to produce a ViewSpec.
+ *
+ * @param projection  The projection entity (has a source[dbView] child
+ *                    and extends a writable entity).
+ * @param root        The loader's MetaRoot — all top-level objects are
+ *                    direct children of root (returned by `MetaDataLoader.load()`
+ *                    / `FileMetaDataLoader.loadFiles()` as `result.root`).
+ * @param ctx         Column naming strategy for SQL identifiers.
+ */
+export declare function extractViewSpec(projection: MetaObject, root: MetaRoot, ctx: ExtractContext): ViewSpec;
+//# sourceMappingURL=extract-view-spec.d.ts.map

package/dist/projection/extract-view-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-view-spec.d.ts","sourceRoot":"","sources":["../../src/projection/extract-view-spec.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAiB,KAAK,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EACoC,QAAQ,EACvD,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;CACrD;AAkTD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,cAAc,GAClB,QAAQ,CAcV"}

package/dist/projection/extract-view-spec.js

@@ -0,0 +1,272 @@
+import { TYPE_FIELD, TYPE_ORIGIN, TYPE_RELATIONSHIP, TYPE_SOURCE, SOURCE_SUBTYPE_DB_VIEW, SOURCE_DB_VIEW_ATTR_NAME, ORIGIN_SUBTYPE_PASSTHROUGH, ORIGIN_SUBTYPE_AGGREGATE, ORIGIN_PASSTHROUGH_ATTR_FROM, ORIGIN_PASSTHROUGH_ATTR_VIA, ORIGIN_AGGREGATE_ATTR_AGG, ORIGIN_AGGREGATE_ATTR_OF, ORIGIN_AGGREGATE_ATTR_VIA, RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_ATTR_CARDINALITY, CARDINALITY_ONE, FIELD_ATTR_DB_COLUMN, findReferenceBetween, } from "@metaobjectsdev/metadata";
+import { MetaObject } from "@metaobjectsdev/metadata";
+import { columnNameFromField, viewNameFromProjection, } from "../naming.js";
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+function findRelationship(obj, name) {
+    return obj.ownChildren().find((c) => c.type === TYPE_RELATIONSHIP && c.name === name);
+}
+function viewName(projection, ctx) {
+    const dbView = projection.ownChildren().find((c) => c.type === TYPE_SOURCE && c.subType === SOURCE_SUBTYPE_DB_VIEW);
+    const explicit = dbView?.ownAttr(SOURCE_DB_VIEW_ATTR_NAME);
+    return explicit ?? viewNameFromProjection(projection.name, ctx.columnNamingStrategy);
+}
+function baseEntityFor(projection, root) {
+    // v1: base entity is the resolved super (set via `extends:` in metadata).
+    const superModel = projection.superResolved;
+    const superName = superModel?.name ?? projection.superRef;
+    if (!superName) {
+        throw new Error(`Projection ${projection.name}: missing extends — projections must extend a writable entity in v1.`);
+    }
+    const base = superModel instanceof MetaObject ? superModel : root.findObject(superName);
+    if (!base) {
+        throw new Error(`Projection ${projection.name}: extends "${superName}" does not resolve to any entity.`);
+    }
+    return base;
+}
+function sourceColumnNameFor(entityField, ctx) {
+    const explicit = entityField.ownAttr(FIELD_ATTR_DB_COLUMN);
+    return explicit ?? columnNameFromField(entityField.name, ctx.columnNamingStrategy);
+}
+function shortAliasFor(entityName, used) {
+    const base = (entityName[0] ?? "x").toLowerCase();
+    if (!used.has(base)) {
+        used.add(base);
+        return base;
+    }
+    let i = 0;
+    let candidate;
+    do {
+        candidate = `${base}${i}`;
+        i++;
+    } while (used.has(candidate));
+    used.add(candidate);
+    return candidate;
+}
+function buildJoinTree(projection, base, root, usedAliases, baseAlias) {
+    const allPaths = [];
+    for (const field of projection.ownChildren()) {
+        if (field.type !== TYPE_FIELD)
+            continue;
+        for (const origin of field.ownChildren()) {
+            if (origin.type !== TYPE_ORIGIN)
+                continue;
+            const viaAttr = origin.subType === ORIGIN_SUBTYPE_AGGREGATE
+                ? origin.ownAttr(ORIGIN_AGGREGATE_ATTR_VIA)
+                : origin.ownAttr(ORIGIN_PASSTHROUGH_ATTR_VIA);
+            if (!viaAttr)
+                continue;
+            const segments = viaAttr.split(".");
+            const entityName = segments[0];
+            const relSegments = segments.slice(1);
+            if (!entityName)
+                continue;
+            let currentObj = root.findObject(entityName);
+            if (!currentObj)
+                continue;
+            const path = [];
+            for (const relName of relSegments) {
+                const rel = findRelationship(currentObj, relName);
+                if (!rel)
+                    break;
+                const targetName = rel.ownAttr(RELATIONSHIP_ATTR_OBJECT_REF);
+                const target = targetName ? root.findObject(targetName) : undefined;
+                if (!target || !targetName)
+                    break;
+                const cardAttr = rel.ownAttr(RELATIONSHIP_ATTR_CARDINALITY);
+                const cardinality = cardAttr === CARDINALITY_ONE ? "one" : "many";
+                const ref = findReferenceBetween(currentObj, target);
+                if (!ref)
+                    break;
+                const fkField = ref.referenceIdentity.fields[0];
+                if (!fkField)
+                    break;
+                const resolvedPkField = ref.referenceIdentity.resolvedTargetPkField(root) ?? "id";
+                const referenceHolder = ref.holder.name === currentObj.name ? "source" : "target";
+                path.push({
+                    entity: currentObj,
+                    relationship: relName,
+                    cardinality,
+                    fkField,
+                    pkField: resolvedPkField,
+                    referenceHolder,
+                    targetEntity: targetName,
+                });
+                currentObj = target;
+            }
+            if (path.length > 0)
+                allPaths.push(path);
+        }
+    }
+    // Dedupe by prefix: paths sharing a prefix collapse into one join branch.
+    const trieRoot = { children: new Map() };
+    for (const path of allPaths) {
+        let node = trieRoot;
+        for (const step of path) {
+            let child = node.children.get(step.relationship);
+            if (!child) {
+                child = { children: new Map(), step };
+                node.children.set(step.relationship, child);
+            }
+            node = child;
+        }
+    }
+    function toJoinNode(node) {
+        const step = node.step;
+        return {
+            relationship: step.relationship,
+            targetEntity: step.targetEntity,
+            alias: shortAliasFor(step.targetEntity, usedAliases),
+            cardinality: step.cardinality,
+            fkField: step.fkField,
+            pkField: step.pkField,
+            referenceHolder: step.referenceHolder,
+            children: Array.from(node.children.values()).map(toJoinNode),
+        };
+    }
+    return {
+        baseEntity: base.name,
+        baseAlias,
+        joins: Array.from(trieRoot.children.values()).map(toJoinNode),
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers for SelectSpec building
+// ---------------------------------------------------------------------------
+function findAliasInTree(joinTree, entityName) {
+    if (joinTree.baseEntity === entityName)
+        return joinTree.baseAlias;
+    function recurse(nodes) {
+        for (const n of nodes) {
+            if (n.targetEntity === entityName)
+                return n.alias;
+            const found = recurse(n.children);
+            if (found !== undefined)
+                return found;
+        }
+        return undefined;
+    }
+    return recurse(joinTree.joins);
+}
+function buildSelectSpec(projection, base, joinTree, root, ctx) {
+    const columns = [];
+    // Inherited fields from extends parent — emit as passthrough on baseAlias.
+    // Skip fields that the projection has overridden with an explicit origin.
+    // fields() is effective-by-default, so multi-level inheritance (base → BaseEntity) works.
+    for (const baseField of base.fields()) {
+        const overridden = projection.ownChildren().find((c) => c.type === TYPE_FIELD && c.name === baseField.name);
+        if (overridden)
+            continue;
+        columns.push({
+            kind: "passthrough",
+            fieldName: baseField.name,
+            dbColAlias: sourceColumnNameFor(baseField, ctx),
+            sourceAlias: joinTree.baseAlias,
+            sourceColumn: sourceColumnNameFor(baseField, ctx),
+        });
+    }
+    // Fields explicitly declared on the projection.
+    for (const field of projection.ownChildren()) {
+        if (field.type !== TYPE_FIELD)
+            continue;
+        const origin = field.ownChildren().find((c) => c.type === TYPE_ORIGIN);
+        const dbCol = sourceColumnNameFor(field, ctx);
+        if (!origin) {
+            // Declared on projection but no origin — passthrough from base table.
+            columns.push({
+                kind: "passthrough",
+                fieldName: field.name,
+                dbColAlias: dbCol,
+                sourceAlias: joinTree.baseAlias,
+                sourceColumn: dbCol,
+            });
+            continue;
+        }
+        if (origin.subType === ORIGIN_SUBTYPE_PASSTHROUGH) {
+            const from = origin.ownAttr(ORIGIN_PASSTHROUGH_ATTR_FROM);
+            const dotIdx = from.indexOf(".");
+            if (dotIdx < 1)
+                continue;
+            const entityName = from.slice(0, dotIdx);
+            const fieldName = from.slice(dotIdx + 1);
+            const targetEntity = root.findObject(entityName);
+            const sourceAlias = findAliasInTree(joinTree, entityName);
+            if (!targetEntity || sourceAlias === undefined)
+                continue;
+            const targetField = targetEntity.ownChildren().find((c) => c.type === TYPE_FIELD && c.name === fieldName);
+            if (!targetField)
+                continue;
+            columns.push({
+                kind: "passthrough",
+                fieldName: field.name,
+                dbColAlias: dbCol,
+                sourceAlias,
+                sourceColumn: sourceColumnNameFor(targetField, ctx),
+            });
+        }
+        else if (origin.subType === ORIGIN_SUBTYPE_AGGREGATE) {
+            const agg = origin.ownAttr(ORIGIN_AGGREGATE_ATTR_AGG);
+            const of_ = origin.ownAttr(ORIGIN_AGGREGATE_ATTR_OF);
+            if (!agg || !of_)
+                continue;
+            const dotIdx = of_.indexOf(".");
+            if (dotIdx < 1)
+                continue;
+            const entityName = of_.slice(0, dotIdx);
+            const fieldName = of_.slice(dotIdx + 1);
+            const targetEntity = root.findObject(entityName);
+            const sourceAlias = findAliasInTree(joinTree, entityName);
+            if (!targetEntity || sourceAlias === undefined)
+                continue;
+            const targetField = targetEntity.ownChildren().find((c) => c.type === TYPE_FIELD && c.name === fieldName);
+            if (!targetField)
+                continue;
+            columns.push({
+                kind: "aggregate",
+                fieldName: field.name,
+                dbColAlias: dbCol,
+                agg,
+                sourceAlias,
+                sourceColumn: sourceColumnNameFor(targetField, ctx),
+            });
+        }
+    }
+    return { columns };
+}
+function buildGroupBy(spec) {
+    const hasAgg = spec.columns.some((c) => c.kind === "aggregate");
+    if (!hasAgg)
+        return [];
+    return spec.columns
+        .filter((c) => c.kind === "passthrough")
+        .map((c) => `${c.sourceAlias}.${c.sourceColumn}`);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Walk a projection's origin children to produce a ViewSpec.
+ *
+ * @param projection  The projection entity (has a source[dbView] child
+ *                    and extends a writable entity).
+ * @param root        The loader's MetaRoot — all top-level objects are
+ *                    direct children of root (returned by `MetaDataLoader.load()`
+ *                    / `FileMetaDataLoader.loadFiles()` as `result.root`).
+ * @param ctx         Column naming strategy for SQL identifiers.
+ */
+export function extractViewSpec(projection, root, ctx) {
+    const base = baseEntityFor(projection, root);
+    const usedAliases = new Set();
+    const baseAlias = shortAliasFor(base.name, usedAliases);
+    const joinTree = buildJoinTree(projection, base, root, usedAliases, baseAlias);
+    const selectSpec = buildSelectSpec(projection, base, joinTree, root, ctx);
+    const groupBy = buildGroupBy(selectSpec);
+    return {
+        viewName: viewName(projection, ctx),
+        joinTree,
+        selectSpec,
+        groupBy,
+    };
+}
+//# sourceMappingURL=extract-view-spec.js.map

package/dist/projection/extract-view-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-view-spec.js","sourceRoot":"","sources":["../../src/projection/extract-view-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,eAAe,EACf,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAgC,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AActB,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,GAAa,EAAE,IAAY;IACnD,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,UAAsB,EAAE,GAAmB;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,KAAK,sBAAsB,CACtE,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,wBAAwB,CAAuB,CAAC;IACjF,OAAO,QAAQ,IAAI,sBAAsB,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,aAAa,CACpB,UAAsB,EACtB,IAAc;IAEd,0EAA0E;IAC1E,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAC;IAC5C,MAAM,SAAS,GAAG,UAAU,EAAE,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC;IAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,cAAc,UAAU,CAAC,IAAI,sEAAsE,CACpG,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GACR,UAAU,YAAY,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,cAAc,UAAU,CAAC,IAAI,cAAc,SAAS,mCAAmC,CACxF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAqB,EACrB,GAAmB;IAEnB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,oBAAoB,CAAuB,CAAC;IACjF,OAAO,QAAQ,IAAI,mBAAmB,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB,EAAE,IAAiB;IAC1D,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IACrD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,SAAiB,CAAC;IACtB,GAAG,CAAC;QAAC,SAAS,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;QAAC,CAAC,EAAE,CAAC;IAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;IACnE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpB,OAAO,SAAS,CAAC;AACnB,CAAC;AAwBD,SAAS,aAAa,CACpB,UAAsB,EACtB,IAAgB,EAChB,IAAc,EACd,WAAwB,EACxB,SAAiB;IAEjB,MAAM,QAAQ,GAAW,EAAE,CAAC;IAE5B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACxC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS;YAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,wBAAwB;gBACzD,CAAC,CAAE,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAwB;gBACnE,CAAC,CAAE,MAAM,CAAC,OAAO,CAAC,2BAA2B,CAAwB,CAAC;YACxE,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,UAAU;gBAAE,SAAS;YAC1B,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,MAAM,IAAI,GAAS,EAAE,CAAC;YACtB,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAClD,IAAI,CAAC,GAAG;oBAAE,MAAM;gBAChB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,4BAA4B,CAAuB,CAAC;gBACnF,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpE,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU;oBAAE,MAAM;gBAElC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,6BAA6B,CAAuB,CAAC;gBAClF,MAAM,WAAW,GAAmB,QAAQ,KAAK,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBAElF,MAAM,GAAG,GAAG,oBAAoB,CAAC,UAAwB,EAAE,MAAM,CAAC,CAAC;gBACnE,IAAI,CAAC,GAAG;oBAAE,MAAM;gBAEhB,MAAM,OAAO,GAAG,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAChD,IAAI,CAAC,OAAO;oBAAE,MAAM;gBAEpB,MAAM,eAAe,GAAG,GAAG,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;gBAElF,MAAM,eAAe,GACnB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAE5D,IAAI,CAAC,IAAI,CAAC;oBACR,MAAM,EAAE,UAAU;oBAClB,YAAY,EAAE,OAAO;oBACrB,WAAW;oBACX,OAAO;oBACP,OAAO,EAAE,eAAe;oBACxB,eAAe;oBACf,YAAY,EAAE,UAAU;iBACzB,CAAC,CAAC;gBACH,UAAU,GAAG,MAAM,CAAC;YACtB,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,MAAM,QAAQ,GAAa,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC;gBACtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,SAAS,UAAU,CAAC,IAAc;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAK,CAAC;QACxB,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC;YACpD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;SAC7D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,IAAI;QACrB,SAAS;QACT,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,SAAS,eAAe,CACtB,QAAkB,EAClB,UAAkB;IAElB,IAAI,QAAQ,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAC;IAElE,SAAS,OAAO,CAAC,KAA0B;QACzC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,YAAY,KAAK,UAAU;gBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;YAClD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;QACxC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CACtB,UAAsB,EACtB,IAAgB,EAChB,QAAkB,EAClB,IAAc,EACd,GAAmB;IAEnB,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,2EAA2E;IAC3E,0EAA0E;IAC1E,0FAA0F;IAC1F,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAC1D,CAAC;QACF,IAAI,UAAU;YAAE,SAAS;QACzB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,SAAS,CAAC,IAAI;YACzB,UAAU,EAAE,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC;YAC/C,WAAW,EAAE,QAAQ,CAAC,SAAS;YAC/B,YAAY,EAAE,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC;SAClD,CAAC,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,sEAAsE;YACtE,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,UAAU,EAAE,KAAK;gBACjB,WAAW,EAAE,QAAQ,CAAC,SAAS;gBAC/B,YAAY,EAAE,KAAK;aACpB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,0BAA0B,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAW,CAAC;YACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,GAAG,CAAC;gBAAE,SAAS;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC1D,IAAI,CAAC,YAAY,IAAI,WAAW,KAAK,SAAS;gBAAE,SAAS;YACzD,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CACrD,CAAC;YACF,IAAI,CAAC,WAAW;gBAAE,SAAS;YAC3B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,UAAU,EAAE,KAAK;gBACjB,WAAW;gBACX,YAAY,EAAE,mBAAmB,CAAC,WAAW,EAAE,GAAG,CAAC;aACpD,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,KAAK,wBAAwB,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAsB,CAAC;YAC3E,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAW,CAAC;YAC/D,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;gBAAE,SAAS;YAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,MAAM,GAAG,CAAC;gBAAE,SAAS;YACzB,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACxC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC1D,IAAI,CAAC,YAAY,IAAI,WAAW,KAAK,SAAS;gBAAE,SAAS;YACzD,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CACrD,CAAC;YACF,IAAI,CAAC,WAAW;gBAAE,SAAS;YAC3B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,UAAU,EAAE,KAAK;gBACjB,GAAG;gBACH,WAAW;gBACX,YAAY,EAAE,mBAAmB,CAAC,WAAW,EAAE,GAAG,CAAC;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,YAAY,CAAC,IAAgB;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC,OAAO;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAsB,EACtB,IAAc,EACd,GAAmB;IAEnB,MAAM,IAAI,GAAG,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAEzC,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;QACnC,QAAQ;QACR,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/projection/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./view-spec.js";
+export * from "./extract-view-spec.js";
+export * from "./view-ddl-emit.js";
+export * from "./projection-detector.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/projection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/projection/index.js

@@ -0,0 +1,5 @@
+export * from "./view-spec.js";
+export * from "./extract-view-spec.js";
+export * from "./view-ddl-emit.js";
+export * from "./projection-detector.js";
+//# sourceMappingURL=index.js.map

package/dist/projection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/projection/projection-detector.d.ts

@@ -0,0 +1,4 @@
+import type { MetaData } from "@metaobjectsdev/metadata";
+export declare function isProjection(entity: MetaData): boolean;
+export declare function isWriteThrough(entity: MetaData): boolean;
+//# sourceMappingURL=projection-detector.d.ts.map

package/dist/projection/projection-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-detector.d.ts","sourceRoot":"","sources":["../../src/projection/projection-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAQzD,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAKtD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAKxD"}

package/dist/projection/projection-detector.js

@@ -0,0 +1,13 @@
+import { TYPE_SOURCE, SOURCE_SUBTYPE_DB_TABLE, SOURCE_SUBTYPE_DB_VIEW, } from "@metaobjectsdev/metadata";
+function hasSource(entity, subType) {
+    return entity.ownChildren().some((c) => c.type === TYPE_SOURCE && c.subType === subType);
+}
+export function isProjection(entity) {
+    return (hasSource(entity, SOURCE_SUBTYPE_DB_VIEW) &&
+        !hasSource(entity, SOURCE_SUBTYPE_DB_TABLE));
+}
+export function isWriteThrough(entity) {
+    return (hasSource(entity, SOURCE_SUBTYPE_DB_VIEW) &&
+        hasSource(entity, SOURCE_SUBTYPE_DB_TABLE));
+}
+//# sourceMappingURL=projection-detector.js.map

package/dist/projection/projection-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-detector.js","sourceRoot":"","sources":["../../src/projection/projection-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,SAAS,SAAS,CAAC,MAAgB,EAAE,OAAe;IAClD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAgB;IAC3C,OAAO,CACL,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC;QACzC,CAAC,SAAS,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAgB;IAC7C,OAAO,CACL,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC;QACzC,SAAS,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAC3C,CAAC;AACJ,CAAC"}

package/dist/projection/view-ddl-emit.d.ts

@@ -0,0 +1,10 @@
+import type { ViewSpec } from "./view-spec.js";
+export interface EmitOptions {
+    readonly dialect: "postgres" | "sqlite";
+    /** Resolved table name for the JoinTree's base entity. */
+    readonly baseTableName: string;
+    /** Map from entity name → table name for every entity referenced in joins. */
+    readonly joinTables: Readonly<Record<string, string>>;
+}
+export declare function emitViewDdl(spec: ViewSpec, options: EmitOptions): string;
+//# sourceMappingURL=view-ddl-emit.d.ts.map

package/dist/projection/view-ddl-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-ddl-emit.d.ts","sourceRoot":"","sources":["../../src/projection/view-ddl-emit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAyCD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAexE"}