@pgpmjs/transform 0.20.0 → 0.21.0

package/bundle-driver.js

@@ -13,8 +13,8 @@ exports.buildExtensionRouter = buildExtensionRouter;
 exports.buildSchemaRouter = buildSchemaRouter;
 exports.makeSchemaTranspiler = makeSchemaTranspiler;
 exports.makeNamespaceValidator = makeNamespaceValidator;
+const semantics_1 = require("@pgsql/semantics");
 const transform_1 = require("@pgsql/transform");
-const transform_2 = require("@pgsql/transform");
 /**
  * Build an {@link ExtensionRouter} from the declarative {@link ExtensionRoutingInput}:
  * an explicit `routes` spec when given, otherwise the "move everything matched
@@ -27,8 +27,8 @@ function buildExtensionRouter(input) {
     if (input.inventory)
         opts.inventory = input.inventory;
     if (input.routes)
-        return new transform_2.ExtensionRouter(input.routes, opts);
-    return transform_2.ExtensionRouter.toSchema(input.toSchema ?? null, {
+        return new transform_1.ExtensionRouter(input.routes, opts);
+    return transform_1.ExtensionRouter.toSchema(input.toSchema ?? null, {
         ...opts,
         extensions: input.only,
         from: input.from
@@ -75,7 +75,7 @@ function buildSchemaRouter(options) {
                     ...(route.toName !== undefined ? { name: route.toName } : {})
                 };
     }
-    return new transform_2.SchemaRouter(spec);
+    return new transform_1.SchemaRouter(spec);
 }
 /**
  * Rewrite the schema segment of a pgpm change path to the object's routed
@@ -125,14 +125,14 @@ function makeSchemaTranspiler(options) {
     // after schema routing on each script. Each is a self-contained parse →
     // rewrite → deparse pass, so they compose by threading the SQL through.
     const extRouter = options.extensions ? buildExtensionRouter(options.extensions) : undefined;
-    const roleRouter = options.roles ? transform_2.RoleRouter.from(options.roles) : undefined;
-    const extensionResult = extRouter ? (0, transform_2.createExtensionResult)() : undefined;
-    const roleResult = roleRouter ? (0, transform_2.createRoleResult)() : undefined;
+    const roleRouter = options.roles ? transform_1.RoleRouter.from(options.roles) : undefined;
+    const extensionResult = extRouter ? (0, transform_1.createExtensionResult)() : undefined;
+    const roleResult = roleRouter ? (0, transform_1.createRoleResult)() : undefined;
     const renameChange = (name) => renameChangePath(name, router);
     const transformScript = (sql, _ctx) => {
-        let out = (0, transform_2.transformSql)(sql, router, options.transform, result).content;
+        let out = (0, transform_1.transformSql)(sql, router, options.transform, result).content;
         if (extRouter) {
-            const r = (0, transform_2.transformExtensions)(out, extRouter);
+            const r = (0, transform_1.transformExtensions)(out, extRouter);
             out = r.sql;
             for (const [name, schema] of r.result.installsMoved) {
                 extensionResult.installsMoved.set(name, schema);
@@ -142,7 +142,7 @@ function makeSchemaTranspiler(options) {
             }
         }
         if (roleRouter) {
-            const r = (0, transform_2.transformRoles)(out, roleRouter);
+            const r = (0, transform_1.transformRoles)(out, roleRouter);
             out = r.sql;
             for (const [name, count] of r.result.rolesRenamed) {
                 roleResult.rolesRenamed.set(name, (roleResult.rolesRenamed.get(name) ?? 0) + count);
@@ -162,7 +162,7 @@ function makeNamespaceValidator(options) {
     const allowed = new Set(options.allowedSchemas);
     return (sql, _ctx) => {
         const violations = new Set();
-        for (const facts of (0, transform_1.classifyStatements)(sql)) {
+        for (const facts of (0, semantics_1.classifyStatements)(sql)) {
             for (const ref of [...facts.creates, ...facts.references, ...facts.fkTargets]) {
                 if (ref.schema && !allowed.has(ref.schema)) {
                     violations.add(`${facts.nodeTag}: ${ref.schema}.${ref.name}`);

package/categorize.d.ts

@@ -1,4 +1,4 @@
-import { StatementFacts } from '@pgsql/transform';
+import { StatementFacts } from '@pgsql/semantics';
 /**
  * A category is a chunk-seam key a change is assigned to. Free-form string; the
  * built-in {@link TIER_PROFILE} uses `'security' | 'functionality' | 'fixtures'

package/categorize.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TIER_PROFILE = void 0;
 exports.categorizeChange = categorizeChange;
 exports.buildCategoryOf = buildCategoryOf;
-const transform_1 = require("@pgsql/transform");
+const semantics_1 = require("@pgsql/semantics");
 /**
  * Default tier profile: isolates the security surface and procedural code out
  * of the schema base. Precedence, highest first — a change is placed in the
@@ -37,7 +37,7 @@ exports.TIER_PROFILE = {
  * (defaults to {@link TIER_PROFILE}).
  */
 function categorizeChange(sql, changeName, profile = exports.TIER_PROFILE) {
-    return profile.categorize((0, transform_1.classifyStatements)(sql), changeName);
+    return profile.categorize((0, semantics_1.classifyStatements)(sql), changeName);
 }
 /**
  * Build a `categoryOf(changeName)` seam function from a map of change name to

package/esm/bundle-driver.js

@@ -7,7 +7,7 @@
  * purpose — no dependency on `@pgpmjs/bundle`/`@pgpmjs/core` — so the driver
  * stays a pure function factory over `transformSql` and `classifyStatements`.
  */
