@palbase/backend 33.0.2 → 34.0.0

package/dist/db/index.d.cts

@@ -1,5 +1,48 @@
-export { h as AnyColumn, n as ColumnBuilder, o as ColumnDef, p as ColumnMap, q as ColumnType, v as EXTENSION_DEPENDENCIES, w as EmbeddingModelRef, E as EnvServiceDatabase, z as EnvTypedDatabase, V as InsertShape, $ as Materialized, a6 as OnDeleteAction, a8 as PALBASE_EXTENSIONS, aI as PalbaseExtension, bF as PolicyBuilder, bG as PolicyCommand, bH as PolicyDef, bK as PolicyMode, bN as RawConstraintDef, bP as Ref, bR as RowShape, S as SchemaDef, b_ as TABLE_META, b$ as TableDef, c0 as TableHandle, c1 as TableInput, c3 as TxColumnExpr, c4 as TxInsertShape, c6 as TxNow, c7 as TxPlan, T as TxPlanBody, c8 as TxPlanError, c9 as TxPlanHandle, ca as TxPlanOpResult, cb as TxPlanRejection, c as TxPlanResponse, cc as TxRefError, cd as TxRow, ce as TxRows, cf as TxSelectOptions, cg as TxSetShape, ci as TxTable, cj as TxTables, ck as TxWhere, cq as TypedDB, cr as TypedTable, cs as TypedTx, cD as bigint, cE as boolean, cG as dec, cJ as defineSchema, cK as defineTable, cL as enumType, cN as inc, cQ as installationRef, cR as integer, cS as isPalbaseExtension, cU as jsonb, cV as makeTypedDB, cW as now, c_ as openai, c$ as ownedByUser, d0 as policy, d1 as raw, d3 as text, d4 as timestamp, d5 as userRef, d6 as uuid, d7 as vector } from '../index-DB_nW-AV.cjs';
-import './env.cjs';
+import { P as PreparedRead, c3 as QueryDatabase, U as EnvQueryDatabase, C as CompiledRead, F as ColumnMap, ck as TableHandle, cS as WhereFilter, dx as ColValue, a2 as FindManyOpts } from '../endpoint-kYgEHrrV.cjs';
+export { q as AnyColumn, r as AtomicDatabase, s as AtomicOptions, y as ColumnBuilder, z as ColumnDef, G as ColumnType, i as CommandOptions, D as DatabaseBudget, d as DatabaseDiagnostics, c as DatabaseDiagnosticsOptions, K as DatabaseQueryEvent, L as DatabaseWorkload, O as EXTENSION_DEPENDENCIES, Q as EmbeddingModelRef, E as EnvServiceDatabase, X as EnvTypedDatabase, a8 as InsertManyOptions, a9 as InsertShape, ae as Materialized, al as OnDeleteAction, an as PALBASE_EXTENSIONS, g as Page, ap as PageInfo, aq as PageInput, ar as PageNavigation, a_ as PalbaseExtension, bX as PolicyBuilder, bY as PolicyCommand, bZ as PolicyDef, c0 as PolicyMode, c2 as QueryColumnContract, c5 as RawConstraintDef, f as RawPageOptions, c7 as Ref, c9 as RowShape, S as SchemaDef, ci as TABLE_META, cj as TableDef, cl as TableInput, T as TransactionIsolation, cn as TxColumnExpr, co as TxInsertShape, cq as TxNow, cr as TxPlan, h as TxPlanBody, cs as TxPlanError, ct as TxPlanHandle, cu as TxPlanOpResult, cv as TxPlanRejection, j as TxPlanResponse, cw as TxRefError, cx as TxRow, cy as TxRows, cz as TxSelectOptions, cA as TxSetShape, cC as TxTable, cD as TxTables, cE as TxWhere, cK as TypedDB, cL as TypedTable, cM as TypedTx, cP as UniqueWhere, cU as WorkloadOptions, cZ as bigint, c_ as boolean, d0 as dec, d3 as defineSchema, d4 as defineTable, d5 as defineWorkload, d6 as enumType, d8 as inc, db as installationRef, dc as integer, dd as isPalbaseExtension, df as jsonb, dg as makeTypedDB, dh as now, dl as openai, dm as ownedByUser, dn as policy, dp as raw, dr as text, ds as timestamp, dt as userRef, du as uuid, dv as vector } from '../endpoint-kYgEHrrV.cjs';
+import { z } from 'zod';
 import '../stack.cjs';
