@standardbeagle/edit-db 0.4.407 → 0.4.414

package/dist/hooks/useCompositeTableRef.d.ts

@@ -0,0 +1,19 @@
+import { Schema } from '../types/schema';
+export interface CompositeTableRefValue {
+    /** Route-encoded composite key (`v1::v2`) suitable as a Select value. */
+    route: string;
+    /** Per-column raw values keyed by destination column name. */
+    values: Record<string, unknown>;
+    label: string;
+}
+export interface CompositeTableRef {
+    loading: boolean;
+    error: unknown;
+    data: CompositeTableRefValue[];
+}
+/**
+ * Fetch parent rows for a composite-FK Select widget. Returns one row per parent
+ * with its label plus every destination column value so the caller can write
+ * each composite-FK source column on the child form when a selection is made.
+ */
+export declare function useCompositeTableRef(schema: Schema, destTableName: string, destColumnNames: string[]): CompositeTableRef;

package/dist/hooks/useDataTable.d.ts

@@ -1,4 +1,4 @@
-import { Table } from '../types/schema';
+import { Table, Join } from '../types/schema';
 import { ColumnDef, ColumnFiltersState, SortingState } from '@tanstack/react-table';
 import { ColumnPanel } from '../data-panel';
 export { getFilterOperators } from '../lib/query-builder';
@@ -7,6 +7,7 @@ interface RowData {
     id?: number | string;
     [key: string]: unknown;
 }
+export declare function getMultiJoinRows(row: RowData, join: Join): RowData[];
 /**
  * Return type for the useDataTable hook.
  * @interface UseDataTableResult

package/dist/hooks/useDataTable.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/fk.d.ts

@@ -0,0 +1,21 @@
+import { Join, Table } from '../types/schema';
+export interface FkEqFilterResult {
+    filterText: string;
+    variables: Record<string, unknown>;
+    params: string[];
+}
+export declare function isFkMember(join: Join, columnName: string): boolean;
+export declare function isComposite(join: Join): boolean;
+export declare function findJoinBySource(joins: Join[], columnName: string): Join | undefined;
+export declare function findJoinByDestinationTable(joins: Join[], destinationTable: string): Join | undefined;
+/**
+ * Build a `{_eq}`-per-column composite filter against the destination side of a join,
+ * using values pulled from a source-side row. Single-column joins emit a single
+ * `{col: {_eq: $var}}` clause; composite joins are wrapped in `{and: [...]}`.
+ */
+export declare function buildFkEqFilter(sourceRow: Record<string, unknown> | null | undefined, join: Join, destinationTable: Pick<Table, 'columns'> | undefined, varPrefix?: string): FkEqFilterResult | null;
+/**
+ * Extract source-side column values from a row into a plain `{col: value}` object.
+ * Returns null if any source column is missing from the row, so callers can short-circuit.
+ */
+export declare function fkSourceValues(sourceRow: Record<string, unknown> | null | undefined, join: Join): Record<string, unknown> | null;

package/dist/lib/fk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/m2m.d.ts

@@ -0,0 +1,47 @@
+import { Column, Join, ManyToManyJoin, Table } from '../types/schema';
+/** A tab in the detail panel: an ordinary child collection or a m2m bridge. */
+export type DetailTab = {
+    kind: 'child';
+    key: string;
+    join: Join;
+} | {
+    kind: 'm2m';
+    key: string;
+    m2m: ManyToManyJoin;
+};
+/** GraphQL names of every junction table reachable from `table` via a m2m join. */
+export declare function junctionTableNames(table: Table): Set<string>;
+/**
+ * The detail tabs for a parent table: its plain one-to-many children (minus any
+ * junction tables, which are folded into their m2m tab) followed by one tab per
+ * many-to-many bridge.
+ */
+export declare function detailTabs(table: Table): DetailTab[];
+/** Junction columns that are neither a primary key nor one of the two bridge FKs. */
+export declare function payloadColumns(junction: Table, m2m: ManyToManyJoin): Column[];
+/**
+ * Build the one-shot query that fetches the junction rows for a parent, each
+ * carrying its payload plus the nested target row (key + label). The grid
+ * flattens the target columns for display and keeps the junction PK so a link
+ * can be detached by deleting its junction row.
+ */
+export declare function m2mRowsQuery(junction: Table, target: Table, m2m: ManyToManyJoin, parentId: string): {
+    query: string;
+    variables: Record<string, unknown>;
+};
+/**
+ * Read the target row's id and display label from a junction row's nested target
+ * selection (emitted by {@link m2mRowsQuery}). Returns null when the link has no
+ * resolved target. The label falls back to the id; the id is the target's first
+ * primary-key column, coerced to a string for routing.
+ */
+export declare function targetDisplay(junctionRow: Record<string, unknown>, m2m: ManyToManyJoin, target: Table): {
+    id: string;
+    label: string;
+} | null;
+/**
+ * The insert detail for a new link: the parent key on the junction source FK and
+ * the chosen target key on the junction target FK. Any payload columns are left
+ * unset so the database applies its defaults; the user edits them afterwards.
+ */
+export declare function attachJunctionDetail(m2m: ManyToManyJoin, parentId: string, targetId: string): Record<string, unknown>;