-import { classifyStatements } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
 import { createExtensionResult, createRoleResult, ExtensionRouter, RoleRouter, SchemaRouter, transformExtensions, transformRoles, transformSql } from '@pgsql/transform';
 /**
  * Build an {@link ExtensionRouter} from the declarative {@link ExtensionRoutingInput}:

package/esm/categorize.js

@@ -1,4 +1,4 @@
-import { classifyStatements } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
 /**
  * Default tier profile: isolates the security surface and procedural code out
  * of the schema base. Precedence, highest first — a change is placed in the

package/esm/fixture-closure.js

@@ -1,4 +1,4 @@
-import { classifyStatements } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
 import { TIER_PROFILE } from './categorize';
 function objectKey(schema, name) {
     return `${schema ?? ''}\u0000${name}`;

package/esm/granularity-driver.js

@@ -1,6 +1,7 @@
 import { pathFor } from '@pgpmjs/naming-spec';
 import { revertFor, verifyFor } from '@pgsql/scripts';
-import { buildStatementGraph, classifyStatements, identityOf, restructureSql } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
+import { buildStatementGraph, identityOf, restructureSql } from '@pgsql/transform';
 import { nameUnnamedConstraints, subObjectIdentityOf } from './sub-object';
 export const CHANGE_GRANULARITIES = ['alteration', 'object', 'single'];
 export const isChangeGranularity = (value) => CHANGE_GRANULARITIES.includes(value);

package/esm/partition-driver.js

@@ -1,7 +1,7 @@
 /**
  * Partition dial: project one deploy surface into a set of pgpm packages.
  *
- * The object graph (statements classified by `@pgsql/transform`, grouped
+ * The object graph (statements classified by `@pgsql/semantics`, grouped
  * into identity-keyed units) is the source of truth; which package a unit
  * lives in is a *derived projection* of a declarative partition config.
  * Units can be assigned by schema, by object kind, by explicit cherry-pick
@@ -21,7 +21,8 @@
  * pgpm.plan + deploy trees, feed a bundle, ...).
  */
 import { pathFor } from '@pgpmjs/naming-spec';