-import 'zod';
+import './env.cjs';
 import 'node:async_hooks';
+
+type QueryRow<C extends ColumnMap> = {
+    [K in keyof C]: ColValue<C[K]>;
+};
+type Database = QueryDatabase | EnvQueryDatabase;
+/** The query IS its response Zod schema, so the existing return-type binder,
+ * OpenAPI generator and clients use the same declaration without a second DTO. */
+type QueryDefinition<Row, Input extends z.ZodTypeAny> = z.ZodArray<z.ZodType<Row>> & {
+    readonly queryName: string;
+    readonly input: Input;
+    prepare(input: z.input<Input>): PreparedRead;
+    run(database: Database, input: z.input<Input>): Promise<Row[]>;
+    sql(database: Database, input: z.input<Input>): CompiledRead;
+    /** Plain EXPLAIN only: never ANALYZE, and always under the caller's RLS identity. */
+    explain(database: Database, input: z.input<Input>): Promise<unknown[]>;
+    contract(): Record<string, unknown>;
+};
+/** Declare a reusable SELECT with an explicit response projection. */
+declare function defineQuery<C extends ColumnMap, const K extends readonly Extract<keyof C, string>[], Input extends z.ZodTypeAny>(name: string, options: {
+    table: TableHandle<C>;
+    input: Input;
+    select: K;
+    where?: (input: z.output<Input>) => WhereFilter<QueryRow<NoInfer<C>>>;
+    orderBy?: FindManyOpts<QueryRow<NoInfer<C>>>["orderBy"];
+    limit?: number | ((input: z.output<Input>) => number);
+    /** Required for jsonb; can also explicitly narrow another response field. */
+    fields?: {
+        [P in K[number]]?: z.ZodType<QueryRow<NoInfer<C>>[P]>;
+    };
+}): QueryDefinition<Pick<QueryRow<C>, K[number]>, Input>;
+declare function queryManifest(queries: readonly {
+    queryName: string;
+    contract(): Record<string, unknown>;
+}[]): Record<string, unknown>;
+/** Commit the manifest; CI compares the generated value before accepting a
+ * changed response. A reviewed baseline update is explicit, never automatic. */
+declare function assertQueryManifest(queries: readonly {
+    queryName: string;
+    contract(): Record<string, unknown>;
+}[], baseline: unknown): void;
+
+export { ColumnMap, CompiledRead, EnvQueryDatabase, PreparedRead, QueryDatabase, type QueryDefinition, TableHandle, assertQueryManifest, defineQuery, queryManifest };

package/dist/db/index.d.ts

