clivly 0.9.6 → 0.10.0

package/internal-CvlFk3KC.d.mts

@@ -1,180 +0,0 @@
-import { M as ProjectionIdentity, N as ProjectionJoin, P as ProjectionMapping, j as ProjectionFieldBinding, l as ConfigValidationError, m as DiscoveredSchemaTable, p as DiscoveredColumnMeta } from "./entity-config-B2RA53nw.mjs";
-//#region ../core/src/projection-cardinality.d.ts
-declare function joinFansOut(join: ProjectionJoin, joinTable: DiscoveredSchemaTable): boolean;
-/** Every join in the projection that can multiply rows. */
-declare function fanOutJoins(projection: ProjectionMapping, tablesByName: Map<string, DiscoveredSchemaTable>): ProjectionJoin[];
-//#endregion
-//#region ../core/src/projection-draft.d.ts
-/**
- * The builder's in-progress shape.
- *
- * A draft is deliberately looser than a `ProjectionMapping`: it exists while
- * the user is still choosing things, so every field can be empty. All of the
- * builder's rules live here as pure functions, which keeps the React components
- * presentational and lets the rules be tested without a DOM.
- */
-interface ProjectionDraft {
-  baseTable: string;
-  entityKey: string;
-  fieldBindings: Record<string, ProjectionFieldBinding>;
-  identity: ProjectionIdentity;
-  joins: ProjectionJoin[];
-}
-declare function emptyProjectionDraft(baseTable: string): ProjectionDraft;
-/**
- * The ON conditions implied by a foreign key between the two tables, so the
- * builder can pre-fill a join instead of making the user hand-pick columns.
- * Returns [] when no FK relates them — the user then picks manually.
- */
-declare function suggestJoinConditions(baseTable: string, joinTable: string, schema: DiscoveredSchemaTable[], joinKey: string): ProjectionJoin["on"];
-/**
- * Add a join on `joinTable`, keyed and pre-filled.
- *
- * The key is the table's own name where that is free, because it is what the
- * user already calls the table; a collision falls back to `_2`, `_3` and so on.
- * Uniqueness is not cosmetic — the key is the SQL alias and the name every ref
- * addresses the table by, so two joins sharing one would make every ref
- * ambiguous. `base` is reserved for the base table and can never be taken.
- */
-declare function addDraftJoin(draft: ProjectionDraft, joinTable: string, schema: DiscoveredSchemaTable[]): ProjectionDraft;
-/**
- * Remove a join, and everything that addressed it.
- *
- * Refs to a removed join are refs to a table the projection no longer declares.
- * Left in place they fail validation as "unknown ref table", which blames the
- * field — or, worse, the identity — for the join's removal. Identity falls back
- * to the base primary key, the same default a new draft starts from.
- */
-declare function removeDraftJoin(draft: ProjectionDraft, joinKey: string): ProjectionDraft;
-/** One selectable table in the builder's column pickers. */
-interface DraftRefOption {
-  columns: string[];
-  label: string;
-  ref: string;
-}
-/**
- * Every table a field or identity may currently read from, in ref order: the
- * base table first, then each join.
- *
- * Returns [] when the base table is not in the discovered schema — there is
- * nothing truthful to offer, and inventing columns would let someone build a
- * projection that cannot compile.
- */
-declare function draftRefOptions(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): DraftRefOption[];
-/** A draft becomes a projection once it has a valid key and ≥1 binding. */
-declare function draftToProjection(draft: ProjectionDraft): ProjectionMapping | null;
-/**
- * Every reason this draft cannot be saved, one per cause and each anchored to
- * the section that owns it.
- *
- * One lumped "Name the object and map a field." was all this used to return for
- * an incomplete draft, at the bare path "projection". Two consequences, both
- * bad: a builder had nowhere to attach the message, and — because it returned
- * before validating — a fanning join under a `base_pk` identity stayed silent
- * until the draft was otherwise complete, which is well after the point where
- * the user chose the join.
- */
-declare function draftErrors(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): ConfigValidationError[];
-/**
- * Per-join fan-out, for the builder's inline cardinality hints.
- *
- * Answered from the joins alone. Joins are chosen before the key and the fields
- * are filled in, and a fan-out warning is precisely what should steer the
- * identity choice while it is being made — requiring a complete draft put the
- * hint after the decision it exists to inform.
- */
-declare function describeCardinality(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): Array<{
-  fansOut: boolean;
-  joinKey: string;
-}>;
-//#endregion
-//#region ../core/src/projection-sql.d.ts
-/**
- * SQL generation for projection-backed entities.
- *
- * Base and joins are aliased by their ref key (`base`, then each join's `key`),
- * which is what allows the same table to be joined twice and keeps generated
- * SQL independent of host table names.
- *
- * Pure string generation — no DB access. Identifiers are escaped so output is
- * deterministic and injection-safe.
- */
-/** Quote a single identifier part, escaping embedded double-quotes. */
-declare function quoteIdent(name: string): string;
-/**
- * The identity expression. Composite identities concatenate their parts with
- * `::`; validation guarantees every part is NOT NULL and non-text, which is
- * what makes the concatenation collision-free.
- *
- * Exported unaliased because two paths need the same expression under different
- * names: the view compiler aliases it `id`, and the SDK's projection push source
- * also orders and keyset-paginates by it. Sharing one definition is what keeps
- * a pushed row's `id` identical to the one the view would have produced.
- */
-declare function compileProjectionIdentity(projection: ProjectionMapping, basePkColumn: string): string;
-declare function compileProjectionSelect(projection: ProjectionMapping, basePkColumn: string): {
-  columns: string[];
-  selectItems: string[];
-};
-declare function compileProjectionJoins(projection: ProjectionMapping): string[];
-/** `FROM <baseTable> AS "base"` — the alias every ref resolves against. */
-declare function compileProjectionFrom(projection: ProjectionMapping): string;
-/**
- * Hard ceiling on preview rows, regardless of what a caller asks for.
- *
- * A preview runs against a production database from a button a user can click
- * as often as they like, so the cap belongs beside the query rather than in
- * whichever caller happens to be passing a limit today.
- */
-declare const PREVIEW_MAX_ROWS = 50;
-/**
- * One SELECT reading a few rows through an UNSAVED projection, for the derived
- * object builder's preview.
- *
- * Lives here, beside the view compiler, because both sides of the round trip
- * need the identical statement: an embedded org runs it against its own
- * database from `@clivly.com/api`, and a cloud org's host app runs it from
- * `@clivly/sdk`. Two copies would be free to disagree about what the user is
- * being shown, which is the whole value of a preview.
- *
- * Columns are aliased by FIELD NAME, not by ref token. That is the deliberate
- * difference from the push source, which aliases by token because cloud ingest
- * reads `row[token]`; a preview is read by a person, in a table whose headers
- * are the field names they just typed.
- */
-declare function compileProjectionPreview(projection: ProjectionMapping, limit: number): string;
-//#endregion
-//#region ../core/src/projection-validate.d.ts
-/**
- * Validate a projection against the discovered schema. Returns every error
- * found (not just the first) so a builder UI can show them all at once.
- */
-declare function validateProjection(projection: ProjectionMapping, schema: DiscoveredSchemaTable[], base: string): ConfigValidationError[];
-//#endregion
-//#region ../core/src/schema-meta.d.ts
-/**
- * Accessors over a discovered table's schema-v2 metadata.
- *
- * Every helper treats *absent* metadata as **unknown**, never as a negative
- * fact. `coversUniqueKey` returning false on a v1 payload is what makes
- * projection validation fail closed: we cannot prove a join is many-to-one, so
- * we refuse to compile it rather than guess.
- */
-declare function columnMetaFor(table: DiscoveredSchemaTable, column: string): DiscoveredColumnMeta | undefined;
-/**
- * Every primary-key column. More than one entry means a composite PK, which is
- * why `base_pk` identity is rejected for such tables.
- */
-declare function primaryKeyColumns(table: DiscoveredSchemaTable): string[];
-/**
- * Do `columns` contain every column of at least one unique key on `table`?
- *
- * This is the fan-out test. A join whose ON columns cover a unique key of the
- * joined table matches at most one row per base row; one that does not can
- * match many.
- */
-declare function coversUniqueKey(table: DiscoveredSchemaTable, columns: string[]): boolean;
-/** Is this table's payload rich enough to validate a projection against? */
-declare function hasRichMeta(table: DiscoveredSchemaTable): boolean;
-//#endregion
-export { fanOutJoins as C, suggestJoinConditions as S, draftErrors as _, validateProjection as a, emptyProjectionDraft as b, compileProjectionIdentity as c, compileProjectionSelect as d, quoteIdent as f, describeCardinality as g, addDraftJoin as h, primaryKeyColumns as i, compileProjectionJoins as l, ProjectionDraft as m, coversUniqueKey as n, PREVIEW_MAX_ROWS as o, DraftRefOption as p, hasRichMeta as r, compileProjectionFrom as s, columnMetaFor as t, compileProjectionPreview as u, draftRefOptions as v, joinFansOut as w, removeDraftJoin as x, draftToProjection as y };