-import { buildStatementGraph, classifyStatements, identityOf } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
+import { buildStatementGraph, identityOf } from '@pgsql/transform';
 /** A partition whose packages require each other in a cycle — unshippable. */
 export class PartitionCycleError extends Error {
     packages;

package/esm/program.js

@@ -1,4 +1,4 @@
-import { classifyStatements } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
 import { Deparser, parseSql } from 'plpgsql-parser';
 /**
  * Parse a SQL script into a statement program. Requires `loadModule()` from

package/esm/regen.js

@@ -1,5 +1,5 @@
 import { revertFor, verifyFor } from '@pgsql/scripts';
-import { classifyStatements } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
 /**
  * Classify a pgpm script's substantive statements: every top-level statement
  * except transaction control (`BEGIN`/`COMMIT`/`ROLLBACK` wrappers).

package/esm/semantic-diff-driver.js

@@ -28,7 +28,8 @@
  */
 import { pathFor } from '@pgpmjs/naming-spec';
 import { existenceCheck, invertStatement, revertFor, verifyFor } from '@pgsql/scripts';
-import { buildStatementGraph, classifyStatements, cleanTree, identityOf } from '@pgsql/transform';
+import { classifyStatements } from '@pgsql/semantics';
+import { buildStatementGraph, cleanTree, identityOf } from '@pgsql/transform';
 import { Deparser, parseSync } from 'plpgsql-parser';
 import { defaultConstraintName } from './constraint-names';
 import { restructureChanges } from './granularity-driver';

package/fixture-closure.d.ts

@@ -1,4 +1,4 @@
-import { QualifiedName } from '@pgsql/transform';
+import { QualifiedName } from '@pgsql/semantics';
 import { CategoryProfile, ChangeCategory } from './categorize';
 /**
  * A change plus its deploy SQL. Optional plan `dependencies` (from `pgpm.plan`)

package/fixture-closure.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveFixtureClosure = resolveFixtureClosure;
-const transform_1 = require("@pgsql/transform");
+const semantics_1 = require("@pgsql/semantics");
 const categorize_1 = require("./categorize");
 function objectKey(schema, name) {
     return `${schema ?? ''}\u0000${name}`;
 }
 function analyze(change, profile) {
-    const facts = (0, transform_1.classifyStatements)(change.sql);
+    const facts = (0, semantics_1.classifyStatements)(change.sql);
     const category = profile.categorize(facts, change.name);
     const creates = [];
     const createsSchemas = [];

package/granularity-driver.d.ts

@@ -18,7 +18,8 @@
  * - `consolidated` — additionally inlines FKs proven safe by the graph.
  */
 import type { ObjectIdentity as NamingIdentity } from '@pgpmjs/naming-spec';
-import type { Granularity, StatementFacts } from '@pgsql/transform';
+import type { StatementFacts } from '@pgsql/semantics';
+import type { Granularity } from '@pgsql/transform';
 export type { Granularity } from '@pgsql/transform';
 /**
  * How statements are distributed across pgpm changes — orthogonal to

package/granularity-driver.js

@@ -5,6 +5,7 @@ exports.defaultChangeName = defaultChangeName;
 exports.restructureChanges = restructureChanges;
 const naming_spec_1 = require("@pgpmjs/naming-spec");
 const scripts_1 = require("@pgsql/scripts");
+const semantics_1 = require("@pgsql/semantics");
 const transform_1 = require("@pgsql/transform");
 const sub_object_1 = require("./sub-object");
 exports.CHANGE_GRANULARITIES = ['alteration', 'object', 'single'];
@@ -57,7 +58,7 @@ function restructureChanges(changes, options) {
     // Re-classify the emitted script; group statements by the object they
     // target (creates[0]), so a table's CREATE and its remaining ALTERs land
     // in the same change regardless of statement kind.
-    const facts = (0, transform_1.classifyStatements)(sql);
+    const facts = (0, semantics_1.classifyStatements)(sql);
     if (options.changeGranularity === 'single') {
         const name = options.singleChangeName ?? 'module/init';
         const inputNames = new Set(changes.map(c => c.name));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgpmjs/transform",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Change-aware SQL transformation for PGPM — superset of @pgsql/transform plus change categorization, fixture closure, and bundle transpile/apply drivers",
   "main": "index.js",
@@ -39,15 +39,16 @@
     "plpgsql"
   ],
   "devDependencies": {
-    "@pgpmjs/bundle": "^0.13.3",
+    "@pgpmjs/bundle": "^0.14.0",
     "makage": "^0.3.0"
   },
   "dependencies": {
-    "@pgpmjs/ast": "^0.10.3",
-    "@pgpmjs/naming-spec": "^0.2.0",
-    "@pgsql/scripts": "^18.3.1",
-    "@pgsql/transform": "^18.14.1",
+    "@pgpmjs/ast": "^0.11.0",
+    "@pgpmjs/naming-spec": "^0.3.0",
+    "@pgsql/scripts": "^18.3.2",
+    "@pgsql/semantics": "^18.1.0",
+    "@pgsql/transform": "^18.15.0",
     "plpgsql-parser": "^18.5.1"
   },
-  "gitHead": "e6a7a57f88c9deb2a4acecaba2451320d1be8203"
+  "gitHead": "d508453a32a2f1d70ff6916871046615226e6f33"
 }

package/partition-driver.d.ts

@@ -1,7 +1,7 @@
 /**
  * Partition dial: project one deploy surface into a set of pgpm packages.
  *
- * The object graph (statements classified by `@pgsql/transform`, grouped
+ * The object graph (statements classified by `@pgsql/semantics`, grouped
  * into identity-keyed units) is the source of truth; which package a unit
  * lives in is a *derived projection* of a declarative partition config.
  * Units can be assigned by schema, by object kind, by explicit cherry-pick
@@ -21,7 +21,8 @@
  * pgpm.plan + deploy trees, feed a bundle, ...).
  */
 import { PathStyle } from '@pgpmjs/naming-spec';
-import { ObjectIdentity, ObjectIdentityKind, StatementKind } from '@pgsql/transform';
+import { StatementKind } from '@pgsql/semantics';
+import { ObjectIdentity, ObjectIdentityKind } from '@pgsql/transform';
 /** One deployable unit: an object (by identity) and the statements that build it. */
 export interface PartitionUnit {
     /** The object's identity, or `null` for split riders and the residual unit. */

package/partition-driver.js

@@ -5,7 +5,7 @@ exports.partitionUnits = partitionUnits;
 /**
  * Partition dial: project one deploy surface into a set of pgpm packages.
  *
- * The object graph (statements classified by `@pgsql/transform`, grouped
+ * The object graph (statements classified by `@pgsql/semantics`, grouped
  * into identity-keyed units) is the source of truth; which package a unit
  * lives in is a *derived projection* of a declarative partition config.
  * Units can be assigned by schema, by object kind, by explicit cherry-pick
@@ -25,6 +25,7 @@ exports.partitionUnits = partitionUnits;
  * pgpm.plan + deploy trees, feed a bundle, ...).
  */
 const naming_spec_1 = require("@pgpmjs/naming-spec");
+const semantics_1 = require("@pgsql/semantics");
 const transform_1 = require("@pgsql/transform");
 /** A partition whose packages require each other in a cycle — unshippable. */
 class PartitionCycleError extends Error {
@@ -84,7 +85,7 @@ exports.RESIDUAL_UNIT_PATH = 'misc/statements';
  * otherwise) that depend on their host unit.
  */
 function buildUnitGraph(sql, style, splitRiders) {
-    const facts = (0, transform_1.classifyStatements)(sql);
+    const facts = (0, semantics_1.classifyStatements)(sql);
     const graph = (0, transform_1.buildStatementGraph)(facts);
     const unitOf = new Array(facts.length).fill(-1);
     const units = [];

package/program.d.ts

@@ -9,7 +9,7 @@
  * untouched statements). A program with no dirty statements emits its source
  * byte-identically, so content-addressed hashes are preserved.
  */
-import type { StatementFacts } from '@pgsql/transform';
+import type { StatementFacts } from '@pgsql/semantics';
 /** A statement's location in the source script (byte offsets). */
 export type SqlStatementSpan = StatementFacts['span'];
 /** One statement of a parsed SQL script. */

package/program.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSqlProgram = parseSqlProgram;
 exports.emitSqlProgram = emitSqlProgram;
-const transform_1 = require("@pgsql/transform");
+const semantics_1 = require("@pgsql/semantics");
 const plpgsql_parser_1 = require("plpgsql-parser");
 /**
  * Parse a SQL script into a statement program. Requires `loadModule()` from
@@ -11,7 +11,7 @@ const plpgsql_parser_1 = require("plpgsql-parser");
 function parseSqlProgram(source) {
     const parseResult = (0, plpgsql_parser_1.parseSql)(source);
     const stmts = parseResult?.stmts ?? [];
-    const facts = (0, transform_1.classifyStatements)(source);
+    const facts = (0, semantics_1.classifyStatements)(source);
     const statements = [];
     for (let i = 0; i < stmts.length; i++) {
         const rawStmt = stmts[i];

package/regen.d.ts

@@ -12,7 +12,7 @@
  * Requires `loadModule()` from `plpgsql-parser` to have completed.
  */
 import type { GeneratedScript } from '@pgsql/scripts';
-import type { StatementFacts } from '@pgsql/transform';
+import type { StatementFacts } from '@pgsql/semantics';
 export type { GeneratedScript } from '@pgsql/scripts';
 /** Generated revert and verify scripts for one change's deploy SQL. */
 export interface RegeneratedScripts {

package/regen.js

@@ -4,13 +4,13 @@ exports.classifyScript = classifyScript;
 exports.isStubScript = isStubScript;
 exports.regenerateScripts = regenerateScripts;
 const scripts_1 = require("@pgsql/scripts");
-const transform_1 = require("@pgsql/transform");
+const semantics_1 = require("@pgsql/semantics");
 /**
  * Classify a pgpm script's substantive statements: every top-level statement
  * except transaction control (`BEGIN`/`COMMIT`/`ROLLBACK` wrappers).
  */
 function classifyScript(sql) {
-    return (0, transform_1.classifyStatements)(sql).filter(f => f.nodeTag !== 'TransactionStmt');
+    return (0, semantics_1.classifyStatements)(sql).filter(f => f.nodeTag !== 'TransactionStmt');
 }
 /**
  * Whether a script is an empty stub: nothing but comments, whitespace, and

package/semantic-diff-driver.js

@@ -32,6 +32,7 @@ exports.diffChangeSets = diffChangeSets;
  */
 const naming_spec_1 = require("@pgpmjs/naming-spec");
 const scripts_1 = require("@pgsql/scripts");
+const semantics_1 = require("@pgsql/semantics");
 const transform_1 = require("@pgsql/transform");
 const plpgsql_parser_1 = require("plpgsql-parser");
 const constraint_names_1 = require("./constraint-names");
@@ -44,7 +45,7 @@ const identityKey = (id) => `${id.kind}\u0000${id.schema ?? ''}\u0000${id.table
  * statements are reported via `warnings`.
  */
 function readSide(sql, warnings, label) {
-    const facts = (0, transform_1.classifyStatements)(sql);
+    const facts = (0, semantics_1.classifyStatements)(sql);
     const graph = (0, transform_1.buildStatementGraph)(facts);
     const units = new Map();
     const order = [];
@@ -367,7 +368,7 @@ function diffSchemas(from, to, options = {}) {
      * statement to surface its not-derivable comment and warning.
      */
     const inverseOf = (deploy, context) => {
-        const facts = (0, transform_1.classifyStatements)(deploy);
+        const facts = (0, semantics_1.classifyStatements)(deploy);
         const graph = (0, transform_1.buildStatementGraph)(facts);
         const pieces = [];
         for (const i of [...graph.order].reverse()) {
@@ -390,7 +391,7 @@ function diffSchemas(from, to, options = {}) {
      */
     const verifyOf = (deploy, context) => {
         const pieces = [];
-        for (const fact of (0, transform_1.classifyStatements)(deploy)) {
+        for (const fact of (0, semantics_1.classifyStatements)(deploy)) {
             const nodes = (0, scripts_1.existenceCheck)(fact);
             if (nodes === null) {
                 const { warnings: w } = (0, scripts_1.verifyFor)([fact]);

package/sub-object.d.ts

@@ -10,7 +10,7 @@
  * every alteration.
  */
 import type { ObjectIdentity } from '@pgpmjs/naming-spec';
-import type { StatementFacts } from '@pgsql/transform';
+import type { StatementFacts } from '@pgsql/semantics';
 /**
  * The column or constraint a one-command `ALTER TABLE .. ADD COLUMN` /
  * `ADD CONSTRAINT` statement adds, as a naming-spec identity