@@ -1,5 +1,48 @@
-export { h as AnyColumn, n as ColumnBuilder, o as ColumnDef, p as ColumnMap, q as ColumnType, v as EXTENSION_DEPENDENCIES, w as EmbeddingModelRef, E as EnvServiceDatabase, z as EnvTypedDatabase, V as InsertShape, $ as Materialized, a6 as OnDeleteAction, a8 as PALBASE_EXTENSIONS, aI as PalbaseExtension, bF as PolicyBuilder, bG as PolicyCommand, bH as PolicyDef, bK as PolicyMode, bN as RawConstraintDef, bP as Ref, bR as RowShape, S as SchemaDef, b_ as TABLE_META, b$ as TableDef, c0 as TableHandle, c1 as TableInput, c3 as TxColumnExpr, c4 as TxInsertShape, c6 as TxNow, c7 as TxPlan, T as TxPlanBody, c8 as TxPlanError, c9 as TxPlanHandle, ca as TxPlanOpResult, cb as TxPlanRejection, c as TxPlanResponse, cc as TxRefError, cd as TxRow, ce as TxRows, cf as TxSelectOptions, cg as TxSetShape, ci as TxTable, cj as TxTables, ck as TxWhere, cq as TypedDB, cr as TypedTable, cs as TypedTx, cD as bigint, cE as boolean, cG as dec, cJ as defineSchema, cK as defineTable, cL as enumType, cN as inc, cQ as installationRef, cR as integer, cS as isPalbaseExtension, cU as jsonb, cV as makeTypedDB, cW as now, c_ as openai, c$ as ownedByUser, d0 as policy, d1 as raw, d3 as text, d4 as timestamp, d5 as userRef, d6 as uuid, d7 as vector } from '../index-DMZG3kpo.js';
-import './env.js';
+import { P as PreparedRead, c3 as QueryDatabase, U as EnvQueryDatabase, C as CompiledRead, F as ColumnMap, ck as TableHandle, cS as WhereFilter, dx as ColValue, a2 as FindManyOpts } from '../endpoint-DpNUx-ON.js';
+export { q as AnyColumn, r as AtomicDatabase, s as AtomicOptions, y as ColumnBuilder, z as ColumnDef, G as ColumnType, i as CommandOptions, D as DatabaseBudget, d as DatabaseDiagnostics, c as DatabaseDiagnosticsOptions, K as DatabaseQueryEvent, L as DatabaseWorkload, O as EXTENSION_DEPENDENCIES, Q as EmbeddingModelRef, E as EnvServiceDatabase, X as EnvTypedDatabase, a8 as InsertManyOptions, a9 as InsertShape, ae as Materialized, al as OnDeleteAction, an as PALBASE_EXTENSIONS, g as Page, ap as PageInfo, aq as PageInput, ar as PageNavigation, a_ as PalbaseExtension, bX as PolicyBuilder, bY as PolicyCommand, bZ as PolicyDef, c0 as PolicyMode, c2 as QueryColumnContract, c5 as RawConstraintDef, f as RawPageOptions, c7 as Ref, c9 as RowShape, S as SchemaDef, ci as TABLE_META, cj as TableDef, cl as TableInput, T as TransactionIsolation, cn as TxColumnExpr, co as TxInsertShape, cq as TxNow, cr as TxPlan, h as TxPlanBody, cs as TxPlanError, ct as TxPlanHandle, cu as TxPlanOpResult, cv as TxPlanRejection, j as TxPlanResponse, cw as TxRefError, cx as TxRow, cy as TxRows, cz as TxSelectOptions, cA as TxSetShape, cC as TxTable, cD as TxTables, cE as TxWhere, cK as TypedDB, cL as TypedTable, cM as TypedTx, cP as UniqueWhere, cU as WorkloadOptions, cZ as bigint, c_ as boolean, d0 as dec, d3 as defineSchema, d4 as defineTable, d5 as defineWorkload, d6 as enumType, d8 as inc, db as installationRef, dc as integer, dd as isPalbaseExtension, df as jsonb, dg as makeTypedDB, dh as now, dl as openai, dm as ownedByUser, dn as policy, dp as raw, dr as text, ds as timestamp, dt as userRef, du as uuid, dv as vector } from '../endpoint-DpNUx-ON.js';
+import { z } from 'zod';
 import '../stack.js';
-import 'zod';
+import './env.js';
 import 'node:async_hooks';
