@constructive-io/sdk 1.20.4 → 1.20.6

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/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/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/orm/input-types.d.ts

@@ -1502,19 +1502,19 @@ export type PlatformInfraSetManyAndCommitPayloadSelect = {
     };
 };
 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 CreateContentPresetPayload {
     clientMutationId?: string | null;

package/infra/orm/mutation/index.d.ts

@@ -28,10 +28,11 @@ export interface PlatformInfraSetManyAndCommitVariables {
 /**
  * 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;