@constructive-sdk/cli 1.21.4 → 1.21.6

package/esm/objects/orm/mutation/index.d.ts

@@ -19,10 +19,11 @@ export interface InsertNodesAtPathsVariables {
 /**
  * Variables for provisionBucket
  * Reconcile an S3 bucket for a logical bucket in the database.
-Reads the bucket config via RLS, then enqueues the same
-storage:provision_bucket job used by the INSERT trigger. This is
-idempotent for an already-reconciled bucket; enqueue failures become
-GraphQL errors.
+Records the request on the bucket row via RLS; the bucket's job
+trigger then enqueues the same storage:provision_bucket job used on
+INSERT, and repeated requests collapse into one pending job. This is
+idempotent for an already-reconciled bucket; failures become GraphQL
+errors.
  */
 export interface ProvisionBucketVariables {
     input: ProvisionBucketInput;

package/esm/remote/cli/commands/provision-bucket.js

@@ -3,7 +3,7 @@ import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
 export default async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n\nUsage: provision-bucket [OPTIONS]\n');
+            console.log("provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n\nUsage: provision-bucket [OPTIONS]\n");
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/esm/remote/cli/commands.js

@@ -20,7 +20,7 @@ const createCommandMap = () => ({
     'machines-enroll': machinesEnrollCmd,
     'provision-bucket': provisionBucketCmd,
 });
-const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  machine              machine CRUD operations\n  machine-message      machineMessage CRUD operations\n  machine-session      machineSession CRUD operations\n  machines-enroll      machinesEnroll\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n';
+const usage = "\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  machine              machine CRUD operations\n  machine-message      machineMessage CRUD operations\n  machine-session      machineSession CRUD operations\n  machines-enroll      machinesEnroll\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n";
 export const commands = async (argv, prompter, options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/esm/remote/orm/input-types.d.ts

@@ -1307,19 +1307,19 @@ export type MachinesEnrollPayloadSelect = {
     result?: boolean;
 };
 export interface ProvisionBucketPayload {
-    /** The logical bucket row that was queued for reconciliation. */
+    /** The logical bucket row whose reconciliation was requested. */
     bucketId: string;
     bucketKey: string;
-    /** The reconciler job enqueued to provision this bucket. */
-    jobId: string;
     /** The physical bucket name already recorded, or null when reconciliation has not completed. */
     physicalName?: string | null;
+    /** When reconciliation was last requested for this bucket. */
+    provisionRequestedAt: string;
 }
 export type ProvisionBucketPayloadSelect = {
     bucketId?: boolean;
     bucketKey?: boolean;
-    jobId?: boolean;
     physicalName?: boolean;
+    provisionRequestedAt?: boolean;
 };
 export interface CreateMachinePayload {
     clientMutationId?: string | null;

package/esm/remote/orm/mutation/index.d.ts

@@ -13,10 +13,11 @@ export interface MachinesEnrollVariables {
 /**
  * Variables for provisionBucket
  * Reconcile an S3 bucket for a logical bucket in the database.
-Reads the bucket config via RLS, then enqueues the same
-storage:provision_bucket job used by the INSERT trigger. This is
-idempotent for an already-reconciled bucket; enqueue failures become
-GraphQL errors.
+Records the request on the bucket row via RLS; the bucket's job
+trigger then enqueues the same storage:provision_bucket job used on
+INSERT, and repeated requests collapse into one pending job. This is
+idempotent for an already-reconciled bucket; failures become GraphQL
+errors.
  */
 export interface ProvisionBucketVariables {
     input: ProvisionBucketInput;

package/esm/storage/cli/commands/bucket.js

@@ -18,8 +18,10 @@ const fieldSchema = {
     id: 'uuid',
     isPublic: 'boolean',
     key: 'string',
+    maxBulkFiles: 'int',
     maxFileSize: 'int',
     physicalName: 'string',
+    provisionRequestedAt: 'string',
     stagingTtl: 'string',
     tags: 'string',
     type: 'string',
@@ -80,6 +82,7 @@ async function handleList(argv, _prompter) {
             key: true,
             maxFileSize: true,
             physicalName: true,
+            provisionRequestedAt: true,
             stagingTtl: true,
             tags: true,
             type: true,
@@ -114,6 +117,7 @@ async function handleFindFirst(argv, _prompter) {
             key: true,
             maxFileSize: true,
             physicalName: true,
+            provisionRequestedAt: true,
             stagingTtl: true,
             tags: true,
             type: true,
@@ -160,6 +164,7 @@ async function handleGet(argv, prompter) {
                 key: true,
                 maxFileSize: true,
                 physicalName: true,
+                provisionRequestedAt: true,
                 stagingTtl: true,
                 tags: true,
                 type: true,
@@ -254,6 +259,13 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'provisionRequestedAt',
+                message: 'provisionRequestedAt',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'stagingTtl',
@@ -293,6 +305,7 @@ async function handleCreate(argv, prompter) {
                 key: cleanedData.key,
                 maxFileSize: cleanedData.maxFileSize,
                 physicalName: cleanedData.physicalName,
+                provisionRequestedAt: cleanedData.provisionRequestedAt,
                 stagingTtl: cleanedData.stagingTtl,
                 tags: cleanedData.tags,
                 type: cleanedData.type,
@@ -311,6 +324,7 @@ async function handleCreate(argv, prompter) {
                 key: true,
                 maxFileSize: true,
                 physicalName: true,
+                provisionRequestedAt: true,
                 stagingTtl: true,
                 tags: true,
                 type: true,
@@ -411,6 +425,13 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'provisionRequestedAt',
+                message: 'provisionRequestedAt',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'stagingTtl',
@@ -453,6 +474,7 @@ async function handleUpdate(argv, prompter) {
                 key: cleanedData.key,
                 maxFileSize: cleanedData.maxFileSize,
                 physicalName: cleanedData.physicalName,
+                provisionRequestedAt: cleanedData.provisionRequestedAt,
                 stagingTtl: cleanedData.stagingTtl,
                 tags: cleanedData.tags,
                 type: cleanedData.type,
@@ -471,6 +493,7 @@ async function handleUpdate(argv, prompter) {
                 key: true,
                 maxFileSize: true,
                 physicalName: true,
+                provisionRequestedAt: true,
                 stagingTtl: true,
                 tags: true,
                 type: true,

package/esm/storage/cli/commands/platform-bucket.js

@@ -17,8 +17,10 @@ const fieldSchema = {
     id: 'uuid',
     isPublic: 'boolean',
     key: 'string',
+    maxBulkFiles: 'int',
     maxFileSize: 'int',
     physicalName: 'string',
+    provisionRequestedAt: 'string',
     stagingTtl: 'string',
     tags: 'string',
     type: 'string',
@@ -78,6 +80,7 @@ async function handleList(argv, _prompter) {
             key: true,
             maxFileSize: true,
             physicalName: true,
+            provisionRequestedAt: true,
             stagingTtl: true,
             tags: true,
             type: true,
@@ -111,6 +114,7 @@ async function handleFindFirst(argv, _prompter) {
             key: true,
             maxFileSize: true,
             physicalName: true,
+            provisionRequestedAt: true,
             stagingTtl: true,
             tags: true,
             type: true,
@@ -156,6 +160,7 @@ async function handleGet(argv, prompter) {
                 key: true,
                 maxFileSize: true,
                 physicalName: true,
+                provisionRequestedAt: true,
                 stagingTtl: true,
                 tags: true,
                 type: true,
@@ -244,6 +249,13 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'provisionRequestedAt',
+                message: 'provisionRequestedAt',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'stagingTtl',
@@ -282,6 +294,7 @@ async function handleCreate(argv, prompter) {
                 key: cleanedData.key,
                 maxFileSize: cleanedData.maxFileSize,
                 physicalName: cleanedData.physicalName,
+                provisionRequestedAt: cleanedData.provisionRequestedAt,
                 stagingTtl: cleanedData.stagingTtl,
                 tags: cleanedData.tags,
                 type: cleanedData.type,
@@ -299,6 +312,7 @@ async function handleCreate(argv, prompter) {
                 key: true,
                 maxFileSize: true,
                 physicalName: true,
+                provisionRequestedAt: true,
                 stagingTtl: true,
                 tags: true,
                 type: true,
@@ -393,6 +407,13 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'provisionRequestedAt',
+                message: 'provisionRequestedAt',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'stagingTtl',
@@ -434,6 +455,7 @@ async function handleUpdate(argv, prompter) {
                 key: cleanedData.key,
                 maxFileSize: cleanedData.maxFileSize,
                 physicalName: cleanedData.physicalName,
+                provisionRequestedAt: cleanedData.provisionRequestedAt,
                 stagingTtl: cleanedData.stagingTtl,
                 tags: cleanedData.tags,
                 type: cleanedData.type,
@@ -451,6 +473,7 @@ async function handleUpdate(argv, prompter) {
                 key: true,
                 maxFileSize: true,
                 physicalName: true,
+                provisionRequestedAt: true,
                 stagingTtl: true,
                 tags: true,
                 type: true,

package/esm/storage/cli/commands/provision-bucket.js

@@ -3,7 +3,7 @@ import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
 export default async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n\nUsage: provision-bucket [OPTIONS]\n');
+            console.log("provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n\nUsage: provision-bucket [OPTIONS]\n");
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/esm/storage/cli/commands/upload-files.js

@@ -3,7 +3,7 @@ import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
 export default async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('upload-files - Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.\n\nUsage: upload-files [OPTIONS]\n');
+            console.log("upload-files - Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each. Accepts at most the bucket's `maxBulkFiles` files per call.\n\nUsage: upload-files [OPTIONS]\n");
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/esm/storage/cli/commands/upload-platform-files.js

@@ -3,7 +3,7 @@ import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
 export default async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('upload-platform-files - Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.\n\nUsage: upload-platform-files [OPTIONS]\n');
+            console.log("upload-platform-files - Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each. Accepts at most the bucket's `maxBulkFiles` files per call.\n\nUsage: upload-platform-files [OPTIONS]\n");
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/esm/storage/cli/commands.js

@@ -32,7 +32,7 @@ const createCommandMap = () => ({
     'upload-platform-file': uploadPlatformFileCmd,
     'upload-platform-files': uploadPlatformFilesCmd,
 });
-const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  bucket               bucket CRUD operations\n  file                 file CRUD operations\n  platform-bucket      platformBucket CRUD operations\n  platform-file        platformFile CRUD operations\n  files-rename         filesRename\n  platform-files-rename platformFilesRename\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n  upload-file          Upload a file: resolves the bucket by key, creates the file row, and returns a presigned PUT URL.\n  upload-files         Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.\n  upload-platform-file Upload a file: resolves the bucket by key, creates the file row, and returns a presigned PUT URL.\n  upload-platform-files Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n';
+const usage = "\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  bucket               bucket CRUD operations\n  file                 file CRUD operations\n  platform-bucket      platformBucket CRUD operations\n  platform-file        platformFile CRUD operations\n  files-rename         filesRename\n  platform-files-rename platformFilesRename\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n  upload-file          Upload a file: resolves the bucket by key, creates the file row, and returns a presigned PUT URL.\n  upload-files         Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each. Accepts at most the bucket's `maxBulkFiles` files per call.\n  upload-platform-file Upload a file: resolves the bucket by key, creates the file row, and returns a presigned PUT URL.\n  upload-platform-files Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each. Accepts at most the bucket's `maxBulkFiles` files per call.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n";
 export const commands = async (argv, prompter, options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/esm/storage/orm/input-types.d.ts

@@ -254,10 +254,14 @@ export interface Bucket {
     isPublic?: boolean | null;
     /** Unique bucket identifier used in S3 key paths (e.g. avatars, documents, temp) */
     key?: string | null;
+    /** The most files one bulk-upload call accepts for this bucket. Batches larger than this are refused with BULK_UPLOAD_FILES_EXCEEDED. */
+    maxBulkFiles?: number | null;
     /** Maximum file size in bytes allowed in this bucket (NULL = no limit, enforcement deferred) */
     maxFileSize?: string | null;
     /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
     physicalName?: string | null;
+    /** When re-provisioning was last requested (provisionBucket); NULL until requested */
+    provisionRequestedAt?: string | null;
     /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
     stagingTtl?: string | null;
     /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
@@ -325,10 +329,14 @@ export interface PlatformBucket {
     isPublic?: boolean | null;
     /** Unique bucket identifier used in S3 key paths (e.g. avatars, documents, temp) */
     key?: string | null;
+    /** The most files one bulk-upload call accepts for this bucket. Batches larger than this are refused with BULK_UPLOAD_FILES_EXCEEDED. */
+    maxBulkFiles?: number | null;
     /** Maximum file size in bytes allowed in this bucket (NULL = no limit, enforcement deferred) */
     maxFileSize?: string | null;
     /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
     physicalName?: string | null;
+    /** When re-provisioning was last requested (provisionBucket); NULL until requested */
+    provisionRequestedAt?: string | null;
     /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
     stagingTtl?: string | null;
     /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
@@ -417,8 +425,10 @@ export type BucketSelect = {
     id?: boolean;
     isPublic?: boolean;
     key?: boolean;
+    maxBulkFiles?: boolean;
     maxFileSize?: boolean;
     physicalName?: boolean;
+    provisionRequestedAt?: boolean;
     stagingTtl?: boolean;
     tags?: boolean;
     type?: boolean;
@@ -475,8 +485,10 @@ export type PlatformBucketSelect = {
     id?: boolean;
     isPublic?: boolean;
     key?: boolean;
+    maxBulkFiles?: boolean;
     maxFileSize?: boolean;
     physicalName?: boolean;
+    provisionRequestedAt?: boolean;
     stagingTtl?: boolean;
     tags?: boolean;
     type?: boolean;
@@ -566,6 +578,8 @@ export interface BucketFilter {
     or?: BucketFilter[];
     /** Filter by the object’s `physicalName` field. */
     physicalName?: StringFilter;
+    /** Filter by the object’s `provisionRequestedAt` field. */
+    provisionRequestedAt?: DatetimeFilter;
     /** Filter by the object’s `stagingTtl` field. */
     stagingTtl?: IntervalFilter;
     /** Filter by the object’s `tags` field. */
@@ -664,6 +678,8 @@ export interface PlatformBucketFilter {
     platformFilesByBucketId?: PlatformBucketToManyPlatformFileFilter;
     /** `platformFilesByBucketId` exist. */
     platformFilesByBucketIdExist?: boolean;
+    /** Filter by the object’s `provisionRequestedAt` field. */
+    provisionRequestedAt?: DatetimeFilter;
     /** Filter by the object’s `stagingTtl` field. */
     stagingTtl?: IntervalFilter;
     /** Filter by the object’s `tags` field. */
@@ -717,9 +733,9 @@ export interface PlatformFileFilter {
     /** Filter by the object’s `upload` field. */
     upload?: ConstructiveInternalTypeUploadFilter;
 }
-export type BucketOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ALLOWED_MIME_TYPES_ASC' | 'ALLOWED_MIME_TYPES_DESC' | 'ALLOWED_ORIGINS_ASC' | 'ALLOWED_ORIGINS_DESC' | 'ALLOW_CUSTOM_KEYS_ASC' | 'ALLOW_CUSTOM_KEYS_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'DESTINATION_BUCKET_ID_ASC' | 'DESTINATION_BUCKET_ID_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MAX_FILE_SIZE_ASC' | 'MAX_FILE_SIZE_DESC' | 'NATURAL' | 'PHYSICAL_NAME_ASC' | 'PHYSICAL_NAME_DESC' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'STAGING_TTL_ASC' | 'STAGING_TTL_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'TYPE_ASC' | 'TYPE_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
+export type BucketOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ALLOWED_MIME_TYPES_ASC' | 'ALLOWED_MIME_TYPES_DESC' | 'ALLOWED_ORIGINS_ASC' | 'ALLOWED_ORIGINS_DESC' | 'ALLOW_CUSTOM_KEYS_ASC' | 'ALLOW_CUSTOM_KEYS_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'DESTINATION_BUCKET_ID_ASC' | 'DESTINATION_BUCKET_ID_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MAX_FILE_SIZE_ASC' | 'MAX_FILE_SIZE_DESC' | 'NATURAL' | 'PHYSICAL_NAME_ASC' | 'PHYSICAL_NAME_DESC' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'PROVISION_REQUESTED_AT_ASC' | 'PROVISION_REQUESTED_AT_DESC' | 'STAGING_TTL_ASC' | 'STAGING_TTL_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'TYPE_ASC' | 'TYPE_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
 export type FileOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'BUCKET_ID_ASC' | 'BUCKET_ID_DESC' | 'CONTENT_HASH_ASC' | 'CONTENT_HASH_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'EXPIRY_ENQUEUED_AT_ASC' | 'EXPIRY_ENQUEUED_AT_DESC' | 'FILENAME_ASC' | 'FILENAME_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MIME_TYPE_ASC' | 'MIME_TYPE_DESC' | 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'PROMOTED_AT_ASC' | 'PROMOTED_AT_DESC' | 'SIZE_ASC' | 'SIZE_DESC' | 'STATUS_ASC' | 'STATUS_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'UPLOAD_ASC' | 'UPLOAD_DESC';
-export type PlatformBucketOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ALLOWED_MIME_TYPES_ASC' | 'ALLOWED_MIME_TYPES_DESC' | 'ALLOWED_ORIGINS_ASC' | 'ALLOWED_ORIGINS_DESC' | 'ALLOW_CUSTOM_KEYS_ASC' | 'ALLOW_CUSTOM_KEYS_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'DESTINATION_BUCKET_ID_ASC' | 'DESTINATION_BUCKET_ID_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MAX_FILE_SIZE_ASC' | 'MAX_FILE_SIZE_DESC' | 'NATURAL' | 'PHYSICAL_NAME_ASC' | 'PHYSICAL_NAME_DESC' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'STAGING_TTL_ASC' | 'STAGING_TTL_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'TYPE_ASC' | 'TYPE_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
+export type PlatformBucketOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ALLOWED_MIME_TYPES_ASC' | 'ALLOWED_MIME_TYPES_DESC' | 'ALLOWED_ORIGINS_ASC' | 'ALLOWED_ORIGINS_DESC' | 'ALLOW_CUSTOM_KEYS_ASC' | 'ALLOW_CUSTOM_KEYS_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'DESTINATION_BUCKET_ID_ASC' | 'DESTINATION_BUCKET_ID_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MAX_FILE_SIZE_ASC' | 'MAX_FILE_SIZE_DESC' | 'NATURAL' | 'PHYSICAL_NAME_ASC' | 'PHYSICAL_NAME_DESC' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'PROVISION_REQUESTED_AT_ASC' | 'PROVISION_REQUESTED_AT_DESC' | 'STAGING_TTL_ASC' | 'STAGING_TTL_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'TYPE_ASC' | 'TYPE_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
 export type PlatformFileOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'BUCKET_ID_ASC' | 'BUCKET_ID_DESC' | 'CONTENT_HASH_ASC' | 'CONTENT_HASH_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'EXPIRY_ENQUEUED_AT_ASC' | 'EXPIRY_ENQUEUED_AT_DESC' | 'FILENAME_ASC' | 'FILENAME_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MIME_TYPE_ASC' | 'MIME_TYPE_DESC' | 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'PROMOTED_AT_ASC' | 'PROMOTED_AT_DESC' | 'SIZE_ASC' | 'SIZE_DESC' | 'STATUS_ASC' | 'STATUS_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'UPLOAD_ASC' | 'UPLOAD_DESC';
 export interface CreateBucketInput {
     clientMutationId?: string;
@@ -735,6 +751,7 @@ export interface CreateBucketInput {
         key: string;
         maxFileSize?: string;
         physicalName?: string;
+        provisionRequestedAt?: string;
         stagingTtl?: IntervalInput;
         tags?: string[];
         type?: BucketType;
@@ -752,6 +769,7 @@ export interface BucketPatch {
     key?: string | null;
     maxFileSize?: string | null;
     physicalName?: string | null;
+    provisionRequestedAt?: string | null;
     stagingTtl?: IntervalInput | null;
     tags?: string[] | null;
     type?: BucketType | null;
@@ -823,6 +841,7 @@ export interface CreatePlatformBucketInput {
         key: string;
         maxFileSize?: string;
         physicalName?: string;
+        provisionRequestedAt?: string;
         stagingTtl?: IntervalInput;
         tags?: string[];
         type?: BucketType;
@@ -839,6 +858,7 @@ export interface PlatformBucketPatch {
     key?: string | null;
     maxFileSize?: string | null;
     physicalName?: string | null;
+    provisionRequestedAt?: string | null;
     stagingTtl?: IntervalInput | null;
     tags?: string[] | null;
     type?: BucketType | null;
@@ -1136,6 +1156,8 @@ export interface BucketInput {
     maxFileSize?: string;
     /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
     physicalName?: string;
+    /** When re-provisioning was last requested (provisionBucket); NULL until requested */
+    provisionRequestedAt?: string;
     /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
     stagingTtl?: IntervalInput;
     /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
@@ -1219,6 +1241,8 @@ export interface PlatformBucketInput {
     maxFileSize?: string;
     /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
     physicalName?: string;
+    /** When re-provisioning was last requested (provisionBucket); NULL until requested */
+    provisionRequestedAt?: string;
     /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
     stagingTtl?: IntervalInput;
     /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
@@ -1329,6 +1353,8 @@ export interface BucketFilter {
     or?: BucketFilter[];
     /** Filter by the object’s `physicalName` field. */
     physicalName?: StringFilter;
+    /** Filter by the object’s `provisionRequestedAt` field. */
+    provisionRequestedAt?: DatetimeFilter;
     /** Filter by the object’s `stagingTtl` field. */
     stagingTtl?: IntervalFilter;
     /** Filter by the object’s `tags` field. */
@@ -1429,6 +1455,8 @@ export interface PlatformBucketFilter {
     platformFilesByBucketId?: PlatformBucketToManyPlatformFileFilter;
     /** `platformFilesByBucketId` exist. */
     platformFilesByBucketIdExist?: boolean;
+    /** Filter by the object’s `provisionRequestedAt` field. */
+    provisionRequestedAt?: DatetimeFilter;
     /** Filter by the object’s `stagingTtl` field. */
     stagingTtl?: IntervalFilter;
     /** Filter by the object’s `tags` field. */
@@ -1728,19 +1756,19 @@ export type PlatformFilesRenamePayloadSelect = {
     };
 };
 export interface ProvisionBucketPayload {
-    /** The logical bucket row that was queued for reconciliation. */
+    /** The logical bucket row whose reconciliation was requested. */
     bucketId: string;
     bucketKey: string;
-    /** The reconciler job enqueued to provision this bucket. */
-    jobId: string;
     /** The physical bucket name already recorded, or null when reconciliation has not completed. */
     physicalName?: string | null;
+    /** When reconciliation was last requested for this bucket. */
+    provisionRequestedAt: string;
 }
 export type ProvisionBucketPayloadSelect = {
     bucketId?: boolean;
     bucketKey?: boolean;
-    jobId?: boolean;
     physicalName?: boolean;
+    provisionRequestedAt?: boolean;
 };
 export interface UploadFilePayload {
     /** Whether this file was deduplicated (content already exists) */

package/esm/storage/orm/mutation/index.d.ts

@@ -16,10 +16,11 @@ export interface PlatformFilesRenameVariables {
 /**
  * Variables for provisionBucket
  * Reconcile an S3 bucket for a logical bucket in the database.
-Reads the bucket config via RLS, then enqueues the same
-storage:provision_bucket job used by the INSERT trigger. This is
-idempotent for an already-reconciled bucket; enqueue failures become
-GraphQL errors.
+Records the request on the bucket row via RLS; the bucket's job
+trigger then enqueues the same storage:provision_bucket job used on
+INSERT, and repeated requests collapse into one pending job. This is
+idempotent for an already-reconciled bucket; failures become GraphQL
+errors.
  */
 export interface ProvisionBucketVariables {
     input: ProvisionBucketInput;
@@ -33,7 +34,7 @@ export interface UploadFileVariables {
 }
 /**
  * Variables for uploadFiles
- * Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.
+ * Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each. Accepts at most the bucket's `maxBulkFiles` files per call.
  */
 export interface UploadFilesVariables {
     input: UploadFileBulkInput;
@@ -47,7 +48,7 @@ export interface UploadPlatformFileVariables {
 }
 /**
  * Variables for uploadPlatformFiles
- * Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.
+ * Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each. Accepts at most the bucket's `maxBulkFiles` files per call.
  */
 export interface UploadPlatformFilesVariables {
     input: UploadPlatformFileBulkInput;

package/esm/usage/cli/commands/provision-bucket.js

@@ -3,7 +3,7 @@ import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
 export default async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n\nUsage: provision-bucket [OPTIONS]\n');
+            console.log("provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n\nUsage: provision-bucket [OPTIONS]\n");
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/esm/usage/cli/commands.js

@@ -60,7 +60,7 @@ const createCommandMap = () => ({
     'seed-org-limit-caps-defaults': seedOrgLimitCapsDefaultsCmd,
     'seed-org-limit-defaults': seedOrgLimitDefaultsCmd,
 });
-const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  app-limit-cap        appLimitCap CRUD operations\n  app-limit-caps-default appLimitCapsDefault CRUD operations\n  app-limit            appLimit CRUD operations\n  app-limit-credit-code appLimitCreditCode CRUD operations\n  app-limit-credit-code-item appLimitCreditCodeItem CRUD operations\n  app-limit-credit     appLimitCredit CRUD operations\n  app-limit-credit-redemption appLimitCreditRedemption CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  app-limit-event      appLimitEvent CRUD operations\n  app-limit-warning    appLimitWarning CRUD operations\n  org-limit-aggregate  orgLimitAggregate CRUD operations\n  org-limit-cap        orgLimitCap CRUD operations\n  org-limit-caps-default orgLimitCapsDefault CRUD operations\n  org-limit            orgLimit CRUD operations\n  org-limit-credit     orgLimitCredit CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  org-limit-event      orgLimitEvent CRUD operations\n  org-limit-warning    orgLimitWarning CRUD operations\n  capture-app-limit-defaults captureAppLimitDefaults\n  capture-org-limit-defaults captureOrgLimitDefaults\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n  seed-app-limit-caps-defaults seedAppLimitCapsDefaults\n  seed-app-limit-defaults seedAppLimitDefaults\n  seed-org-limit-caps-defaults seedOrgLimitCapsDefaults\n  seed-org-limit-defaults seedOrgLimitDefaults\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n';
+const usage = "\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  app-limit-cap        appLimitCap CRUD operations\n  app-limit-caps-default appLimitCapsDefault CRUD operations\n  app-limit            appLimit CRUD operations\n  app-limit-credit-code appLimitCreditCode CRUD operations\n  app-limit-credit-code-item appLimitCreditCodeItem CRUD operations\n  app-limit-credit     appLimitCredit CRUD operations\n  app-limit-credit-redemption appLimitCreditRedemption CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  app-limit-event      appLimitEvent CRUD operations\n  app-limit-warning    appLimitWarning CRUD operations\n  org-limit-aggregate  orgLimitAggregate CRUD operations\n  org-limit-cap        orgLimitCap CRUD operations\n  org-limit-caps-default orgLimitCapsDefault CRUD operations\n  org-limit            orgLimit CRUD operations\n  org-limit-credit     orgLimitCredit CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  org-limit-event      orgLimitEvent CRUD operations\n  org-limit-warning    orgLimitWarning CRUD operations\n  capture-app-limit-defaults captureAppLimitDefaults\n  capture-org-limit-defaults captureOrgLimitDefaults\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n  seed-app-limit-caps-defaults seedAppLimitCapsDefaults\n  seed-app-limit-defaults seedAppLimitDefaults\n  seed-org-limit-caps-defaults seedOrgLimitCapsDefaults\n  seed-org-limit-defaults seedOrgLimitDefaults\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n";
 export const commands = async (argv, prompter, options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/esm/usage/orm/input-types.d.ts

@@ -2527,19 +2527,19 @@ export interface DatetimeFilter {
     notIn?: string[];
 }
 export interface ProvisionBucketPayload {
-    /** The logical bucket row that was queued for reconciliation. */
+    /** The logical bucket row whose reconciliation was requested. */
     bucketId: string;
     bucketKey: string;
-    /** The reconciler job enqueued to provision this bucket. */
-    jobId: string;
     /** The physical bucket name already recorded, or null when reconciliation has not completed. */
     physicalName?: string | null;
+    /** When reconciliation was last requested for this bucket. */
+    provisionRequestedAt: string;
 }
 export type ProvisionBucketPayloadSelect = {
     bucketId?: boolean;
     bucketKey?: boolean;
-    jobId?: boolean;
     physicalName?: boolean;
+    provisionRequestedAt?: boolean;
 };
 export interface SeedAppLimitCapsDefaultsPayload {
     clientMutationId?: string | null;

package/esm/usage/orm/mutation/index.d.ts

@@ -10,10 +10,11 @@ import type { ProvisionBucketInput, SeedAppLimitCapsDefaultsInput, SeedAppLimitD
 /**
  * Variables for provisionBucket
  * Reconcile an S3 bucket for a logical bucket in the database.
-Reads the bucket config via RLS, then enqueues the same
-storage:provision_bucket job used by the INSERT trigger. This is
-idempotent for an already-reconciled bucket; enqueue failures become
-GraphQL errors.
+Records the request on the bucket row via RLS; the bucket's job
+trigger then enqueues the same storage:provision_bucket job used on
+INSERT, and repeated requests collapse into one pending job. This is
+idempotent for an already-reconciled bucket; failures become GraphQL
+errors.
  */
 export interface ProvisionBucketVariables {
     input: ProvisionBucketInput;

package/infra/cli/commands/provision-bucket.js

@@ -5,7 +5,7 @@ const utils_1 = require("../utils");
 exports.default = async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n\nUsage: provision-bucket [OPTIONS]\n');
+            console.log("provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n\nUsage: provision-bucket [OPTIONS]\n");
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/infra/cli/commands.js

@@ -52,7 +52,7 @@ const createCommandMap = () => ({
     'platform-infra-set-many-and-commit': platform_infra_set_many_and_commit_1.default,
     'provision-bucket': provision_bucket_1.default,
 });
-const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  content-preset       contentPreset CRUD operations\n  db-preset            dbPreset CRUD operations\n  namespace            namespace CRUD operations\n  namespace-event      namespaceEvent CRUD operations\n  platform-infra-commit platformInfraCommit CRUD operations\n  platform-infra-get-all-tree-nodes-record platformInfraGetAllTreeNodesRecord CRUD operations\n  platform-infra-object platformInfraObject CRUD operations\n  platform-infra-ref   platformInfraRef CRUD operations\n  platform-infra-store platformInfraStore CRUD operations\n  platform-namespace   platformNamespace CRUD operations\n  platform-namespace-event platformNamespaceEvent CRUD operations\n  platform-infra-init-empty-repo platformInfraInitEmptyRepo\n  platform-infra-insert-node-at-path platformInfraInsertNodeAtPath\n  platform-infra-insert-nodes-at-paths platformInfraInsertNodesAtPaths\n  platform-infra-set-and-commit platformInfraSetAndCommit\n  platform-infra-set-data-at-path platformInfraSetDataAtPath\n  platform-infra-set-many-and-commit platformInfraSetManyAndCommit\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n';
+const usage = "\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  content-preset       contentPreset CRUD operations\n  db-preset            dbPreset CRUD operations\n  namespace            namespace CRUD operations\n  namespace-event      namespaceEvent CRUD operations\n  platform-infra-commit platformInfraCommit CRUD operations\n  platform-infra-get-all-tree-nodes-record platformInfraGetAllTreeNodesRecord CRUD operations\n  platform-infra-object platformInfraObject CRUD operations\n  platform-infra-ref   platformInfraRef CRUD operations\n  platform-infra-store platformInfraStore CRUD operations\n  platform-namespace   platformNamespace CRUD operations\n  platform-namespace-event platformNamespaceEvent CRUD operations\n  platform-infra-init-empty-repo platformInfraInitEmptyRepo\n  platform-infra-insert-node-at-path platformInfraInsertNodeAtPath\n  platform-infra-insert-nodes-at-paths platformInfraInsertNodesAtPaths\n  platform-infra-set-and-commit platformInfraSetAndCommit\n  platform-infra-set-data-at-path platformInfraSetDataAtPath\n  platform-infra-set-many-and-commit platformInfraSetManyAndCommit\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n";
 const commands = async (argv, prompter, options) => {
     if (argv.help || argv.h) {
         console.log(usage);