+
+type QueryRow<C extends ColumnMap> = {
+    [K in keyof C]: ColValue<C[K]>;
+};
+type Database = QueryDatabase | EnvQueryDatabase;
+/** The query IS its response Zod schema, so the existing return-type binder,
+ * OpenAPI generator and clients use the same declaration without a second DTO. */
+type QueryDefinition<Row, Input extends z.ZodTypeAny> = z.ZodArray<z.ZodType<Row>> & {
+    readonly queryName: string;
+    readonly input: Input;
+    prepare(input: z.input<Input>): PreparedRead;
+    run(database: Database, input: z.input<Input>): Promise<Row[]>;
+    sql(database: Database, input: z.input<Input>): CompiledRead;
+    /** Plain EXPLAIN only: never ANALYZE, and always under the caller's RLS identity. */
+    explain(database: Database, input: z.input<Input>): Promise<unknown[]>;
+    contract(): Record<string, unknown>;
+};
+/** Declare a reusable SELECT with an explicit response projection. */
+declare function defineQuery<C extends ColumnMap, const K extends readonly Extract<keyof C, string>[], Input extends z.ZodTypeAny>(name: string, options: {
+    table: TableHandle<C>;
+    input: Input;
+    select: K;
+    where?: (input: z.output<Input>) => WhereFilter<QueryRow<NoInfer<C>>>;
+    orderBy?: FindManyOpts<QueryRow<NoInfer<C>>>["orderBy"];
+    limit?: number | ((input: z.output<Input>) => number);
+    /** Required for jsonb; can also explicitly narrow another response field. */
+    fields?: {
+        [P in K[number]]?: z.ZodType<QueryRow<NoInfer<C>>[P]>;
+    };
+}): QueryDefinition<Pick<QueryRow<C>, K[number]>, Input>;
+declare function queryManifest(queries: readonly {
+    queryName: string;
+    contract(): Record<string, unknown>;
+}[]): Record<string, unknown>;
+/** Commit the manifest; CI compares the generated value before accepting a
+ * changed response. A reviewed baseline update is explicit, never automatic. */
+declare function assertQueryManifest(queries: readonly {
+    queryName: string;
+    contract(): Record<string, unknown>;
+}[], baseline: unknown): void;
+
+export { ColumnMap, CompiledRead, EnvQueryDatabase, PreparedRead, QueryDatabase, type QueryDefinition, TableHandle, assertQueryManifest, defineQuery, queryManifest };

package/dist/db/index.js

@@ -3,13 +3,17 @@ import {
   PALBASE_EXTENSIONS,
   PolicyBuilder,
   TABLE_META,
+  assertQueryManifest,
+  defineQuery,
   defineSchema,
   defineTable,
   isPalbaseExtension,
+  makeTypedDB,
   openai,
   policy,
+  queryManifest,
   raw
-} from "../chunk-YIQ4RS4F.js";
+} from "../chunk-SEM36BWY.js";
 import {
   bigint,
   boolean,
@@ -23,16 +27,17 @@ import {
   userRef,
   uuid,
   vector
-} from "../chunk-XOX6RFPZ.js";
+} from "../chunk-PRH45NZU.js";
 import {
   TxPlanError,
   TxRefError,
   dec,
+  defineWorkload,
   inc,
-  makeTypedDB,
   now
-} from "../chunk-SI4KGEM3.js";
-import "../chunk-KATPXCJ5.js";
+} from "../chunk-FOWA7PF4.js";
+import "../chunk-UMESJJRS.js";
+import "../chunk-VXPNPVAG.js";
 export {
   EXTENSION_DEPENDENCIES,
   PALBASE_EXTENSIONS,
@@ -40,11 +45,14 @@ export {
   TABLE_META,
   TxPlanError,
   TxRefError,
+  assertQueryManifest,
   bigint,
   boolean,
   dec,
+  defineQuery,
   defineSchema,
   defineTable,
+  defineWorkload,
   enumType,
   inc,
   installationRef,
@@ -56,6 +64,7 @@ export {
   openai,
   ownedByUser,
   policy,
+  queryManifest,
   raw,
   text,
   timestamp,