@standardbeagle/edit-db 0.4.417 → 0.4.418

package/dist/lib/polymorphic.d.ts

@@ -1,35 +1,11 @@
 import { Join } from '../types/schema';
 /**
- * Minimal descriptor of the parent→child relationship needed to decide whether
- * (and how) to scope a polymorphic drill-down. Mirrors the polymorphic fields
- * projected onto a multi-join by the server's `_dbSchema` resolver.
- */
-export interface PolymorphicDescriptor {
-    isPolymorphic?: boolean;
-    polymorphicTypeColumn?: string;
-    polymorphicTypeValue?: string;
-}
-/**
- * Build the discriminator filter clause for a polymorphic child drill-down, or
- * `null` when the relationship is not polymorphic (or lacks discriminator info).
- *
- * Returns a single filter object clause string such as
- * `{entity_type: {_eq: "company"}}` ready to be combined with the id predicate.
- */
-export declare function buildPolymorphicClause(rel: PolymorphicDescriptor): string | null;
-/**
- * Build the complete drill-down filter for a parent→child relationship,
- * combining the id predicate with the polymorphic discriminator when present.
- *
- * - Non-polymorphic: `{<idColumn>: {_eq: $id}}` (unchanged legacy shape).
- * - Polymorphic: `{and: [{<idColumn>: {_eq: $id}}, {<typeColumn>: {_eq: "<typeValue>"}}]}`.
- *
- * `idVar` defaults to `$id` to match `buildQuery`'s variable naming.
- */
-export declare function buildChildDrillDownFilter(idColumn: string, rel: PolymorphicDescriptor, idVar?: string): string;
-/**
- * Locate the parent table's multi-join that targets a given child via a given
- * destination (id) column, so the drill-down can read its polymorphic fields.
- * Returns `undefined` when no matching multi-join exists.
- */
-export declare function findChildMultiJoin(parentMultiJoins: Join[] | undefined, childTable: string, idColumn: string): Join | undefined;
+ * Locate the parent table's multi-join that targets a given child table. When
+ * the parent has more than one multi-join to the same child (e.g. a polymorphic
+ * shared table mapped under several parents, or a self-FK alias), `idColumn`
+ * (the child destination column) disambiguates. Returns `undefined` when no
+ * matching multi-join exists.
+ */
+export declare function resolveChildJoin(parentMultiJoins: Join[] | undefined, childTable: string, idColumn?: string): Join | undefined;
+/** The child collection field name on the parent type for a given join. */
+export declare function childFieldName(join: Join): string;

package/dist/lib/query-builder.d.ts

@@ -49,4 +49,34 @@ export declare function getPkTypes(table: Table): PkTypeInfo[];
  */
 export declare function buildPkEqVariables(idRoute: string, table: Table): Record<string, unknown>;
 export declare function buildQuery(table: Table, schema: Schema, filterString: string, columnFilters: ColumnFiltersState, id?: string, tableFilter?: string, filterColumn?: string): string | null;
+export interface DrillDownTarget {
+    /** The parent table whose row owns the child collection. */
+    parentTable: Table;
+    /** The child collection field name on the parent type. */
+    childField: string;
+}
+/**
+ * Resolve the parent table + child collection field for a parent→child
+ * related-records drill-down. The child is `table`; the parent is `tableFilter`
+ * (or the destination of `table`'s single-join named `tableFilter` when the
+ * relationship is described from the child side). `filterColumn` (the child
+ * destination column) disambiguates when the parent has several multi-joins to
+ * the same child. Returns `null` when no parent multi-join targets the child —
+ * the caller then falls back to the standard (non-traversal) query.
+ */
+export interface PagedResult {
+    data: unknown[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+/**
+ * Unwrap the nested paged child collection from a MODEL B drill-down response.
+ *
+ * The query shape is `{ <parentField>: { data: [ { <childField>: <paged> } ] } }`.
+ * Returns the child's `{total,offset,limit,data}` page, or an empty page when the
+ * parent row was not found (no children / unknown id).
+ */
+export declare function unwrapDrillDownPage(response: Record<string, unknown> | null | undefined, parentField: string, childField: string): PagedResult;
+export declare function resolveDrillDown(table: Table, schema: Schema, tableFilter?: string, filterColumn?: string): DrillDownTarget | null;
 export {};

package/dist/types/schema.d.ts

@@ -98,16 +98,6 @@ export interface Join {
     destinationTable: string;
     /** Column names in the target table */
     destinationColumnNames: string[];
-    /**
-     * True when the target is a shared polymorphic child table keyed by a
-     * discriminator column plus an id column (e.g. notes keyed by entity_type +
-     * entity_id). Only present on multi-joins; absent/false on plain FK joins.
-     */
-    isPolymorphic?: boolean;
-    /** Discriminator column on the child table (e.g. "entity_type"). Set when isPolymorphic. */
-    polymorphicTypeColumn?: string;
-    /** Discriminator value identifying this parent's rows (e.g. "company"). Set when isPolymorphic. */
-    polymorphicTypeValue?: string;
 }
 /**
  * Many-to-many bridge between this entity and a target entity through a

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@standardbeagle/edit-db",
   "private": false,
-  "version": "0.4.417",
+  "version": "0.4.418",
   "type": "module",
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.4",