package/internal-DGUOLQAq.d.cts

@@ -1,180 +0,0 @@
-import { M as ProjectionIdentity, N as ProjectionJoin, P as ProjectionMapping, j as ProjectionFieldBinding, l as ConfigValidationError, m as DiscoveredSchemaTable, p as DiscoveredColumnMeta } from "./entity-config-B2RA53nw.cjs";
-//#region ../core/src/projection-cardinality.d.ts
-declare function joinFansOut(join: ProjectionJoin, joinTable: DiscoveredSchemaTable): boolean;
-/** Every join in the projection that can multiply rows. */
-declare function fanOutJoins(projection: ProjectionMapping, tablesByName: Map<string, DiscoveredSchemaTable>): ProjectionJoin[];
-//#endregion
-//#region ../core/src/projection-draft.d.ts
-/**
- * The builder's in-progress shape.
- *
- * A draft is deliberately looser than a `ProjectionMapping`: it exists while
- * the user is still choosing things, so every field can be empty. All of the
- * builder's rules live here as pure functions, which keeps the React components
- * presentational and lets the rules be tested without a DOM.
- */
-interface ProjectionDraft {
-  baseTable: string;
-  entityKey: string;
-  fieldBindings: Record<string, ProjectionFieldBinding>;
-  identity: ProjectionIdentity;
-  joins: ProjectionJoin[];
-}
-declare function emptyProjectionDraft(baseTable: string): ProjectionDraft;
-/**
- * The ON conditions implied by a foreign key between the two tables, so the
- * builder can pre-fill a join instead of making the user hand-pick columns.
- * Returns [] when no FK relates them — the user then picks manually.
- */
-declare function suggestJoinConditions(baseTable: string, joinTable: string, schema: DiscoveredSchemaTable[], joinKey: string): ProjectionJoin["on"];
-/**
- * Add a join on `joinTable`, keyed and pre-filled.
- *
- * The key is the table's own name where that is free, because it is what the
- * user already calls the table; a collision falls back to `_2`, `_3` and so on.
- * Uniqueness is not cosmetic — the key is the SQL alias and the name every ref
- * addresses the table by, so two joins sharing one would make every ref
- * ambiguous. `base` is reserved for the base table and can never be taken.
- */
-declare function addDraftJoin(draft: ProjectionDraft, joinTable: string, schema: DiscoveredSchemaTable[]): ProjectionDraft;
-/**
- * Remove a join, and everything that addressed it.
- *
- * Refs to a removed join are refs to a table the projection no longer declares.
- * Left in place they fail validation as "unknown ref table", which blames the
- * field — or, worse, the identity — for the join's removal. Identity falls back
- * to the base primary key, the same default a new draft starts from.
- */
-declare function removeDraftJoin(draft: ProjectionDraft, joinKey: string): ProjectionDraft;
-/** One selectable table in the builder's column pickers. */
-interface DraftRefOption {
-  columns: string[];
-  label: string;
-  ref: string;
-}
-/**
- * Every table a field or identity may currently read from, in ref order: the
- * base table first, then each join.
- *
- * Returns [] when the base table is not in the discovered schema — there is
- * nothing truthful to offer, and inventing columns would let someone build a
- * projection that cannot compile.
- */
-declare function draftRefOptions(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): DraftRefOption[];
-/** A draft becomes a projection once it has a valid key and ≥1 binding. */
-declare function draftToProjection(draft: ProjectionDraft): ProjectionMapping | null;
-/**
- * Every reason this draft cannot be saved, one per cause and each anchored to
- * the section that owns it.
- *
- * One lumped "Name the object and map a field." was all this used to return for
- * an incomplete draft, at the bare path "projection". Two consequences, both
- * bad: a builder had nowhere to attach the message, and — because it returned
- * before validating — a fanning join under a `base_pk` identity stayed silent
- * until the draft was otherwise complete, which is well after the point where
- * the user chose the join.
- */
-declare function draftErrors(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): ConfigValidationError[];
-/**
- * Per-join fan-out, for the builder's inline cardinality hints.
- *
- * Answered from the joins alone. Joins are chosen before the key and the fields
- * are filled in, and a fan-out warning is precisely what should steer the
- * identity choice while it is being made — requiring a complete draft put the
- * hint after the decision it exists to inform.
- */
-declare function describeCardinality(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): Array<{
-  fansOut: boolean;
-  joinKey: string;
-}>;
-//#endregion
-//#region ../core/src/projection-sql.d.ts
-/**
- * SQL generation for projection-backed entities.
- *
- * Base and joins are aliased by their ref key (`base`, then each join's `key`),
- * which is what allows the same table to be joined twice and keeps generated
- * SQL independent of host table names.
- *
- * Pure string generation — no DB access. Identifiers are escaped so output is
- * deterministic and injection-safe.
- */
-/** Quote a single identifier part, escaping embedded double-quotes. */
-declare function quoteIdent(name: string): string;
-/**
- * The identity expression. Composite identities concatenate their parts with
- * `::`; validation guarantees every part is NOT NULL and non-text, which is
- * what makes the concatenation collision-free.
- *
- * Exported unaliased because two paths need the same expression under different
- * names: the view compiler aliases it `id`, and the SDK's projection push source
- * also orders and keyset-paginates by it. Sharing one definition is what keeps
- * a pushed row's `id` identical to the one the view would have produced.
- */
-declare function compileProjectionIdentity(projection: ProjectionMapping, basePkColumn: string): string;
-declare function compileProjectionSelect(projection: ProjectionMapping, basePkColumn: string): {
-  columns: string[];
-  selectItems: string[];
-};
-declare function compileProjectionJoins(projection: ProjectionMapping): string[];
-/** `FROM <baseTable> AS "base"` — the alias every ref resolves against. */
-declare function compileProjectionFrom(projection: ProjectionMapping): string;
-/**
- * Hard ceiling on preview rows, regardless of what a caller asks for.
- *
- * A preview runs against a production database from a button a user can click
- * as often as they like, so the cap belongs beside the query rather than in
- * whichever caller happens to be passing a limit today.
- */
-declare const PREVIEW_MAX_ROWS = 50;
-/**
- * One SELECT reading a few rows through an UNSAVED projection, for the derived
- * object builder's preview.
- *
- * Lives here, beside the view compiler, because both sides of the round trip
- * need the identical statement: an embedded org runs it against its own
- * database from `@clivly.com/api`, and a cloud org's host app runs it from
- * `@clivly/sdk`. Two copies would be free to disagree about what the user is
- * being shown, which is the whole value of a preview.
- *
- * Columns are aliased by FIELD NAME, not by ref token. That is the deliberate
- * difference from the push source, which aliases by token because cloud ingest
- * reads `row[token]`; a preview is read by a person, in a table whose headers
- * are the field names they just typed.
- */
-declare function compileProjectionPreview(projection: ProjectionMapping, limit: number): string;
-//#endregion
-//#region ../core/src/projection-validate.d.ts
-/**
- * Validate a projection against the discovered schema. Returns every error
- * found (not just the first) so a builder UI can show them all at once.
- */
-declare function validateProjection(projection: ProjectionMapping, schema: DiscoveredSchemaTable[], base: string): ConfigValidationError[];
-//#endregion
-//#region ../core/src/schema-meta.d.ts
-/**
- * Accessors over a discovered table's schema-v2 metadata.
- *
- * Every helper treats *absent* metadata as **unknown**, never as a negative
- * fact. `coversUniqueKey` returning false on a v1 payload is what makes
- * projection validation fail closed: we cannot prove a join is many-to-one, so
- * we refuse to compile it rather than guess.
- */
-declare function columnMetaFor(table: DiscoveredSchemaTable, column: string): DiscoveredColumnMeta | undefined;
-/**
- * Every primary-key column. More than one entry means a composite PK, which is
- * why `base_pk` identity is rejected for such tables.
- */
-declare function primaryKeyColumns(table: DiscoveredSchemaTable): string[];
-/**
- * Do `columns` contain every column of at least one unique key on `table`?
- *
- * This is the fan-out test. A join whose ON columns cover a unique key of the
- * joined table matches at most one row per base row; one that does not can
- * match many.
- */
-declare function coversUniqueKey(table: DiscoveredSchemaTable, columns: string[]): boolean;
-/** Is this table's payload rich enough to validate a projection against? */
-declare function hasRichMeta(table: DiscoveredSchemaTable): boolean;
-//#endregion
-export { fanOutJoins as C, suggestJoinConditions as S, draftErrors as _, validateProjection as a, emptyProjectionDraft as b, compileProjectionIdentity as c, compileProjectionSelect as d, quoteIdent as f, describeCardinality as g, addDraftJoin as h, primaryKeyColumns as i, compileProjectionJoins as l, ProjectionDraft as m, coversUniqueKey as n, PREVIEW_MAX_ROWS as o, DraftRefOption as p, hasRichMeta as r, compileProjectionFrom as s, columnMetaFor as t, compileProjectionPreview as u, draftRefOptions as v, joinFansOut as w, removeDraftJoin as x, draftToProjection as y };