typhex 0.1.0-alpha.0

package/dist/orm/query-state.js

@@ -0,0 +1,112 @@
+/**
+ * Shared query-builder state and cloning helpers.
+ */
+/** @internal — internal builder state */
+export class QueryState {
+    tableName;
+    columnNames;
+    qe;
+    pkColumns;
+    whereIr;
+    whereParams;
+    subqueryParams;
+    orderBy;
+    limitNum;
+    offsetNum;
+    selectIr;
+    inlineParams;
+    relations;
+    hydrate;
+    resolveRelationTarget;
+    joinHints;
+    entityJoinHints;
+    havingIr;
+    havingParams;
+    entity;
+    unionAll;
+    ctes;
+    inScopeRegisteredCteNames;
+    fromSource;
+    updateSetIr;
+    insertIr;
+    constructor(init) {
+        this.tableName = init.tableName;
+        this.columnNames = init.columnNames;
+        this.qe = init.qe;
+        this.pkColumns = init.pkColumns;
+        this.whereIr = init.whereIr;
+        this.whereParams = init.whereParams;
+        this.subqueryParams = init.subqueryParams;
+        this.orderBy = init.orderBy;
+        this.limitNum = init.limitNum;
+        this.offsetNum = init.offsetNum;
+        this.selectIr = init.selectIr;
+        this.inlineParams = init.inlineParams;
+        this.relations = init.relations;
+        this.hydrate = init.hydrate;
+        this.resolveRelationTarget = init.resolveRelationTarget;
+        this.joinHints = init.joinHints;
+        this.entityJoinHints = init.entityJoinHints;
+        this.havingIr = init.havingIr;
+        this.havingParams = init.havingParams;
+        this.entity = init.entity;
+        this.unionAll = init.unionAll;
+        this.ctes = init.ctes;
+        this.inScopeRegisteredCteNames = init.inScopeRegisteredCteNames;
+        this.fromSource = init.fromSource;
+        this.updateSetIr = init.updateSetIr;
+        this.insertIr = init.insertIr;
+    }
+    /** Deep-clone mutable query state bags and nested CTE / subquery bodies. */
+    clone() {
+        const subqueryParams = {};
+        for (const [key, captured] of Object.entries(this.subqueryParams)) {
+            subqueryParams[key] = { state: captured.state.clone() };
+        }
+        return new QueryState({
+            tableName: this.tableName,
+            columnNames: [...this.columnNames],
+            qe: this.qe,
+            pkColumns: [...this.pkColumns],
+            whereIr: this.whereIr,
+            whereParams: { ...this.whereParams },
+            subqueryParams,
+            orderBy: [...this.orderBy],
+            limitNum: this.limitNum,
+            offsetNum: this.offsetNum,
+            selectIr: this.selectIr,
+            inlineParams: this.inlineParams ? { ...this.inlineParams } : undefined,
+            relations: this.relations,
+            hydrate: this.hydrate,
+            resolveRelationTarget: this.resolveRelationTarget,
+            joinHints: this.joinHints ? [...this.joinHints] : undefined,
+            entityJoinHints: this.entityJoinHints?.map((h) => ({
+                joinType: h.joinType,
+                entity: h.entity,
+                onIr: h.onIr,
+            })),
+            havingIr: this.havingIr,
+            havingParams: { ...this.havingParams },
+            entity: this.entity,
+            unionAll: this.unionAll?.clone(),
+            ctes: this.ctes?.map((c) => ({
+                name: c.name,
+                kind: c.kind,
+                inner: c.inner.clone(),
+            })),
+            inScopeRegisteredCteNames: this.inScopeRegisteredCteNames
+                ? [...this.inScopeRegisteredCteNames]
+                : undefined,
+            fromSource: QueryState.cloneFromSource(this.fromSource),
+        });
+    }
+    static cloneFromSource(source) {
+        if (!source)
+            return undefined;
+        if (source.kind === "subquery") {
+            return { kind: "subquery", state: source.state.clone() };
+        }
+        return source;
+    }
+}
+//# sourceMappingURL=query-state.js.map

package/dist/orm/query-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-state.js","sourceRoot":"","sources":["../../src/orm/query-state.ts"],"names":[],"mappings":"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"}

