@tailor-platform/sdk 2.32.0 → 2.34.0

package/dist/vitest/migration-steps.d.mts

@@ -1,4 +1,3 @@
-//#region src/vitest/migration-steps.d.ts
 /**
  * Run a multi-step migration script's `steps` in tests the way `tailor deploy`
  * does: in dependency order, each step in its own transaction.
@@ -41,5 +40,4 @@ export declare class MigrationStepError extends Error {
  */
 export declare function runMigrationSteps<Trx, Context extends {
   env: unknown;
-}>(steps: Readonly<Record<string, RunnableMigrationStep<Trx, Context>>>, options: RunMigrationStepsOptions<Trx, Context>): Promise<string[]>;
-//#endregion
+}>(steps: Readonly<Record<string, RunnableMigrationStep<Trx, Context>>>, options: RunMigrationStepsOptions<Trx, Context>): Promise<string[]>;

package/dist/vitest/mock-kysely.d.mts

@@ -1,5 +1,4 @@
 import { Kysely, OperationNode, OperationNodeKind, Transaction } from "kysely";
-//#region src/vitest/mock-kysely.d.ts
 /** A single statement executed against the mock, captured in order. */
 export interface ExecutedQuery {
   /** The Kysely operation node kind, e.g. `"SelectQueryNode"`. */
@@ -57,5 +56,4 @@ export interface KyselyMock<DB> {
  * @returns A {@link KyselyMock} with the mock `db`, recorded queries, and result staging.
  */
 export declare function createKyselyMock<DB = Record<string, never>>(): KyselyMock<DB>;
-//#endregion
 export {};

package/dist/vitest/mocks/aigateway.d.mts

@@ -1,5 +1,4 @@
 import { AIGatewayName } from "@tailor-platform/sdk";
-//#region src/vitest/mocks/aigateway.d.ts
 interface AigatewayCall {
   name: AIGatewayName;
 }
@@ -36,5 +35,4 @@ export declare function mockAigateway(options?: MockAigatewayOptions): {
   clear(): void;
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/authconnection.d.mts

@@ -1,5 +1,4 @@
 import { AuthConnectionTokenResult, ConnectionName } from "@tailor-platform/sdk";
-//#region src/vitest/mocks/authconnection.d.ts
 interface AuthConnectionCall {
   connectionName: ConnectionName;
 }
@@ -34,5 +33,4 @@ export declare function mockAuthconnection(options?: MockAuthconnectionOptions):
   clear(): void;
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/file.d.mts

@@ -1,6 +1,5 @@
 import { FileDownloadAsBase64Response, FileDownloadResponse, FileDownloadStreamResponse, FileMetadata, FileUploadBytes, FileUploadOptions, FileUploadResponse, FileUploadStreamOptions } from "../../runtime/file.mjs";
 import { Mock } from "vitest";
-//#region src/vitest/mocks/file.d.ts
 type FileResolver = (method: string, call: FileCall) => unknown;
 interface FileCall {
   method: string;
@@ -54,5 +53,4 @@ export declare function mockFile(options?: MockFileOptions): {
   uploadStream: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string, readableStream: ReadableStream<Uint8Array | ArrayBuffer>, options?: FileUploadStreamOptions) => Promise<FileUploadResponse>>;
   upload: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string, data: string | FileUploadBytes, options?: Omit<FileUploadOptions, "encoding">) => Promise<FileUploadResponse>>;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/iconv.d.mts

@@ -1,5 +1,4 @@
 import { MockInstance } from "vitest";
-//#region src/vitest/mocks/iconv.d.ts
 type IconvResolver = (method: string, args: unknown[]) => unknown;
 type IconvMethod = "convert" | "convertBuffer" | "decode" | "encode" | "encodings";
 interface IconvCall {
@@ -47,5 +46,4 @@ export declare function mockIconv(options?: MockIconvOptions): {
   clear: () => void;
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/idp.d.mts

@@ -1,6 +1,5 @@
 import { IdpClientConstructor, IdpClientInstance } from "../../runtime/idp.mjs";
 import { Mock } from "vitest";
-//#region src/vitest/mocks/idp.d.ts
 type IdpMethod = keyof IdpClientInstance;
 type IdpResolver = (method: string, args: unknown[], namespace: string) => unknown;
 interface IdpCall {
@@ -57,5 +56,4 @@ export declare function mockIdp(options?: MockIdpOptions): {
   clear(): void;
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/logger.d.mts

@@ -1,5 +1,4 @@
 import { LogAttributes } from "../../runtime/logger.mjs";
-//#region src/vitest/mocks/logger.d.ts
 type LogSeverity = "debug" | "info" | "warn" | "error";
 /** A recorded `debug`/`info`/`warn`/`error` call. */
 interface LogCall {
@@ -41,5 +40,4 @@ export declare function mockLogger(_options?: MockLoggerOptions): {
   clear(): void;
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/secretmanager.d.mts

@@ -1,4 +1,3 @@
-//#region src/vitest/mocks/secretmanager.d.ts
 interface SecretCall {
   method: "getSecret" | "getSecrets";
   vault: string;
@@ -40,5 +39,4 @@ export declare function mockSecretmanager(options?: MockSecretmanagerOptions): {
   clear(): void;
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/tailordb-pglite.d.mts

@@ -1,5 +1,4 @@
 import { PGliteClient } from "../pglite-kysely.mjs";
-//#region src/vitest/mocks/tailordb-pglite.d.ts
 /** A query executed through the PGlite-backed TailorDB client. */
 export interface ExecutedPGliteQuery {
   /** Namespace of the `getDB` call that issued the query. */
@@ -86,5 +85,4 @@ export declare function mockTailordbWithPGlite(options: MockTailordbPGliteOption
    */
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/tailordb.d.mts

@@ -1,4 +1,3 @@
-//#region src/vitest/mocks/tailordb.d.ts
 type QueryResolver = (query: string, params: unknown[]) => unknown[] | undefined;
 /** Controls how unmatched TailorDB queries are handled. */
 export interface MockTailordbOptions {
@@ -111,5 +110,4 @@ export declare function mockTailordb(options?: MockTailordbOptions): {
   /** Reset query responses and recorded calls (keeps the mock installed). */
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/mocks/workflow.d.mts

@@ -4,7 +4,6 @@ import { WorkflowJob } from "../../configure/services/workflow/job.mjs";
 import { Workflow } from "../../configure/services/workflow/workflow.mjs";
 import { ParameterizedWaitPointInstance, WaitPointInstance } from "../../configure/services/workflow/wait-point.mjs";
 import { Mock } from "vitest";
-//#region src/vitest/mocks/workflow.d.ts
 type JobHandler = (jobName: string, args: unknown, options?: ExecJobFunctionOptions) => unknown;
 type StartHandlerFn = (workflowName: string, args: unknown, options?: StartWorkflowOptions) => string;
 type ResumeHandlerFn = (executionId: string) => string;
@@ -157,5 +156,4 @@ export declare function mockWorkflow(): {
   /** Reset all workflow responses and recorded calls (keeps the mock installed). */
   reset(): void;
 } & Disposable;
-//#endregion
 export {};

package/dist/vitest/pglite-kysely.d.mts

@@ -1,6 +1,5 @@
 import { PGliteField } from "./pglite-temporal.mjs";
 import { ColumnType, Kysely } from "kysely";
-//#region src/vitest/pglite-kysely.d.ts
 /** Result of a {@link PGliteClient.query} call. */
 export interface PGliteQueryResult {
   /** Rows returned by the statement. */
@@ -82,5 +81,23 @@ export interface CreateKyselyPGliteOptions {
  * ```
  */
 export declare function createKyselyPGlite<DB = Record<string, never>>(client: PGliteClient, options?: CreateKyselyPGliteOptions): Kysely<DB>;
-//#endregion
+/**
+ * Run `prepare` with relations unchecked, so a test can stage rows that predate a relation (for
+ * example rows whose parent does not exist, which the migration under test repairs). The setting
+ * from before the first call is restored when the last `prepareFixtures` on the client returns or
+ * throws, so the script under test still runs against checked relations, and calls that are nested
+ * or overlap keep relations unchecked until all of them are done. NOT NULL, UNIQUE, and CHECK
+ * constraints stay enforced.
+ * @param client - The PGlite instance the rows are written to
+ * @param prepare - Writes the rows, for example with the Kysely instance of the same client
+ * @returns Whatever `prepare` returns
+ * @example
+ * ```typescript
+ * await prepareFixtures(pglite, async () => {
+ *   await db.insertInto("Order").values([{ ownerID: crypto.randomUUID() }]).execute();
+ * });
+ * await db.transaction().execute((trx) => main(trx));
+ * ```
+ */
+export declare function prepareFixtures<T>(client: PGliteClient, prepare: () => Promise<T>): Promise<T>;
 export {};

package/dist/vitest/pglite-temporal.d.mts

@@ -1,9 +1,7 @@
-//#region src/vitest/pglite-temporal.d.ts
 /** Name and Postgres type OID of a column PGlite returned. */
 export interface PGliteField {
   /** Column name */
   name: string;
   /** Postgres type OID */
   dataTypeID: number;
-}
-//#endregion
+}

package/dist/vitest/setup.d.mts

@@ -1,5 +1,4 @@
 import { applyDateDefault } from "./date-representation.mjs";
-//#region src/vitest/setup.d.ts
 /**
  * Extract a vault store from a secrets-shaped value.
  *
@@ -22,5 +21,4 @@ export declare function extractVaultStore(secrets: unknown): Record<string, Reco
  * @returns Vault store keyed by vault name, or null if unavailable
  */
 export declare function loadSecretsFromConfig(configPath: string): Promise<Record<string, Record<string, string>> | null>;
-//#endregion
 export { applyDateDefault };

package/dist/vitest/workflow-local.d.mts

@@ -2,7 +2,6 @@ import { TailorEnv } from "../runtime/types.mjs";
 import { WorkflowJob } from "../configure/services/workflow/job.mjs";
 import { Workflow } from "../configure/services/workflow/workflow.mjs";
 import "../configure/services/workflow/index.mjs";
-//#region src/vitest/workflow-local.d.ts
 type AnyWorkflowJob = WorkflowJob<string, any, any>;
 type AnyWorkflow = Workflow<AnyWorkflowJob>;
 type WorkflowInput<W extends AnyWorkflow> = W["mainJob"] extends WorkflowJob<string, infer I, any> ? I : never;
@@ -37,5 +36,4 @@ export declare function runWorkflowLocally<W extends Workflow<WorkflowJob<string
  * @returns The main job output
  */
 export declare function runWorkflowLocally<W extends AnyWorkflow>(workflow: W, args: WorkflowInput<W>, options?: RunWorkflowLocallyOptions): Promise<WorkflowOutput<W>>;
-//#endregion
 export {};