package/dist/lib/m2m.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/schema.d.ts

@@ -88,15 +88,44 @@ export interface Column {
  * @interface Join
  */
 export interface Join {
-    /** Name of the join relationship */
+    /** Descriptive relationship name retained for compatibility; do not use it as the query field. */
     name: string;
+    /** GraphQL selection field for this relationship on the source table. May differ from destinationTable for aliases such as self-FK child collections. */
+    fieldName?: string;
     /** Column names in the source table */
     sourceColumnNames: string[];
-    /** Target table name */
+    /** Target table/type name. Use for schema lookup and navigation, not as the relationship selection field when fieldName is present. */
     destinationTable: string;
     /** Column names in the target table */
     destinationColumnNames: string[];
 }
+/**
+ * Many-to-many bridge between this entity and a target entity through a
+ * junction table. Projected by the server's `_dbSchema` resolver. The UI uses
+ * the junction's own multi-join for the rows query and these fields to skip
+ * the junction for navigation, drilling straight to the target entity.
+ * @interface ManyToManyJoin
+ */
+export interface ManyToManyJoin {
+    /** Junction table GraphQL name (also the relationship name). */
+    name: string;
+    /** Target entity GraphQL type/table name. */
+    targetTable: string;
+    /** Junction table GraphQL type/table name. */
+    junctionTable: string;
+    /** Selection field on the junction type that resolves the target row. */
+    junctionTargetField: string;
+    /** Key column(s) on this (source) entity. */
+    sourceColumnNames: string[];
+    /** Junction column(s) referencing this (source) entity. */
+    junctionSourceColumnNames: string[];
+    /** Junction column(s) referencing the target entity. */
+    junctionTargetColumnNames: string[];
+    /** Key column(s) on the target entity. */
+    targetColumnNames: string[];
+    /** True when the junction carries extra (non-key) payload columns to reveal. */
+    hasPayload: boolean;
+}
 /**
  * Table definition from database schema introspection.
  * @interface Table
@@ -124,6 +153,8 @@ export interface Table {
     multiJoins: Join[];
     /** Many-to-one relationship joins */
     singleJoins: Join[];
+    /** Many-to-many bridges through junction tables (optional; absent on older servers). */
+    manyToManyJoins?: ManyToManyJoin[];
 }
 /**
  * Schema context value containing database metadata and loading state.

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@standardbeagle/edit-db",
   "private": false,
-  "version": "0.4.407",
+  "version": "0.4.414",
   "type": "module",
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.4",
     "@tanstack/react-form": "^1.32.0",
-    "@tanstack/react-query": "^5.100.10",
+    "@tanstack/react-query": "^5.100.14",
     "@tanstack/react-table": "^8.21.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -19,16 +19,13 @@
   },
   "devDependencies": {
     "@babel/core": "^7.29.0",
-    "@storybook/addon-actions": "^9.0.8",
-    "@storybook/addon-essentials": "^8.6.14",
-    "@storybook/addon-interactions": "^8.6.14",
-    "@storybook/addon-links": "^10.4.0",
-    "@storybook/react": "^10.4.0",
-    "@storybook/react-vite": "^10.4.0",
+    "@storybook/addon-links": "^10.4.1",
+    "@storybook/react": "^10.4.1",
+    "@storybook/react-vite": "^10.4.1",
     "@tailwindcss/vite": "^4.3.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
-    "@types/react": "^18.3.28",
+    "@types/react": "^18.3.29",
     "@types/react-dom": "^18.3.7",
     "@types/redux-actions": "^2.6.5",
     "@typescript-eslint/eslint-plugin": "^7.18.0",
@@ -41,7 +38,7 @@
     "eslint-plugin-react-hooks": "^4.6.2",
     "eslint-plugin-react-refresh": "^0.4.26",
     "jsdom": "^25.0.1",
-    "storybook": "^10.4.0",
+    "storybook": "^10.4.1",
     "tailwindcss": "^4.3.0",
     "typescript": "^5.9.3",
     "vite": "^7.3.3",