package/dist/orm/single-row-query-builder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Single-row query builder: save(), delete(), patch() for an entity instance.
+ * No _dirty tracking: save() inserts if no pk, else updates all current column values.
+ */
+export declare class SingleRowQueryBuilder<T = unknown> {
+    private readonly instance;
+    private readonly state;
+    private readonly runHook;
+    private readonly pkColumns;
+    private readonly columnNames;
+    /** Insert if instance has no complete pk, else update all column values. No _dirty; uses current instance state. */
+    save(): Promise<void>;
+    /** Delete the row by pk. */
+    delete(): Promise<void>;
+    /** Update the row by pk with the given set, then assign set onto the instance. */
+    patch(set: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=single-row-query-builder.d.ts.map

package/dist/orm/single-row-query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-row-query-builder.d.ts","sourceRoot":"","sources":["../../src/orm/single-row-query-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,qBAAa,qBAAqB,CAAC,CAAC,GAAG,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqD;IAC7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IAiBvC,oHAAoH;IAC9G,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC3B,4BAA4B;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB7B,kFAAkF;IAC5E,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAUzD"}

package/dist/orm/single-row-query-builder.js

@@ -0,0 +1,90 @@
+/**
+ * Single-row query builder: save(), delete(), patch() for an entity instance.
+ * No _dirty tracking: save() inserts if no pk, else updates all current column values.
+ */
+import { QueryBuilder } from "./query-builder.js";
+import { buildFindByIdIr } from "./query-helpers.js";
+export class SingleRowQueryBuilder {
+    instance;
+    state;
+    runHook;
+    pkColumns;
+    columnNames;
+    /** @internal */
+    constructor(instance, state, runHook, pkColumns, columnNames) {
+        this.instance = instance;
+        this.state = state;
+        this.runHook = runHook;
+        this.pkColumns = pkColumns;
+        this.columnNames = columnNames;
+    }
+    /** Insert if instance has no complete pk, else update all column values. No _dirty; uses current instance state. */
+    async save() {
+        const self = this.instance;
+        await this.runHook(self, "beforeSave");
+        const hasAllPk = this.pkColumns.every((c) => this.instance[c] !== undefined);
+        if (!hasAllPk) {
+            await this.runHook(self, "beforeCreate");
+            const row = {};
+            for (const c of this.columnNames) {
+                if (this.instance[c] !== undefined)
+                    row[c] = this.instance[c];
+            }
+            const inserted = (await new QueryBuilder({ ...this.state }).insert(row));
+            for (const c of this.columnNames) {
+                if (inserted[c] !== undefined)
+                    this.instance[c] = inserted[c];
+            }
+            if (typeof self._isNew === "boolean")
+                self._isNew = false;
+            await this.runHook(self, "afterCreate");
+        }
+        else {
+            await this.runHook(self, "beforeUpdate");
+            const set = {};
+            for (const c of this.columnNames) {
+                if (!this.pkColumns.includes(c) && this.instance[c] !== undefined)
+                    set[c] = this.instance[c];
+            }
+            if (Object.keys(set).length > 0) {
+                await new QueryBuilder({
+                    ...this.state,
+                    whereIr: buildFindByIdIr(this.pkColumns, this.instance),
+                    whereParams: {},
+                }).update(set);
+            }
+            await this.runHook(self, "afterUpdate");
+        }
+        await this.runHook(self, "afterSave");
+    }
+    /** Delete the row by pk. */
+    async delete() {
+        const self = this.instance;
+        await this.runHook(self, "beforeDelete");
+        const hasAllPk = this.pkColumns.every((c) => this.instance[c] !== undefined);
+        if (!hasAllPk) {
+            await this.runHook(self, "afterDelete");
+            return;
+        }
+        await new QueryBuilder({
+            ...this.state,
+            whereIr: buildFindByIdIr(this.pkColumns, this.instance),
+            whereParams: {},
+        }).delete();
+        await this.runHook(self, "afterDelete");
+    }
+    /** Update the row by pk with the given set, then assign set onto the instance. */
+    async patch(set) {
+        const hasAllPk = this.pkColumns.every((c) => this.instance[c] !== undefined);
+        if (!hasAllPk)
+            return;
+        await new QueryBuilder({
+            ...this.state,
+            whereIr: buildFindByIdIr(this.pkColumns, this.instance),
+            whereParams: {},
+        }).update(set);
+        for (const k of Object.keys(set))
+            this.instance[k] = set[k];
+    }
+}
+//# sourceMappingURL=single-row-query-builder.js.map

package/dist/orm/single-row-query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-row-query-builder.js","sourceRoot":"","sources":["../../src/orm/single-row-query-builder.ts"],"names":[],"mappings":"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"}

package/dist/orm/trx.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Base Trx class and active-transaction storage.
+ * QueryExecutor interface lives in db.ts.
+ * Kept in its own file to avoid circular imports:
+ * dialect trx subclasses → this file (no orm/db.ts dependency).
+ */
+import type { DialectInfo, TransactionOptions } from "../driver/types.js";
+export declare function getActiveTrx(): Trx | undefined;
+export declare function runInTrxStorage<T>(trx: Trx, fn: () => Promise<T>): Promise<T>;
+/** Base transaction class. Use `Db.transaction()` or `Db.beginTrx()` to obtain a `Trx` instance. */
+export declare abstract class Trx {
+    /** Dialect-level defaults merged with user-provided options. Override in subclasses. */
+    static readonly defaultOptions: TransactionOptions;
+    /** The SQL dialect in use. */
+    get dialect(): DialectInfo;
+    /** Runs a SQL query within this transaction. */
+    query(sql: string, params?: unknown[]): Promise<unknown[]>;
+    /** Executes a SQL statement within this transaction. */
+    run(sql: string, params?: unknown[]): Promise<{
+        lastID?: number;
+        changes: number;
+    }>;
+    /** Opens a nested savepoint transaction if already inside a transaction, otherwise begins a root transaction. */
+    transaction<T>(fn: (trx: Trx) => Promise<T>): Promise<T>;
+    /** Create a savepoint-scoped child Trx and begin it. */
+    beginTrx(): Promise<Trx>;
+    /** Commit this transaction (COMMIT) or release the savepoint (RELEASE SAVEPOINT). */
+    abstract commit(): Promise<void>;
+    /** Roll back this transaction (ROLLBACK) or the savepoint (ROLLBACK TO SAVEPOINT). */
+    abstract rollback(): Promise<void>;
+    /**
+     * Validate options before beginning a root transaction.
+     * Dialect subclasses override this to reject options that are unsupported or contradictory.
+     * Only called for root transactions, not savepoints.
+     */
+    protected validateOptions(): void;
+    /** Issue BEGIN (root) or SAVEPOINT (nested). */
+    protected abstract begin(): Promise<void>;
+}
+//# sourceMappingURL=trx.d.ts.map

package/dist/orm/trx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trx.d.ts","sourceRoot":"","sources":["../../src/orm/trx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAsB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG9F,wBAAgB,YAAY,IAAI,GAAG,GAAG,SAAS,CAE9C;AACD,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7E;AAQD,oGAAoG;AACpG,8BAAsB,GAAG;IACvB,wFAAwF;IACxF,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAM;IA+BxD,8BAA8B;IAC9B,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED,gDAAgD;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI1D,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAMnF,iHAAiH;IAC3G,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwC9D,wDAAwD;IAClD,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;IAW9B,qFAAqF;IACrF,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAUlC;;;;OAIG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;IAEjC,gDAAgD;IAChD,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC1C"}

package/dist/orm/trx.js

@@ -0,0 +1,118 @@
+/**
+ * Base Trx class and active-transaction storage.
+ * QueryExecutor interface lives in db.ts.
+ * Kept in its own file to avoid circular imports:
+ * dialect trx subclasses → this file (no orm/db.ts dependency).
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+const _txStorage = new AsyncLocalStorage();
+export function getActiveTrx() {
+    return _txStorage.getStore();
+}
+export function runInTrxStorage(trx, fn) {
+    return _txStorage.run(trx, fn);
+}
+/** Base transaction class. Use `Db.transaction()` or `Db.beginTrx()` to obtain a `Trx` instance. */
+export class Trx {
+    _conn;
+    /** Dialect-level defaults merged with user-provided options. Override in subclasses. */
+    static defaultOptions = {};
+    /** @internal */
+    _depth = 0;
+    /** @internal */
+    _spRoot;
+    /** @internal */
+    _savepointName;
+    /** @internal */
+    _cleanup;
+    /** @internal */
+    _isNested;
+    /** @internal */
+    _options;
+    /** @internal — Trx instances are created by `Db.transaction()` */
+    constructor(
+    /** @internal */
+    _conn, options, ctx) {
+        this._conn = _conn;
+        this._spRoot = ctx?.spRoot ?? { n: 0 };
+        this._isNested = ctx?.isNested ?? false;
+        this._savepointName = this._isNested ? `sp_${++this._spRoot.n}` : undefined;
+        this._options = { ...this.constructor.defaultOptions, ...options };
+        this.validateOptions();
+    }
+    // ── QueryExecutor ──────────────────────────────────────────────────────────
+    /** The SQL dialect in use. */
+    get dialect() {
+        return this._conn.dialect;
+    }
+    /** Runs a SQL query within this transaction. */
+    query(sql, params) {
+        return this._conn.execute(sql, params).then((r) => r.rows);
+    }
+    /** Executes a SQL statement within this transaction. */
+    run(sql, params) {
+        return this._conn.execute(sql, params).then((r) => ({ lastID: r.lastID, changes: r.changes }));
+    }
+    // ── Callback API ───────────────────────────────────────────────────────────
+    /** Opens a nested savepoint transaction if already inside a transaction, otherwise begins a root transaction. */
+    async transaction(fn) {
+        return !this._isNested && this._depth === 0
+            ? this._beginTransaction(fn)
+            : this._nestedTransaction(fn);
+    }
+    /** @internal */
+    async _beginTransaction(fn) {
+        await this.begin();
+        try {
+            const result = await fn(this);
+            await this.commit();
+            return result;
+        }
+        catch (e) {
+            try {
+                await this.rollback();
+            }
+            catch {
+                /* ignore */
+            }
+            throw e;
+        }
+        finally {
+            this._depth = 0;
+        }
+    }
+    /** @internal */
+    async _nestedTransaction(fn) {
+        const nested = await this.beginTrx();
+        try {
+            const result = await fn(nested);
+            await nested.commit();
+            return result;
+        }
+        catch (e) {
+            await nested.rollback();
+            throw e;
+        }
+    }
+    // ── Explicit API ───────────────────────────────────────────────────────────
+    /** Create a savepoint-scoped child Trx and begin it. */
+    async beginTrx() {
+        const Ctor = this.constructor;
+        const nested = new Ctor(this._conn, this._options, { spRoot: this._spRoot, isNested: true });
+        await nested.begin();
+        return nested;
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    /** @internal — set the connection-release callback and issue BEGIN. Called by Db.beginTrx(). */
+    async _initRoot(cleanup) {
+        this._cleanup = cleanup;
+        await this.begin();
+    }
+    /**
+     * Validate options before beginning a root transaction.
+     * Dialect subclasses override this to reject options that are unsupported or contradictory.
+     * Only called for root transactions, not savepoints.
+     */
+    validateOptions() { }
+}
+//# sourceMappingURL=trx.js.map

package/dist/orm/trx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trx.js","sourceRoot":"","sources":["../../src/orm/trx.ts"],"names":[],"mappings":"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"}

package/dist/parser/acorn-helpers.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ESTree type guards and small accessors used across predicate walking,
+ * group-by, select, and update parsing.
+ */
+import type * as ESTree from "estree";
+import type { AcornExpr, AcornFunctionBody, AcornNode } from "./acorn-types.js";
+/** True when a node is an expression shape (excludes spread, patterns, super, etc.). */
+export declare function isExpressionNode(node: AcornNode): node is AcornExpr;
+export declare function isIdentifier(node: AcornNode | null | undefined): node is ESTree.Identifier;
+/** True if `node` is an Identifier; if `name` is given, also checks it matches. */
+export declare function isIdent(node: AcornNode | null | undefined, name?: string): node is ESTree.Identifier;
+export declare function isLiteral(node: AcornNode | null | undefined): node is ESTree.Literal;
+/** True if `node` is a string literal. */
+export declare function isStringLiteral(node: AcornNode): node is ESTree.Literal & {
+    value: string;
+};
+/** True if `node` is a numeric literal. */
+export declare function isNumberLiteral(node: AcornNode): node is ESTree.Literal & {
+    value: number;
+};
+export declare function isMemberExpression(node: AcornNode | null | undefined): node is ESTree.MemberExpression;
+/** MemberExpression.object when it is a normal expression (not `super`). */
+export declare function memberObjectExpr(node: ESTree.MemberExpression): AcornExpr | null;
+export declare function isCallExpression(node: AcornNode | null | undefined): node is ESTree.CallExpression;
+export declare function isObjectExpression(node: AcornNode | null | undefined): node is ESTree.ObjectExpression;
+export declare function isArrayExpression(node: AcornNode | null | undefined): node is ESTree.ArrayExpression;
+export declare function isProperty(node: AcornNode | null | undefined): node is ESTree.Property;
+export declare function isSpreadElement(node: AcornNode | null | undefined): node is ESTree.SpreadElement;
+export declare function isReturnStatement(node: AcornNode | null | undefined): node is ESTree.ReturnStatement;
+export declare function isBlockStatement(node: AcornNode | null | undefined): node is ESTree.BlockStatement;
+export declare function isArrowFunctionExpression(node: AcornNode | null | undefined): node is ESTree.ArrowFunctionExpression;
+export declare function isFunctionExpression(node: AcornNode | null | undefined): node is ESTree.FunctionExpression;
+export declare function isBinaryOrLogicalExpression(node: AcornNode): node is ESTree.BinaryExpression | ESTree.LogicalExpression;
+export declare function isUnaryExpression(node: AcornNode): node is ESTree.UnaryExpression;
+/** Resolve a non-computed object property key to its string name. */
+export declare function propertyKeyName(key: ESTree.Expression | ESTree.PrivateIdentifier): string | null;
+/** Object-literal property value — excludes destructuring patterns. */
+export declare function objectPropertyValue(value: ESTree.Expression | ESTree.Pattern): AcornExpr | null;
+/** First identifier param name from an arrow/function callback, or null. */
+export declare function firstParamName(params: ESTree.Pattern[]): string | null;
+/** Expression body of a relation callback: expression body or single `return`. */
+export declare function extractCallbackExpression(body: AcornFunctionBody, method: string): AcornExpr;
+//# sourceMappingURL=acorn-helpers.d.ts.map

package/dist/parser/acorn-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorn-helpers.d.ts","sourceRoot":"","sources":["../../src/parser/acorn-helpers.ts"],"names":[],"mappings":"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"}

package/dist/parser/acorn-helpers.js

@@ -0,0 +1,104 @@
+/**
+ * ESTree type guards and small accessors used across predicate walking,
+ * group-by, select, and update parsing.
+ */
+const NON_EXPRESSION_NODE_TYPES = new Set([
+    "SpreadElement",
+    "PrivateIdentifier",
+    "Super",
+    "ObjectPattern",
+    "ArrayPattern",
+    "RestElement",
+    "AssignmentPattern",
+]);
+/** True when a node is an expression shape (excludes spread, patterns, super, etc.). */
+export function isExpressionNode(node) {
+    return !NON_EXPRESSION_NODE_TYPES.has(node.type);
+}
+export function isIdentifier(node) {
+    return !!node && node.type === "Identifier";
+}
+/** True if `node` is an Identifier; if `name` is given, also checks it matches. */
+export function isIdent(node, name) {
+    return isIdentifier(node) && (name === undefined || node.name === name);
+}
+export function isLiteral(node) {
+    return !!node && node.type === "Literal";
+}
+/** True if `node` is a string literal. */
+export function isStringLiteral(node) {
+    return isLiteral(node) && typeof node.value === "string";
+}
+/** True if `node` is a numeric literal. */
+export function isNumberLiteral(node) {
+    return isLiteral(node) && typeof node.value === "number";
+}
+export function isMemberExpression(node) {
+    return !!node && node.type === "MemberExpression";
+}
+/** MemberExpression.object when it is a normal expression (not `super`). */
+export function memberObjectExpr(node) {
+    return node.object.type === "Super" ? null : node.object;
+}
+export function isCallExpression(node) {
+    return !!node && node.type === "CallExpression";
+}
+export function isObjectExpression(node) {
+    return !!node && node.type === "ObjectExpression";
+}
+export function isArrayExpression(node) {
+    return !!node && node.type === "ArrayExpression";
+}
+export function isProperty(node) {
+    return !!node && node.type === "Property";
+}
+export function isSpreadElement(node) {
+    return !!node && node.type === "SpreadElement";
+}
+export function isReturnStatement(node) {
+    return !!node && node.type === "ReturnStatement";
+}
+export function isBlockStatement(node) {
+    return !!node && node.type === "BlockStatement";
+}
+export function isArrowFunctionExpression(node) {
+    return !!node && node.type === "ArrowFunctionExpression";
+}
+export function isFunctionExpression(node) {
+    return !!node && node.type === "FunctionExpression";
+}
+export function isBinaryOrLogicalExpression(node) {
+    return node.type === "BinaryExpression" || node.type === "LogicalExpression";
+}
+export function isUnaryExpression(node) {
+    return node.type === "UnaryExpression";
+}
+/** Resolve a non-computed object property key to its string name. */
+export function propertyKeyName(key) {
+    if (isIdentifier(key))
+        return key.name;
+    if (isLiteral(key) && typeof key.value === "string")
+        return key.value;
+    return null;
+}
+/** Object-literal property value — excludes destructuring patterns. */
+export function objectPropertyValue(value) {
+    return isExpressionNode(value) ? value : null;
+}
+/** First identifier param name from an arrow/function callback, or null. */
+export function firstParamName(params) {
+    const param = params[0];
+    return isIdentifier(param) ? param.name : null;
+}
+/** Expression body of a relation callback: expression body or single `return`. */
+export function extractCallbackExpression(body, method) {
+    if (isBlockStatement(body)) {
+        const first = body.body[0];
+        if (!isReturnStatement(first) || !first.argument) {
+            throw new Error(`Unsupported .${method}() callback: need return`);
+        }
+        return first.argument;
+    }
+    return body;
+}
+//# sourceMappingURL=acorn-helpers.js.map

package/dist/parser/acorn-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorn-helpers.js","sourceRoot":"","sources":["../../src/parser/acorn-helpers.ts"],"names":[],"mappings":"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"}

package/dist/parser/acorn-member.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Member-path resolution for acorn ASTs: `u.author.name` → { param, path }.
+ */
+import type { AcornExpr } from "./acorn-types.js";
+/**
+ * Walk a MemberExpression chain rooted at one of `params` and return the
+ * parameter name and the property path. Returns null if the chain isn't
+ * rooted at a known parameter or uses computed/non-identifier accesses.
+ */
+export declare function resolveMemberPath(node: AcornExpr, params: string[]): {
+    param: string;
+    path: string[];
+} | null;
+/** Same as resolveMemberPath but constrained to a single parameter name. */
+export declare function resolvePathFromParam(node: AcornExpr, paramName: string): string[] | null;
+//# sourceMappingURL=acorn-member.d.ts.map

package/dist/parser/acorn-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorn-member.d.ts","sourceRoot":"","sources":["../../src/parser/acorn-member.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EAAE,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAa1C;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAGxF"}

package/dist/parser/acorn-member.js

@@ -0,0 +1,31 @@
+/**
+ * Member-path resolution for acorn ASTs: `u.author.name` → { param, path }.
+ */
+import { isIdentifier, isMemberExpression, memberObjectExpr } from "./acorn-helpers.js";
+/**
+ * Walk a MemberExpression chain rooted at one of `params` and return the
+ * parameter name and the property path. Returns null if the chain isn't
+ * rooted at a known parameter or uses computed/non-identifier accesses.
+ */
+export function resolveMemberPath(node, params) {
+    if (isIdentifier(node) && params.includes(node.name)) {
+        return { param: node.name, path: [] };
+    }
+    if (!isMemberExpression(node) || node.computed)
+        return null;
+    if (!isIdentifier(node.property))
+        return null;
+    const object = memberObjectExpr(node);
+    if (!object)
+        return null;
+    const parent = resolveMemberPath(object, params);
+    if (!parent)
+        return null;
+    return { param: parent.param, path: [...parent.path, node.property.name] };
+}
+/** Same as resolveMemberPath but constrained to a single parameter name. */
+export function resolvePathFromParam(node, paramName) {
+    const resolved = resolveMemberPath(node, [paramName]);
+    return resolved ? resolved.path : null;
+}
+//# sourceMappingURL=acorn-member.js.map

package/dist/parser/acorn-member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorn-member.js","sourceRoot":"","sources":["../../src/parser/acorn-member.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAe,EACf,MAAgB;IAEhB,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,IAAe,EAAE,SAAiB;IACrE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC"}