@domino-sdk/relay 1.1.0 → 1.2.0

package/dist/server/index.d.ts

@@ -3,8 +3,8 @@ import { O as OpenIdentityKind, a1 as TrackerDataSchema, a9 as TrackerQuery, bV
 export { aS as entitlementSchema, b4 as memberIdentitySchema } from '../schema-DfJzH2ci.js';
 import { z } from 'zod';
 import { r as collectionBeginSchema, z as counterHistoryQuerySchema, E as counterModerationSchema, o as automaticSchedulingQuerySchema, p as automaticSchedulingRetrySchema, l as automaticOutcomeQuerySchema, g as automaticCatchUpInputSchema, f as automaticCatchUpConfirmSchema } from '../automatic-outcomes-B1xrETxm.js';
-import { n as projectDeploymentSchema, q as publishDeploymentSchema, v as submitDeploymentSchema, t as rejectDeploymentSchema, o as promoteDeploymentSchema, u as rollbackDeploymentSchema, k as projectCalendarInputSchema } from '../activity-B8k9Sa_a.js';
-export { c as activityTypeSchema, d as activityTypes } from '../activity-B8k9Sa_a.js';
+import { n as projectDeploymentSchema, q as publishDeploymentSchema, v as submitDeploymentSchema, t as rejectDeploymentSchema, o as promoteDeploymentSchema, u as rollbackDeploymentSchema, k as projectCalendarInputSchema } from '../activity-o1E-Hqyt.js';
+export { c as activityTypeSchema, d as activityTypes } from '../activity-o1E-Hqyt.js';
 import { O as engagementChangePreviewInputSchema, S as engagementChangeSchema, a1 as engagementVersionQuerySchema, V as engagementPageQuerySchema, X as engagementPublishSchema, ax as pointLedgerSchema, aA as pointsMutationSchema, aK as referralControlSchema, ac as leaderboardQuerySchema, a5 as leaderboardExclusionSchema, p as ProjectGroupReference, a6 as leaderboardGroupSchema, am as memberCampaignEnrollmentInputSchema, an as memberCampaignWithdrawalInputSchema, F as createPointLedgerSchema, ae as leaderboardSettlementApprovalSchema } from '../groups-Ck-OxzjD.js';
 import { h as offerControlSchema, m as redemptionCancellationSchema } from '../offers-Cy-e4o5x.js';
 import { C as profileSettingsInputSchema, z as profileModerationSchema } from '../profiles-D2aFcOxu.js';
@@ -369,6 +369,11 @@ declare const appRoutingSchema: z.ZodDefault<z.ZodEnum<{
 }>>;
 /** Most app secrets a project environment can hold. */
 declare const APP_SECRET_LIMIT = 50;
+declare const APP_KV_LIMIT = 5;
+declare const APP_SQL_LIMIT = 5;
+declare const APP_MIGRATION_LIMIT = 100;
+declare const APP_MIGRATION_FILE_BYTES = 90000;
+declare const APP_MIGRATION_TOTAL_BYTES = 1000000;
 /**
  * An app secret's name: the Worker binding it becomes. `DOMINO_` names and `ASSETS` are the
  * platform's own bindings.
@@ -423,6 +428,84 @@ declare const hostedAppSecretsSchema: z.ZodObject<{
     secrets: z.ZodRecord<z.ZodString, z.ZodString>;
 }, z.core.$strict>;
 type HostedAppSecrets = z.infer<typeof hostedAppSecretsSchema>;
+declare const appStorageSchema: z.ZodObject<{
+    kv: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+    }, z.core.$strict>>>;
+    sql: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        migrations: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+type AppStorage = z.infer<typeof appStorageSchema>;
+declare const appStorageKindSchema: z.ZodEnum<{
+    kv: "kv";
+    sql: "sql";
+}>;
+type AppStorageKind = z.infer<typeof appStorageKindSchema>;
+declare const appStorageListSchema: z.ZodObject<{
+    stores: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        createdAt: z.ZodNullable<z.ZodNumber>;
+        declared: z.ZodBoolean;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type AppStorageList = z.infer<typeof appStorageListSchema>;
+/** Rows per page when browsing a SQL store's table. */
+declare const APP_STORAGE_ROW_LIMIT = 50;
+/** Longest text a browsed cell or KV value shows; longer values end in `truncated`. */
+declare const APP_STORAGE_PREVIEW_CHARACTERS = 2000;
+/**
+ * A browsed SQL value. Text longer than the preview is cut and flagged; a BLOB shows only its
+ * size in bytes.
+ */
+declare const appStorageCellSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull, z.ZodObject<{
+    text: z.ZodString;
+    truncated: z.ZodLiteral<true>;
+}, z.core.$strip>, z.ZodObject<{
+    blob: z.ZodNumber;
+}, z.core.$strip>]>;
+type AppStorageCell = z.infer<typeof appStorageCellSchema>;
+declare const appStorageTablesSchema: z.ZodObject<{
+    tables: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type AppStorageTables = z.infer<typeof appStorageTablesSchema>;
+declare const appStorageRowsSchema: z.ZodObject<{
+    table: z.ZodString;
+    columns: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull, z.ZodObject<{
+        text: z.ZodString;
+        truncated: z.ZodLiteral<true>;
+    }, z.core.$strip>, z.ZodObject<{
+        blob: z.ZodNumber;
+    }, z.core.$strip>]>>>;
+    offset: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+type AppStorageRows = z.infer<typeof appStorageRowsSchema>;
+declare const appStorageKeysSchema: z.ZodObject<{
+    keys: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        expiration: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type AppStorageKeys = z.infer<typeof appStorageKeysSchema>;
+declare const appStorageValueSchema: z.ZodObject<{
+    key: z.ZodString;
+    size: z.ZodNumber;
+    text: z.ZodNullable<z.ZodString>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+type AppStorageValue = z.infer<typeof appStorageValueSchema>;
+declare const appMigrationNameSchema: z.ZodString;
+/** Wrangler compares the leading number first, then the filename (workers-sdk d1/migrations/helpers.ts). */
+declare function compareAppMigrations(a: string, b: string): number;
 declare const hostedAppSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     routing: z.ZodDefault<z.ZodEnum<{
         legacy: "legacy";
@@ -443,6 +526,15 @@ declare const hostedAppSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         description: z.ZodString;
         required: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>>;
+    storage: z.ZodOptional<z.ZodObject<{
+        kv: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodString;
+        }, z.core.$strict>>>;
+        sql: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodString;
+            migrations: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
     routing: z.ZodDefault<z.ZodEnum<{
         legacy: "legacy";
         transparent: "transparent";
@@ -802,6 +894,10 @@ declare const buildArtifactsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         transparent: "transparent";
     }>>;
     worker: z.ZodOptional<z.ZodObject<{
+        migrations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            sql: z.ZodString;
+        }, z.core.$strict>>>>;
         modules: z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             type: z.ZodEnum<{
@@ -821,6 +917,15 @@ declare const buildArtifactsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             description: z.ZodString;
             required: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>>;
+        storage: z.ZodOptional<z.ZodObject<{
+            kv: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            sql: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodString;
+                migrations: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     assets: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
@@ -846,6 +951,10 @@ declare const buildArtifactsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         transparent: "transparent";
     }>>;
     worker: z.ZodOptional<z.ZodObject<{
+        migrations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            sql: z.ZodString;
+        }, z.core.$strict>>>>;
         modules: z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             type: z.ZodEnum<{
@@ -865,6 +974,15 @@ declare const buildArtifactsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             description: z.ZodString;
             required: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>>;
+        storage: z.ZodOptional<z.ZodObject<{
+            kv: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            sql: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodString;
+                migrations: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     assets: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
@@ -39248,6 +39366,54 @@ declare function hostedManagementClient(env: HostedManagementEnv): {
         }>;
         delete: (name: string, call?: ManagementCallOptions) => Promise<void>;
     };
+    storage: {
+        list: (call?: ManagementCallOptions) => Promise<{
+            stores: {
+                kind: string;
+                name: string;
+                createdAt: number | null;
+                declared: boolean;
+                description?: string | undefined;
+            }[];
+        }>;
+        tables: (name: string, call?: ManagementCallOptions) => Promise<{
+            tables: {
+                name: string;
+                kind: string;
+            }[];
+        }>;
+        rows: (name: string, table: string, options?: {
+            offset?: number;
+        }, call?: ManagementCallOptions) => Promise<{
+            table: string;
+            columns: string[];
+            rows: (string | number | {
+                text: string;
+                truncated: true;
+            } | {
+                blob: number;
+            } | null)[][];
+            offset: number;
+            total: number;
+        }>;
+        keys: (name: string, options?: {
+            prefix?: string;
+            cursor?: string;
+        }, call?: ManagementCallOptions) => Promise<{
+            keys: {
+                name: string;
+                expiration: number | null;
+            }[];
+            cursor: string | null;
+        }>;
+        value: (name: string, key: string, call?: ManagementCallOptions) => Promise<{
+            key: string;
+            size: number;
+            text: string | null;
+            truncated: boolean;
+        }>;
+        delete: (kind: AppStorageKind, name: string, call?: ManagementCallOptions) => Promise<void>;
+    };
     walletBalanceChains: (call?: ManagementCallOptions) => Promise<{
         chains: {
             chain: `cosmos:${string}` | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" | `eip155:${number}`;
@@ -42712,8 +42878,9 @@ type ManagementClientOptions = {
 type ManagementRawInit = RequestInit & {
     timeout?: number;
 };
-type ManagementClient = Omit<ReturnType<typeof createManagementClient>, "testMembers"> & {
+type ManagementClient = Omit<ReturnType<typeof createManagementClient>, "testMembers" | "storage"> & {
     testMembers?: ReturnType<typeof createManagementClient>["testMembers"];
+    storage?: ReturnType<typeof createManagementClient>["storage"];
 };
 declare function createManagementClient(options: ManagementClientOptions): {
     raw: (path: string, init?: ManagementRawInit) => Promise<Response>;
@@ -80983,6 +81150,64 @@ declare function createManagementClient(options: ManagementClientOptions): {
         }>;
         delete: (name: string, call?: ManagementCallOptions) => Promise<void>;
     };
+    /**
+     * The hosted app's KV and SQL stores in test. `list` needs `read`; reading their contents and
+     * deleting a store need `publish`. Reads never change data, and only a store no serving build
+     * declares can be deleted.
+     */
+    storage: {
+        list: (call?: ManagementCallOptions) => Promise<{
+            stores: {
+                kind: string;
+                name: string;
+                createdAt: number | null;
+                declared: boolean;
+                description?: string | undefined;
+            }[];
+        }>;
+        /** A SQL store's tables and views, without SQLite's and D1's own. */
+        tables: (name: string, call?: ManagementCallOptions) => Promise<{
+            tables: {
+                name: string;
+                kind: string;
+            }[];
+        }>;
+        /** One page of 50 rows in the table's storage order, which rows changing in between can shift. */
+        rows: (name: string, table: string, options?: {
+            offset?: number;
+        }, call?: ManagementCallOptions) => Promise<{
+            table: string;
+            columns: string[];
+            rows: (string | number | {
+                text: string;
+                truncated: true;
+            } | {
+                blob: number;
+            } | null)[][];
+            offset: number;
+            total: number;
+        }>;
+        /** One page of a KV store's keys; pass the returned `cursor` for the next. */
+        keys: (name: string, options?: {
+            prefix?: string;
+            cursor?: string;
+        }, call?: ManagementCallOptions) => Promise<{
+            keys: {
+                name: string;
+                expiration: number | null;
+            }[];
+            cursor: string | null;
+        }>;
+        /** A KV value's size and, when it is UTF-8 text, a preview. */
+        value: (name: string, key: string, call?: ManagementCallOptions) => Promise<{
+            key: string;
+            size: number;
+            text: string | null;
+            truncated: boolean;
+        }>;
+        /** Deletes a store no serving build declares, with all of its data. */
+        delete: (kind: AppStorageKind, name: string, call?: ManagementCallOptions) => Promise<void>;
+    };
     /**
      * The chains quest code can read token balances on with `ctx.wallet.balance()`, with their
      * names; requires `read` permission. Any other chain fails the evaluation.
@@ -81719,4 +81944,4 @@ declare function createManagementClient(options: ManagementClientOptions): {
     }>;
 };
 
-export { APP_SECRET_LIMIT, type Access, type AppSecret, type AppSecretDeclaration, type AppSecretInput, type AppSecretList, type AuditRecord, type BalanceCheck, type BuildArtifacts, type BuildIdentity, type BuildSnapshot, type BuildStatus, type CompletionRevocation, type CompletionRevokeInput, DEFAULT_MANAGEMENT_TIMEOUT, type HostedAppSecrets, type HostedBuild, type HostedDeploymentKey, type HostedKey, type HostedKeyPermission, type HostedManagementEnv, type ListQuery, type ManagedMemberIdentity, type ManagedOAuthAccount, type ManagedResource, type ManagedWallet, type ManagementCallOptions, type ManagementClient, type ManagementClientOptions, ManagementError, ManagementErrorCode, type ManagementErrorInit, type ManagementErrorKind, type ManagementPage, type ManagementRawInit, type ParticipantSignIn, type ParticipantSignInInput, type Permission, type Person, type Project, type QuestLifecycle, type QuestLifecycleInput, type ResourceLifecycleInput, RevokedDeliveryOutcome, RevokedEntitlementOutcome, RevokedReferralOutcome, type StagedDeployment, type StagedDeploymentContent, type StagingAccess, type StagingAccessInput, type StagingLink, type StarterId, type StarterTemplate, type TestMember, type TestMemberActionInput, type TestMemberCreateInput, type TestMemberResetInput, type TestMemberResetResult, WEBHOOK_MAX_BYTES, type WalletBalanceChains, type WebhookEvent, accessSchema, accountProfileSchema, appRoutingSchema, appSecretDeclarationSchema, appSecretDeclarationsSchema, appSecretInputSchema, appSecretListSchema, appSecretNameSchema, appSecretSchema, appSecretValueSchema, assetPathSchema, auditRecordSchema, balanceCheckSchema, buildArtifactsSchema, buildIdentitySchema, buildPhaseSchema, buildSnapshotSchema, buildStatusSchema, commitSchema, completionRevocationSchema, completionRevokeSchema, createManagementClient, createRepositorySchema, developmentPreflightSchema, deviceApproveSchema, deviceRedeemSchema, deviceStartSchema, entitlementCorrectionSchema, environmentSchema, grantRecordSchema, grantSchema, hostedAppSchema, hostedAppSecretsSchema, hostedBuildSchema, hostedDeploymentKeySchema, hostedKeyPermissions, hostedKeySchema, hostedKeySecretSchema, hostedManagementBindings, hostedManagementClient, ingestTrackerScopeSchema, inventorySchema, isManagementError, issuedTokenSchema, managedMemberIdentitySchema, managedOAuthAccountSchema, managedResourceSchema, managedWalletSchema, memberAccountSchema, memberDetailSchema, memberIdentityChangeInputSchema, memberLookupSchema, memberOAuthUnlinkInputSchema, memberSchema, memberWalletSignInInputSchema, memberWalletUnlinkInputSchema, metricsSchema, operationInputSchema, operationSchema, pageSchema, participantSignInInputSchema, participantSignInSchema, permissionSchema, personSchema, projectDeletionInputSchema, projectDeletionSchema, projectInputSchema, projectSchema, projectSetupSchema, projectTransferInputSchema, projectTransferSchema, querySchema, questLifecycleInputSchema, questLifecycleSchema, readinessSchema, repositorySchema, resourceLifecycleInputSchema, resourceLifecycleKindSchema, resourceLifecycleResultSchema, rolePermissions, roleSchema, stageRequestSchema, stagedDeploymentContentSchema, stagedDeploymentKey, stagedDeploymentLimits, stagedDeploymentSchema, stagingAccessInputSchema, stagingAccessModeSchema, stagingAccessSchema, stagingLinkSchema, stagingPathSchema, starterIdSchema, starterTemplates, stockAdditionSchema, stockInputSchema, teamSchema, testMemberActionSchema, testMemberCreateSchema, testMemberResetResultSchema, testMemberResetSchema, testMemberSchema, tokenInputSchema, tokenSchema, tokenScopeInputSchema, verifiedPassSchema, verifyWebhook, walletBalanceChainsSchema, webhookDeliveryPageSchema, webhookDeliverySchema, webhookEndpointSchema, webhookEventSchema, webhookInputSchema, webhookQuerySchema, webhookSecretSchema, webhookUpdateSchema };
+export { APP_KV_LIMIT, APP_MIGRATION_FILE_BYTES, APP_MIGRATION_LIMIT, APP_MIGRATION_TOTAL_BYTES, APP_SECRET_LIMIT, APP_SQL_LIMIT, APP_STORAGE_PREVIEW_CHARACTERS, APP_STORAGE_ROW_LIMIT, type Access, type AppSecret, type AppSecretDeclaration, type AppSecretInput, type AppSecretList, type AppStorage, type AppStorageCell, type AppStorageKeys, type AppStorageKind, type AppStorageList, type AppStorageRows, type AppStorageTables, type AppStorageValue, type AuditRecord, type BalanceCheck, type BuildArtifacts, type BuildIdentity, type BuildSnapshot, type BuildStatus, type CompletionRevocation, type CompletionRevokeInput, DEFAULT_MANAGEMENT_TIMEOUT, type HostedAppSecrets, type HostedBuild, type HostedDeploymentKey, type HostedKey, type HostedKeyPermission, type HostedManagementEnv, type ListQuery, type ManagedMemberIdentity, type ManagedOAuthAccount, type ManagedResource, type ManagedWallet, type ManagementCallOptions, type ManagementClient, type ManagementClientOptions, ManagementError, ManagementErrorCode, type ManagementErrorInit, type ManagementErrorKind, type ManagementPage, type ManagementRawInit, type ParticipantSignIn, type ParticipantSignInInput, type Permission, type Person, type Project, type QuestLifecycle, type QuestLifecycleInput, type ResourceLifecycleInput, RevokedDeliveryOutcome, RevokedEntitlementOutcome, RevokedReferralOutcome, type StagedDeployment, type StagedDeploymentContent, type StagingAccess, type StagingAccessInput, type StagingLink, type StarterId, type StarterTemplate, type TestMember, type TestMemberActionInput, type TestMemberCreateInput, type TestMemberResetInput, type TestMemberResetResult, WEBHOOK_MAX_BYTES, type WalletBalanceChains, type WebhookEvent, accessSchema, accountProfileSchema, appMigrationNameSchema, appRoutingSchema, appSecretDeclarationSchema, appSecretDeclarationsSchema, appSecretInputSchema, appSecretListSchema, appSecretNameSchema, appSecretSchema, appSecretValueSchema, appStorageCellSchema, appStorageKeysSchema, appStorageKindSchema, appStorageListSchema, appStorageRowsSchema, appStorageSchema, appStorageTablesSchema, appStorageValueSchema, assetPathSchema, auditRecordSchema, balanceCheckSchema, buildArtifactsSchema, buildIdentitySchema, buildPhaseSchema, buildSnapshotSchema, buildStatusSchema, commitSchema, compareAppMigrations, completionRevocationSchema, completionRevokeSchema, createManagementClient, createRepositorySchema, developmentPreflightSchema, deviceApproveSchema, deviceRedeemSchema, deviceStartSchema, entitlementCorrectionSchema, environmentSchema, grantRecordSchema, grantSchema, hostedAppSchema, hostedAppSecretsSchema, hostedBuildSchema, hostedDeploymentKeySchema, hostedKeyPermissions, hostedKeySchema, hostedKeySecretSchema, hostedManagementBindings, hostedManagementClient, ingestTrackerScopeSchema, inventorySchema, isManagementError, issuedTokenSchema, managedMemberIdentitySchema, managedOAuthAccountSchema, managedResourceSchema, managedWalletSchema, memberAccountSchema, memberDetailSchema, memberIdentityChangeInputSchema, memberLookupSchema, memberOAuthUnlinkInputSchema, memberSchema, memberWalletSignInInputSchema, memberWalletUnlinkInputSchema, metricsSchema, operationInputSchema, operationSchema, pageSchema, participantSignInInputSchema, participantSignInSchema, permissionSchema, personSchema, projectDeletionInputSchema, projectDeletionSchema, projectInputSchema, projectSchema, projectSetupSchema, projectTransferInputSchema, projectTransferSchema, querySchema, questLifecycleInputSchema, questLifecycleSchema, readinessSchema, repositorySchema, resourceLifecycleInputSchema, resourceLifecycleKindSchema, resourceLifecycleResultSchema, rolePermissions, roleSchema, stageRequestSchema, stagedDeploymentContentSchema, stagedDeploymentKey, stagedDeploymentLimits, stagedDeploymentSchema, stagingAccessInputSchema, stagingAccessModeSchema, stagingAccessSchema, stagingLinkSchema, stagingPathSchema, starterIdSchema, starterTemplates, stockAdditionSchema, stockInputSchema, teamSchema, testMemberActionSchema, testMemberCreateSchema, testMemberResetResultSchema, testMemberResetSchema, testMemberSchema, tokenInputSchema, tokenSchema, tokenScopeInputSchema, verifiedPassSchema, verifyWebhook, walletBalanceChainsSchema, webhookDeliveryPageSchema, webhookDeliverySchema, webhookEndpointSchema, webhookEventSchema, webhookInputSchema, webhookQuerySchema, webhookSecretSchema, webhookUpdateSchema };

package/dist/server/index.js

@@ -421,6 +421,11 @@ var outputPathSchema = z5.string().min(1).max(512).refine(
 );
 var appRoutingSchema = z5.enum(["legacy", "transparent"]).default("legacy");
 var APP_SECRET_LIMIT = 50;
+var APP_KV_LIMIT = 5;
+var APP_SQL_LIMIT = 5;
+var APP_MIGRATION_LIMIT = 100;
+var APP_MIGRATION_FILE_BYTES = 9e4;
+var APP_MIGRATION_TOTAL_BYTES = 1e6;
 var appSecretNameSchema = z5.string().regex(
   /^[A-Z_][A-Z0-9_]{0,63}$/,
   "Use 1-64 uppercase letters, digits, and underscores, not starting with a digit"
@@ -451,6 +456,110 @@ var appSecretListSchema = z5.object({
   declared: z5.array(appSecretDeclarationSchema.extend({ name: appSecretNameSchema })).default([])
 });
 var hostedAppSecretsSchema = z5.object({ secrets: z5.record(appSecretNameSchema, appSecretValueSchema) }).strict();
+var storageDescription = z5.object({
+  description: z5.string().trim().min(1).max(500)
+}).strict();
+var appStorageSchema = z5.object({
+  kv: z5.record(appSecretNameSchema, storageDescription).refine(
+    (stores) => Object.keys(stores).length <= APP_KV_LIMIT,
+    `Declare at most ${APP_KV_LIMIT} KV stores`
+  ).default({}),
+  sql: z5.record(
+    appSecretNameSchema,
+    storageDescription.extend({
+      migrations: outputPathSchema.optional()
+    }).strict()
+  ).refine(
+    (stores) => Object.keys(stores).length <= APP_SQL_LIMIT,
+    `Declare at most ${APP_SQL_LIMIT} SQL stores`
+  ).default({})
+}).strict();
+var appStorageKindSchema = z5.enum(["kv", "sql"]);
+var appStorageListSchema = z5.object({
+  stores: z5.array(
+    z5.object({
+      kind: z5.string(),
+      name: appSecretNameSchema,
+      createdAt: z5.number().nullable(),
+      declared: z5.boolean(),
+      description: z5.string().optional()
+    })
+  )
+});
+var APP_STORAGE_ROW_LIMIT = 50;
+var APP_STORAGE_PREVIEW_CHARACTERS = 2e3;
+var appStorageCellSchema = z5.union([
+  z5.string(),
+  z5.number(),
+  z5.null(),
+  z5.object({ text: z5.string(), truncated: z5.literal(true) }),
+  z5.object({ blob: z5.number().int().min(0) })
+]);
+var appStorageTablesSchema = z5.object({
+  tables: z5.array(
+    /** `kind` is SQLite's: `table` or `view`. */
+    z5.object({ name: z5.string(), kind: z5.string() })
+  )
+});
+var appStorageRowsSchema = z5.object({
+  table: z5.string(),
+  columns: z5.array(z5.string()),
+  rows: z5.array(z5.array(appStorageCellSchema)),
+  offset: z5.number().int().min(0),
+  total: z5.number().int().min(0)
+});
+var appStorageKeysSchema = z5.object({
+  keys: z5.array(
+    z5.object({ name: z5.string(), expiration: z5.number().nullable() })
+  ),
+  /** Pass back to read the next page; null on the last one. */
+  cursor: z5.string().nullable()
+});
+var appStorageValueSchema = z5.object({
+  key: z5.string(),
+  size: z5.number().int().min(0),
+  /** Null when the value is not UTF-8 text. */
+  text: z5.string().nullable(),
+  truncated: z5.boolean()
+});
+var appMigrationNameSchema = z5.string().max(255).regex(/^[\w-][\w.-]*\.sql$/);
+function compareAppMigrations(a, b) {
+  const left = Number.parseInt(a.split("_")[0], 10);
+  const right = Number.parseInt(b.split("_")[0], 10);
+  if (left !== right) {
+    if (Number.isFinite(left) && Number.isFinite(right)) {
+      return left - right;
+    }
+    if (Number.isFinite(left)) {
+      return -1;
+    }
+    if (Number.isFinite(right)) {
+      return 1;
+    }
+  }
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+var appMigrationsSchema = z5.record(
+  appSecretNameSchema,
+  z5.array(
+    z5.object({
+      name: appMigrationNameSchema,
+      sql: z5.string().min(1).refine(
+        (sql) => new TextEncoder().encode(sql).length <= APP_MIGRATION_FILE_BYTES,
+        `A migration file must not exceed ${APP_MIGRATION_FILE_BYTES} bytes`
+      )
+    }).strict()
+  ).max(APP_MIGRATION_LIMIT).refine(
+    (files) => new Set(files.map((file) => file.name)).size === files.length,
+    "Duplicate migration filenames"
+  )
+).refine(
+  (stores) => Object.values(stores).flat().reduce(
+    (total, file) => total + new TextEncoder().encode(file.sql).length,
+    0
+  ) <= APP_MIGRATION_TOTAL_BYTES,
+  `Migrations must not exceed ${APP_MIGRATION_TOTAL_BYTES} bytes in total`
+);
 var appScripts = {
   routing: appRoutingSchema,
   devScript: z5.string().regex(/^[\w:-]+$/),
@@ -469,12 +578,31 @@ var workerSettings = {
     z5.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).refine((name) => name !== "ASSETS"),
     z5.string()
   ).default({}),
-  secrets: appSecretDeclarationsSchema.default({})
+  secrets: appSecretDeclarationsSchema.default({}),
+  storage: appStorageSchema.optional()
 };
-var distinctBindings = (worker) => !Object.keys(worker.secrets).some((name) => name in worker.vars);
-var distinctBindingsMessage = {
-  message: "A name can't be both an app var and a declared secret",
-  path: ["secrets"]
+var distinctBindings = (worker, ctx) => {
+  const owners = /* @__PURE__ */ new Map();
+  const sources = [
+    ["vars", "an app var", Object.keys(worker.vars)],
+    ["secrets", "a declared secret", Object.keys(worker.secrets)],
+    ["storage", "a KV store", Object.keys(worker.storage?.kv ?? {})],
+    ["storage", "a SQL store", Object.keys(worker.storage?.sql ?? {})]
+  ];
+  for (const [path, owner, names] of sources) {
+    for (const name of names) {
+      const first = owners.get(name);
+      if (first) {
+        ctx.addIssue({
+          code: "custom",
+          message: `Binding name ${name} is used by both ${first} and ${owner}`,
+          path: [path]
+        });
+      } else {
+        owners.set(name, owner);
+      }
+    }
+  }
 };
 var hostedAppSchema = z5.discriminatedUnion("kind", [
   z5.object({
@@ -488,7 +616,7 @@ var hostedAppSchema = z5.discriminatedUnion("kind", [
     assetsDirectory: outputPathSchema.optional(),
     ...appScripts,
     ...workerSettings
-  }).strict().refine(distinctBindings, distinctBindingsMessage)
+  }).strict().superRefine(distinctBindings)
 ]);
 var repositorySchema = z5.object({
   id: z5.string().uuid(),
@@ -602,6 +730,7 @@ var artifactFields = {
   routing: appRoutingSchema,
   worker: z5.object({
     ...workerSettings,
+    migrations: appMigrationsSchema.optional(),
     modules: z5.array(
       z5.object({
         path: outputPathSchema.refine((path) => path !== "metadata"),
@@ -614,7 +743,7 @@ var artifactFields = {
         content: base64Schema.max(14e6)
       }).strict()
     ).min(1).max(500)
-  }).strict().refine(distinctBindings, distinctBindingsMessage).optional(),
+  }).strict().superRefine(distinctBindings).optional(),
   assets: z5.array(
     z5.object({
       path: assetPathSchema,
@@ -639,6 +768,14 @@ var buildArtifactsSchema = z5.discriminatedUnion("format", [
 ]).superRefine((value, ctx) => {
   if (value.worker) {
     const modules = value.worker.modules;
+    for (const name of Object.keys(value.worker.migrations ?? {})) {
+      if (!value.worker.storage?.sql[name]?.migrations) {
+        ctx.addIssue({
+          code: "custom",
+          message: `Migrations for undeclared SQL store ${name}`
+        });
+      }
+    }
     if (new Set(modules.map((m) => m.path)).size !== modules.length) {
       ctx.addIssue({
         code: "custom",
@@ -2270,6 +2407,49 @@ function createManagementClient(options) {
         });
       }
     },
+    /**
+     * The hosted app's KV and SQL stores in test. `list` needs `read`; reading their contents and
+     * deleting a store need `publish`. Reads never change data, and only a store no serving build
+     * declares can be deleted.
+     */
+    storage: {
+      list: (call) => get("/storage", appStorageListSchema, call),
+      /** A SQL store's tables and views, without SQLite's and D1's own. */
+      tables: (name, call) => get(
+        `/storage/sql/${appSecretNameSchema.parse(name)}/tables`,
+        appStorageTablesSchema,
+        call
+      ),
+      /** One page of 50 rows in the table's storage order, which rows changing in between can shift. */
+      rows: (name, table, options2 = {}, call) => get(
+        `/storage/sql/${appSecretNameSchema.parse(name)}/rows?${new URLSearchParams({ table, offset: String(options2.offset ?? 0) })}`,
+        appStorageRowsSchema,
+        call
+      ),
+      /** One page of a KV store's keys; pass the returned `cursor` for the next. */
+      keys: (name, options2 = {}, call) => get(
+        `/storage/kv/${appSecretNameSchema.parse(name)}/keys?${new URLSearchParams(
+          Object.entries(options2).filter(
+            (entry) => entry[1] !== void 0
+          )
+        )}`,
+        appStorageKeysSchema,
+        call
+      ),
+      /** A KV value's size and, when it is UTF-8 text, a preview. */
+      value: (name, key, call) => get(
+        `/storage/kv/${appSecretNameSchema.parse(name)}/value?${new URLSearchParams({ key })}`,
+        appStorageValueSchema,
+        call
+      ),
+      /** Deletes a store no serving build declares, with all of its data. */
+      delete: async (kind, name, call) => {
+        await raw(`/storage/${kind}/${appSecretNameSchema.parse(name)}`, {
+          ...call,
+          method: "DELETE"
+        });
+      }
+    },
     /**
      * The chains quest code can read token balances on with `ctx.wallet.balance()`, with their
      * names; requires `read` permission. Any other chain fails the evaluation.
@@ -2437,7 +2617,14 @@ function createManagementClient(options) {
   });
 }
 export {
+  APP_KV_LIMIT,
+  APP_MIGRATION_FILE_BYTES,
+  APP_MIGRATION_LIMIT,
+  APP_MIGRATION_TOTAL_BYTES,
   APP_SECRET_LIMIT,
+  APP_SQL_LIMIT,
+  APP_STORAGE_PREVIEW_CHARACTERS,
+  APP_STORAGE_ROW_LIMIT,
   DEFAULT_MANAGEMENT_TIMEOUT,
   ManagementError,
   ManagementErrorCode,
@@ -2449,6 +2636,7 @@ export {
   accountProfileSchema,
   activityTypeSchema,
   activityTypes,
+  appMigrationNameSchema,
   appRoutingSchema,
   appSecretDeclarationSchema,
   appSecretDeclarationsSchema,
@@ -2457,6 +2645,14 @@ export {
   appSecretNameSchema,
   appSecretSchema,
   appSecretValueSchema,
+  appStorageCellSchema,
+  appStorageKeysSchema,
+  appStorageKindSchema,
+  appStorageListSchema,
+  appStorageRowsSchema,
+  appStorageSchema,
+  appStorageTablesSchema,
+  appStorageValueSchema,
   assetPathSchema,
   auditRecordSchema,
   balanceCheckSchema,
@@ -2466,6 +2662,7 @@ export {
   buildSnapshotSchema,
   buildStatusSchema,
   commitSchema,
+  compareAppMigrations,
   completionRevocationSchema,
   completionRevokeSchema,
   createManagementClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domino-sdk/relay",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "exports": {
     ".": {