@constructive-sdk/cli 0.12.23 → 0.13.1

package/auth/orm/input-types.d.ts

@@ -937,6 +937,26 @@ export interface VerifyTotpInput {
     clientMutationId?: string;
     totpValue: string;
 }
+export interface RequestUploadUrlInput {
+    /** Bucket key (e.g., "public", "private") */
+    bucketKey: string;
+    /** SHA-256 content hash computed by the client (hex-encoded, 64 chars) */
+    contentHash: string;
+    /** MIME type of the file (e.g., "image/png") */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** Original filename (optional, for display and Content-Disposition) */
+    filename?: string;
+}
+export interface ConfirmUploadInput {
+    /** The file ID returned by requestUploadUrl */
+    fileId: string;
+}
+export interface ProvisionBucketInput {
+    /** The logical bucket key (e.g., "public", "private") */
+    bucketKey: string;
+}
 /** A filter to be used against ConstructiveInternalTypeEmail fields. All fields are combined with a logical ‘and.’ */
 export interface ConstructiveInternalTypeEmailFilter {
     /** Is null (if `true` is specified) or is not null (if `false` is specified). */
@@ -1882,6 +1902,60 @@ export type VerifyTotpPayloadSelect = {
         select: SessionSelect;
     };
 };
+export interface RequestUploadUrlPayload {
+    /** Presigned PUT URL (null if file was deduplicated) */
+    uploadUrl?: string | null;
+    /** The file ID (existing if deduplicated, new if fresh upload) */
+    fileId: string;
+    /** The S3 object key */
+    key: string;
+    /** Whether this file was deduplicated (already exists with same hash) */
+    deduplicated: boolean;
+    /** Presigned URL expiry time (null if deduplicated) */
+    expiresAt?: string | null;
+}
+export type RequestUploadUrlPayloadSelect = {
+    uploadUrl?: boolean;
+    fileId?: boolean;
+    key?: boolean;
+    deduplicated?: boolean;
+    expiresAt?: boolean;
+};
+export interface ConfirmUploadPayload {
+    /** The confirmed file ID */
+    fileId: string;
+    /** New file status */
+    status: string;
+    /** Whether confirmation succeeded */
+    success: boolean;
+}
+export type ConfirmUploadPayloadSelect = {
+    fileId?: boolean;
+    status?: boolean;
+    success?: boolean;
+};
+export interface ProvisionBucketPayload {
+    /** Whether provisioning succeeded */
+    success: boolean;
+    /** The S3 bucket name that was provisioned */
+    bucketName: string;
+    /** The access type applied */
+    accessType: string;
+    /** The storage provider used */
+    provider: string;
+    /** The S3 endpoint (null for AWS S3 default) */
+    endpoint?: string | null;
+    /** Error message if provisioning failed */
+    error?: string | null;
+}
+export type ProvisionBucketPayloadSelect = {
+    success?: boolean;
+    bucketName?: boolean;
+    accessType?: boolean;
+    provider?: boolean;
+    endpoint?: boolean;
+    error?: boolean;
+};
 export interface CreateEmailPayload {
     clientMutationId?: string | null;
     /** The `Email` that was created by this mutation. */

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

@@ -6,7 +6,7 @@
 import { OrmClient } from '../client';
 import { QueryBuilder } from '../query-builder';
 import type { InferSelectResult, StrictSelect } from '../select-types';
-import type { SignOutInput, SendAccountDeletionEmailInput, CheckPasswordInput, ConfirmDeleteAccountInput, SetPasswordInput, VerifyEmailInput, ResetPasswordInput, SignInOneTimeTokenInput, SignInInput, SignUpInput, OneTimeTokenInput, ExtendTokenExpiresInput, ForgotPasswordInput, SendVerificationEmailInput, VerifyPasswordInput, VerifyTotpInput, SignOutPayload, SendAccountDeletionEmailPayload, CheckPasswordPayload, ConfirmDeleteAccountPayload, SetPasswordPayload, VerifyEmailPayload, ResetPasswordPayload, SignInOneTimeTokenPayload, SignInPayload, SignUpPayload, OneTimeTokenPayload, ExtendTokenExpiresPayload, ForgotPasswordPayload, SendVerificationEmailPayload, VerifyPasswordPayload, VerifyTotpPayload, SignOutPayloadSelect, SendAccountDeletionEmailPayloadSelect, CheckPasswordPayloadSelect, ConfirmDeleteAccountPayloadSelect, SetPasswordPayloadSelect, VerifyEmailPayloadSelect, ResetPasswordPayloadSelect, SignInOneTimeTokenPayloadSelect, SignInPayloadSelect, SignUpPayloadSelect, OneTimeTokenPayloadSelect, ExtendTokenExpiresPayloadSelect, ForgotPasswordPayloadSelect, SendVerificationEmailPayloadSelect, VerifyPasswordPayloadSelect, VerifyTotpPayloadSelect } from '../input-types';
+import type { SignOutInput, SendAccountDeletionEmailInput, CheckPasswordInput, ConfirmDeleteAccountInput, SetPasswordInput, VerifyEmailInput, ResetPasswordInput, SignInOneTimeTokenInput, SignInInput, SignUpInput, OneTimeTokenInput, ExtendTokenExpiresInput, ForgotPasswordInput, SendVerificationEmailInput, VerifyPasswordInput, VerifyTotpInput, RequestUploadUrlInput, ConfirmUploadInput, ProvisionBucketInput, SignOutPayload, SendAccountDeletionEmailPayload, CheckPasswordPayload, ConfirmDeleteAccountPayload, SetPasswordPayload, VerifyEmailPayload, ResetPasswordPayload, SignInOneTimeTokenPayload, SignInPayload, SignUpPayload, OneTimeTokenPayload, ExtendTokenExpiresPayload, ForgotPasswordPayload, SendVerificationEmailPayload, VerifyPasswordPayload, VerifyTotpPayload, RequestUploadUrlPayload, ConfirmUploadPayload, ProvisionBucketPayload, SignOutPayloadSelect, SendAccountDeletionEmailPayloadSelect, CheckPasswordPayloadSelect, ConfirmDeleteAccountPayloadSelect, SetPasswordPayloadSelect, VerifyEmailPayloadSelect, ResetPasswordPayloadSelect, SignInOneTimeTokenPayloadSelect, SignInPayloadSelect, SignUpPayloadSelect, OneTimeTokenPayloadSelect, ExtendTokenExpiresPayloadSelect, ForgotPasswordPayloadSelect, SendVerificationEmailPayloadSelect, VerifyPasswordPayloadSelect, VerifyTotpPayloadSelect, RequestUploadUrlPayloadSelect, ConfirmUploadPayloadSelect, ProvisionBucketPayloadSelect } from '../input-types';
 export interface SignOutVariables {
     input: SignOutInput;
 }
@@ -55,6 +55,35 @@ export interface VerifyPasswordVariables {
 export interface VerifyTotpVariables {
     input: VerifyTotpInput;
 }
+/**
+ * Variables for requestUploadUrl
+ * Request a presigned URL for uploading a file directly to S3.
+Client computes SHA-256 of the file content and provides it here.
+If a file with the same hash already exists (dedup), returns the
+existing file ID and deduplicated=true with no uploadUrl.
+ */
+export interface RequestUploadUrlVariables {
+    input: RequestUploadUrlInput;
+}
+/**
+ * Variables for confirmUpload
+ * Confirm that a file has been uploaded to S3.
+Verifies the object exists in S3, checks content-type,
+and transitions the file status from 'pending' to 'ready'.
+ */
+export interface ConfirmUploadVariables {
+    input: ConfirmUploadInput;
+}
+/**
+ * Variables for provisionBucket
+ * Provision an S3 bucket for a logical bucket in the database.
+Reads the bucket config via RLS, then creates and configures
+the S3 bucket with the appropriate privacy policies, CORS rules,
+and lifecycle settings.
+ */
+export interface ProvisionBucketVariables {
+    input: ProvisionBucketInput;
+}
 export declare function createMutationOperations(client: OrmClient): {
     signOut: <S extends SignOutPayloadSelect>(args: SignOutVariables, options: {
         select: S;
@@ -136,4 +165,19 @@ export declare function createMutationOperations(client: OrmClient): {
     } & StrictSelect<S, VerifyTotpPayloadSelect>) => QueryBuilder<{
         verifyTotp: InferSelectResult<VerifyTotpPayload, S> | null;
     }>;
+    requestUploadUrl: <S extends RequestUploadUrlPayloadSelect>(args: RequestUploadUrlVariables, options: {
+        select: S;
+    } & StrictSelect<S, RequestUploadUrlPayloadSelect>) => QueryBuilder<{
+        requestUploadUrl: InferSelectResult<RequestUploadUrlPayload, S> | null;
+    }>;
+    confirmUpload: <S extends ConfirmUploadPayloadSelect>(args: ConfirmUploadVariables, options: {
+        select: S;
+    } & StrictSelect<S, ConfirmUploadPayloadSelect>) => QueryBuilder<{
+        confirmUpload: InferSelectResult<ConfirmUploadPayload, S> | null;
+    }>;
+    provisionBucket: <S extends ProvisionBucketPayloadSelect>(args: ProvisionBucketVariables, options: {
+        select: S;
+    } & StrictSelect<S, ProvisionBucketPayloadSelect>) => QueryBuilder<{
+        provisionBucket: InferSelectResult<ProvisionBucketPayload, S> | null;
+    }>;
 };

package/auth/orm/mutation/index.js

@@ -197,5 +197,41 @@ function createMutationOperations(client) {
                 },
             ], input_types_1.connectionFieldsMap, 'VerifyTotpPayload'),
         }),
+        requestUploadUrl: (args, options) => new query_builder_1.QueryBuilder({
+            client,
+            operation: 'mutation',
+            operationName: 'RequestUploadUrl',
+            fieldName: 'requestUploadUrl',
+            ...(0, query_builder_1.buildCustomDocument)('mutation', 'RequestUploadUrl', 'requestUploadUrl', options.select, args, [
+                {
+                    name: 'input',
+                    type: 'RequestUploadUrlInput!',
+                },
+            ], input_types_1.connectionFieldsMap, 'RequestUploadUrlPayload'),
+        }),
+        confirmUpload: (args, options) => new query_builder_1.QueryBuilder({
+            client,
+            operation: 'mutation',
+            operationName: 'ConfirmUpload',
+            fieldName: 'confirmUpload',
+            ...(0, query_builder_1.buildCustomDocument)('mutation', 'ConfirmUpload', 'confirmUpload', options.select, args, [
+                {
+                    name: 'input',
+                    type: 'ConfirmUploadInput!',
+                },
+            ], input_types_1.connectionFieldsMap, 'ConfirmUploadPayload'),
+        }),
+        provisionBucket: (args, options) => new query_builder_1.QueryBuilder({
+            client,
+            operation: 'mutation',
+            operationName: 'ProvisionBucket',
+            fieldName: 'provisionBucket',
+            ...(0, query_builder_1.buildCustomDocument)('mutation', 'ProvisionBucket', 'provisionBucket', options.select, args, [
+                {
+                    name: 'input',
+                    type: 'ProvisionBucketInput!',
+                },
+            ], input_types_1.connectionFieldsMap, 'ProvisionBucketPayload'),
+        }),
     };
 }

package/esm/admin/cli/commands/confirm-upload.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation confirmUpload
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/esm/admin/cli/commands/confirm-upload.js

@@ -0,0 +1,34 @@
+import { getClient } from '../executor';
+import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
+export default async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log("confirm-upload - Confirm that a file has been uploaded to S3.\nVerifies the object exists in S3, checks content-type,\nand transitions the file status from 'pending' to 'ready'.\n\nUsage: confirm-upload [OPTIONS]\n");
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = getClient();
+        const parsedAnswers = unflattenDotNotation(answers);
+        const selectFields = buildSelectFromPaths(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .confirmUpload(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: confirmUpload');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/esm/admin/cli/commands/provision-bucket.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation provisionBucket
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

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

@@ -0,0 +1,34 @@
+import { getClient } from '../executor';
+import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
+export default async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('provision-bucket - Provision an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then creates and configures\nthe S3 bucket with the appropriate privacy policies, CORS rules,\nand lifecycle settings.\n\nUsage: provision-bucket [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = getClient();
+        const parsedAnswers = unflattenDotNotation(answers);
+        const selectFields = buildSelectFromPaths(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .provisionBucket(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: provisionBucket');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/esm/admin/cli/commands/request-upload-url.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation requestUploadUrl
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/esm/admin/cli/commands/request-upload-url.js

@@ -0,0 +1,34 @@
+import { getClient } from '../executor';
+import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
+export default async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('request-upload-url - Request a presigned URL for uploading a file directly to S3.\nClient computes SHA-256 of the file content and provides it here.\nIf a file with the same hash already exists (dedup), returns the\nexisting file ID and deduplicated=true with no uploadUrl.\n\nUsage: request-upload-url [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = getClient();
+        const parsedAnswers = unflattenDotNotation(answers);
+        const selectFields = buildSelectFromPaths(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .requestUploadUrl(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: requestUploadUrl');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/esm/admin/cli/commands.js

@@ -51,6 +51,9 @@ import orgPermissionsGetByMaskCmd from './commands/org-permissions-get-by-mask';
 import stepsRequiredCmd from './commands/steps-required';
 import submitInviteCodeCmd from './commands/submit-invite-code';
 import submitOrgInviteCodeCmd from './commands/submit-org-invite-code';
+import requestUploadUrlCmd from './commands/request-upload-url';
+import confirmUploadCmd from './commands/confirm-upload';
+import provisionBucketCmd from './commands/provision-bucket';
 const createCommandMap = () => ({
     context: contextCmd,
     auth: authCmd,
@@ -99,8 +102,11 @@ const createCommandMap = () => ({
     'steps-required': stepsRequiredCmd,
     'submit-invite-code': submitInviteCodeCmd,
     'submit-org-invite-code': submitOrgInviteCodeCmd,
+    'request-upload-url': requestUploadUrlCmd,
+    'confirm-upload': confirmUploadCmd,
+    'provision-bucket': provisionBucketCmd,
 });
-const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  org-get-managers-record orgGetManagersRecord CRUD operations\n  org-get-subordinates-record orgGetSubordinatesRecord CRUD operations\n  app-permission       appPermission CRUD operations\n  org-permission       orgPermission CRUD operations\n  app-level-requirement appLevelRequirement CRUD operations\n  org-member           orgMember CRUD operations\n  app-permission-default appPermissionDefault CRUD operations\n  org-permission-default orgPermissionDefault CRUD operations\n  app-admin-grant      appAdminGrant CRUD operations\n  app-owner-grant      appOwnerGrant CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  org-admin-grant      orgAdminGrant CRUD operations\n  org-owner-grant      orgOwnerGrant CRUD operations\n  membership-type      membershipType CRUD operations\n  app-limit            appLimit CRUD operations\n  app-achievement      appAchievement CRUD operations\n  app-step             appStep CRUD operations\n  claimed-invite       claimedInvite CRUD operations\n  org-chart-edge-grant orgChartEdgeGrant CRUD operations\n  org-limit            orgLimit CRUD operations\n  app-grant            appGrant CRUD operations\n  app-membership-default appMembershipDefault CRUD operations\n  org-claimed-invite   orgClaimedInvite CRUD operations\n  org-grant            orgGrant CRUD operations\n  org-chart-edge       orgChartEdge CRUD operations\n  org-membership-default orgMembershipDefault CRUD operations\n  app-level            appLevel CRUD operations\n  invite               invite CRUD operations\n  app-membership       appMembership CRUD operations\n  org-membership       orgMembership CRUD operations\n  org-invite           orgInvite CRUD operations\n  app-permissions-get-padded-mask appPermissionsGetPaddedMask\n  org-permissions-get-padded-mask orgPermissionsGetPaddedMask\n  org-is-manager-of    orgIsManagerOf\n  app-permissions-get-mask appPermissionsGetMask\n  org-permissions-get-mask orgPermissionsGetMask\n  steps-achieved       stepsAchieved\n  app-permissions-get-mask-by-names appPermissionsGetMaskByNames\n  org-permissions-get-mask-by-names orgPermissionsGetMaskByNames\n  app-permissions-get-by-mask Reads and enables pagination through a set of `AppPermission`.\n  org-permissions-get-by-mask Reads and enables pagination through a set of `OrgPermission`.\n  steps-required       Reads and enables pagination through a set of `AppLevelRequirement`.\n  submit-invite-code   submitInviteCode\n  submit-org-invite-code submitOrgInviteCode\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  org-get-managers-record orgGetManagersRecord CRUD operations\n  org-get-subordinates-record orgGetSubordinatesRecord CRUD operations\n  app-permission       appPermission CRUD operations\n  org-permission       orgPermission CRUD operations\n  app-level-requirement appLevelRequirement CRUD operations\n  org-member           orgMember CRUD operations\n  app-permission-default appPermissionDefault CRUD operations\n  org-permission-default orgPermissionDefault CRUD operations\n  app-admin-grant      appAdminGrant CRUD operations\n  app-owner-grant      appOwnerGrant CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  org-admin-grant      orgAdminGrant CRUD operations\n  org-owner-grant      orgOwnerGrant CRUD operations\n  membership-type      membershipType CRUD operations\n  app-limit            appLimit CRUD operations\n  app-achievement      appAchievement CRUD operations\n  app-step             appStep CRUD operations\n  claimed-invite       claimedInvite CRUD operations\n  org-chart-edge-grant orgChartEdgeGrant CRUD operations\n  org-limit            orgLimit CRUD operations\n  app-grant            appGrant CRUD operations\n  app-membership-default appMembershipDefault CRUD operations\n  org-claimed-invite   orgClaimedInvite CRUD operations\n  org-grant            orgGrant CRUD operations\n  org-chart-edge       orgChartEdge CRUD operations\n  org-membership-default orgMembershipDefault CRUD operations\n  app-level            appLevel CRUD operations\n  invite               invite CRUD operations\n  app-membership       appMembership CRUD operations\n  org-membership       orgMembership CRUD operations\n  org-invite           orgInvite CRUD operations\n  app-permissions-get-padded-mask appPermissionsGetPaddedMask\n  org-permissions-get-padded-mask orgPermissionsGetPaddedMask\n  org-is-manager-of    orgIsManagerOf\n  app-permissions-get-mask appPermissionsGetMask\n  org-permissions-get-mask orgPermissionsGetMask\n  steps-achieved       stepsAchieved\n  app-permissions-get-mask-by-names appPermissionsGetMaskByNames\n  org-permissions-get-mask-by-names orgPermissionsGetMaskByNames\n  app-permissions-get-by-mask Reads and enables pagination through a set of `AppPermission`.\n  org-permissions-get-by-mask Reads and enables pagination through a set of `OrgPermission`.\n  steps-required       Reads and enables pagination through a set of `AppLevelRequirement`.\n  submit-invite-code   submitInviteCode\n  submit-org-invite-code submitOrgInviteCode\n  request-upload-url   Request a presigned URL for uploading a file directly to S3.\nClient computes SHA-256 of the file content and provides it here.\nIf a file with the same hash already exists (dedup), returns the\nexisting file ID and deduplicated=true with no uploadUrl.\n  confirm-upload       Confirm that a file has been uploaded to S3.\nVerifies the object exists in S3, checks content-type,\nand transitions the file status from 'pending' to 'ready'.\n  provision-bucket     Provision an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then creates and configures\nthe S3 bucket with the appropriate privacy policies, CORS rules,\nand lifecycle settings.\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/admin/cli/executor.d.ts

@@ -100,5 +100,20 @@ export declare function getClient(contextName?: string): {
         } & import("..").StrictSelect<S, import("../orm/input-types").SubmitOrgInviteCodePayloadSelect>) => import("..").QueryBuilder<{
             submitOrgInviteCode: import("..").InferSelectResult<import("../orm/input-types").SubmitOrgInviteCodePayload, S> | null;
         }>;
+        requestUploadUrl: <S extends import("../orm/input-types").RequestUploadUrlPayloadSelect>(args: import("../orm/mutation").RequestUploadUrlVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").RequestUploadUrlPayloadSelect>) => import("..").QueryBuilder<{
+            requestUploadUrl: import("..").InferSelectResult<import("../orm/input-types").RequestUploadUrlPayload, S> | null;
+        }>;
+        confirmUpload: <S extends import("../orm/input-types").ConfirmUploadPayloadSelect>(args: import("../orm/mutation").ConfirmUploadVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").ConfirmUploadPayloadSelect>) => import("..").QueryBuilder<{
+            confirmUpload: import("..").InferSelectResult<import("../orm/input-types").ConfirmUploadPayload, S> | null;
+        }>;
+        provisionBucket: <S extends import("../orm/input-types").ProvisionBucketPayloadSelect>(args: import("../orm/mutation").ProvisionBucketVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").ProvisionBucketPayloadSelect>) => import("..").QueryBuilder<{
+            provisionBucket: import("..").InferSelectResult<import("../orm/input-types").ProvisionBucketPayload, S> | null;
+        }>;
     };
 };

package/esm/admin/orm/index.d.ts

@@ -163,5 +163,20 @@ export declare function createClient(config: OrmClientConfig): {
         } & import("./select-types").StrictSelect<S, import("./input-types").SubmitOrgInviteCodePayloadSelect>) => import("./query-builder").QueryBuilder<{
             submitOrgInviteCode: import("./select-types").InferSelectResult<import("./input-types").SubmitOrgInviteCodePayload, S> | null;
         }>;
+        requestUploadUrl: <S extends import("./input-types").RequestUploadUrlPayloadSelect>(args: import("./mutation").RequestUploadUrlVariables, options: {
+            select: S;
+        } & import("./select-types").StrictSelect<S, import("./input-types").RequestUploadUrlPayloadSelect>) => import("./query-builder").QueryBuilder<{
+            requestUploadUrl: import("./select-types").InferSelectResult<import("./input-types").RequestUploadUrlPayload, S> | null;
+        }>;
+        confirmUpload: <S extends import("./input-types").ConfirmUploadPayloadSelect>(args: import("./mutation").ConfirmUploadVariables, options: {
+            select: S;
+        } & import("./select-types").StrictSelect<S, import("./input-types").ConfirmUploadPayloadSelect>) => import("./query-builder").QueryBuilder<{
+            confirmUpload: import("./select-types").InferSelectResult<import("./input-types").ConfirmUploadPayload, S> | null;
+        }>;
+        provisionBucket: <S extends import("./input-types").ProvisionBucketPayloadSelect>(args: import("./mutation").ProvisionBucketVariables, options: {
+            select: S;
+        } & import("./select-types").StrictSelect<S, import("./input-types").ProvisionBucketPayloadSelect>) => import("./query-builder").QueryBuilder<{
+            provisionBucket: import("./select-types").InferSelectResult<import("./input-types").ProvisionBucketPayload, S> | null;
+        }>;
     };
 };

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

@@ -2570,6 +2570,26 @@ export interface SubmitOrgInviteCodeInput {
     clientMutationId?: string;
     token?: string;
 }
+export interface RequestUploadUrlInput {
+    /** Bucket key (e.g., "public", "private") */
+    bucketKey: string;
+    /** SHA-256 content hash computed by the client (hex-encoded, 64 chars) */
+    contentHash: string;
+    /** MIME type of the file (e.g., "image/png") */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** Original filename (optional, for display and Content-Disposition) */
+    filename?: string;
+}
+export interface ConfirmUploadInput {
+    /** The file ID returned by requestUploadUrl */
+    fileId: string;
+}
+export interface ProvisionBucketInput {
+    /** The logical bucket key (e.g., "public", "private") */
+    bucketKey: string;
+}
 /** A filter to be used against ConstructiveInternalTypeImage fields. All fields are combined with a logical ‘and.’ */
 export interface ConstructiveInternalTypeImageFilter {
     /** Is null (if `true` is specified) or is not null (if `false` is specified). */
@@ -2755,6 +2775,60 @@ export type SubmitOrgInviteCodePayloadSelect = {
     clientMutationId?: boolean;
     result?: boolean;
 };
+export interface RequestUploadUrlPayload {
+    /** Presigned PUT URL (null if file was deduplicated) */
+    uploadUrl?: string | null;
+    /** The file ID (existing if deduplicated, new if fresh upload) */
+    fileId: string;
+    /** The S3 object key */
+    key: string;
+    /** Whether this file was deduplicated (already exists with same hash) */
+    deduplicated: boolean;
+    /** Presigned URL expiry time (null if deduplicated) */
+    expiresAt?: string | null;
+}
+export type RequestUploadUrlPayloadSelect = {
+    uploadUrl?: boolean;
+    fileId?: boolean;
+    key?: boolean;
+    deduplicated?: boolean;
+    expiresAt?: boolean;
+};
+export interface ConfirmUploadPayload {
+    /** The confirmed file ID */
+    fileId: string;
+    /** New file status */
+    status: string;
+    /** Whether confirmation succeeded */
+    success: boolean;
+}
+export type ConfirmUploadPayloadSelect = {
+    fileId?: boolean;
+    status?: boolean;
+    success?: boolean;
+};
+export interface ProvisionBucketPayload {
+    /** Whether provisioning succeeded */
+    success: boolean;
+    /** The S3 bucket name that was provisioned */
+    bucketName: string;
+    /** The access type applied */
+    accessType: string;
+    /** The storage provider used */
+    provider: string;
+    /** The S3 endpoint (null for AWS S3 default) */
+    endpoint?: string | null;
+    /** Error message if provisioning failed */
+    error?: string | null;
+}
+export type ProvisionBucketPayloadSelect = {
+    success?: boolean;
+    bucketName?: boolean;
+    accessType?: boolean;
+    provider?: boolean;
+    endpoint?: boolean;
+    error?: boolean;
+};
 export interface CreateAppPermissionPayload {
     clientMutationId?: string | null;
     /** The `AppPermission` that was created by this mutation. */

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

@@ -6,13 +6,42 @@
 import { OrmClient } from '../client';
 import { QueryBuilder } from '../query-builder';
 import type { InferSelectResult, StrictSelect } from '../select-types';
-import type { SubmitInviteCodeInput, SubmitOrgInviteCodeInput, SubmitInviteCodePayload, SubmitOrgInviteCodePayload, SubmitInviteCodePayloadSelect, SubmitOrgInviteCodePayloadSelect } from '../input-types';
+import type { SubmitInviteCodeInput, SubmitOrgInviteCodeInput, RequestUploadUrlInput, ConfirmUploadInput, ProvisionBucketInput, SubmitInviteCodePayload, SubmitOrgInviteCodePayload, RequestUploadUrlPayload, ConfirmUploadPayload, ProvisionBucketPayload, SubmitInviteCodePayloadSelect, SubmitOrgInviteCodePayloadSelect, RequestUploadUrlPayloadSelect, ConfirmUploadPayloadSelect, ProvisionBucketPayloadSelect } from '../input-types';
 export interface SubmitInviteCodeVariables {
     input: SubmitInviteCodeInput;
 }
 export interface SubmitOrgInviteCodeVariables {
     input: SubmitOrgInviteCodeInput;
 }
+/**
+ * Variables for requestUploadUrl
+ * Request a presigned URL for uploading a file directly to S3.
+Client computes SHA-256 of the file content and provides it here.
+If a file with the same hash already exists (dedup), returns the
+existing file ID and deduplicated=true with no uploadUrl.
+ */
+export interface RequestUploadUrlVariables {
+    input: RequestUploadUrlInput;
+}
+/**
+ * Variables for confirmUpload
+ * Confirm that a file has been uploaded to S3.
+Verifies the object exists in S3, checks content-type,
+and transitions the file status from 'pending' to 'ready'.
+ */
+export interface ConfirmUploadVariables {
+    input: ConfirmUploadInput;
+}
+/**
+ * Variables for provisionBucket
+ * Provision an S3 bucket for a logical bucket in the database.
+Reads the bucket config via RLS, then creates and configures
+the S3 bucket with the appropriate privacy policies, CORS rules,
+and lifecycle settings.
+ */
+export interface ProvisionBucketVariables {
+    input: ProvisionBucketInput;
+}
 export declare function createMutationOperations(client: OrmClient): {
     submitInviteCode: <S extends SubmitInviteCodePayloadSelect>(args: SubmitInviteCodeVariables, options: {
         select: S;
@@ -24,4 +53,19 @@ export declare function createMutationOperations(client: OrmClient): {
     } & StrictSelect<S, SubmitOrgInviteCodePayloadSelect>) => QueryBuilder<{
         submitOrgInviteCode: InferSelectResult<SubmitOrgInviteCodePayload, S> | null;
     }>;
+    requestUploadUrl: <S extends RequestUploadUrlPayloadSelect>(args: RequestUploadUrlVariables, options: {
+        select: S;
+    } & StrictSelect<S, RequestUploadUrlPayloadSelect>) => QueryBuilder<{
+        requestUploadUrl: InferSelectResult<RequestUploadUrlPayload, S> | null;
+    }>;
+    confirmUpload: <S extends ConfirmUploadPayloadSelect>(args: ConfirmUploadVariables, options: {
+        select: S;
+    } & StrictSelect<S, ConfirmUploadPayloadSelect>) => QueryBuilder<{
+        confirmUpload: InferSelectResult<ConfirmUploadPayload, S> | null;
+    }>;
+    provisionBucket: <S extends ProvisionBucketPayloadSelect>(args: ProvisionBucketVariables, options: {
+        select: S;
+    } & StrictSelect<S, ProvisionBucketPayloadSelect>) => QueryBuilder<{
+        provisionBucket: InferSelectResult<ProvisionBucketPayload, S> | null;
+    }>;
 };

package/esm/admin/orm/mutation/index.js

@@ -26,5 +26,41 @@ export function createMutationOperations(client) {
                 },
             ], connectionFieldsMap, 'SubmitOrgInviteCodePayload'),
         }),
+        requestUploadUrl: (args, options) => new QueryBuilder({
+            client,
+            operation: 'mutation',
+            operationName: 'RequestUploadUrl',
+            fieldName: 'requestUploadUrl',
+            ...buildCustomDocument('mutation', 'RequestUploadUrl', 'requestUploadUrl', options.select, args, [
+                {
+                    name: 'input',
+                    type: 'RequestUploadUrlInput!',
+                },
+            ], connectionFieldsMap, 'RequestUploadUrlPayload'),
+        }),
+        confirmUpload: (args, options) => new QueryBuilder({
+            client,
+            operation: 'mutation',
+            operationName: 'ConfirmUpload',
+            fieldName: 'confirmUpload',
+            ...buildCustomDocument('mutation', 'ConfirmUpload', 'confirmUpload', options.select, args, [
+                {
+                    name: 'input',
+                    type: 'ConfirmUploadInput!',
+                },
+            ], connectionFieldsMap, 'ConfirmUploadPayload'),
+        }),
+        provisionBucket: (args, options) => new QueryBuilder({
+            client,
+            operation: 'mutation',
+            operationName: 'ProvisionBucket',
+            fieldName: 'provisionBucket',
+            ...buildCustomDocument('mutation', 'ProvisionBucket', 'provisionBucket', options.select, args, [
+                {
+                    name: 'input',
+                    type: 'ProvisionBucketInput!',
+                },
+            ], connectionFieldsMap, 'ProvisionBucketPayload'),
+        }),
     };
 }

package/esm/auth/cli/commands/confirm-upload.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation confirmUpload
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/esm/auth/cli/commands/confirm-upload.js

@@ -0,0 +1,34 @@
+import { getClient } from '../executor';
+import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
+export default async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log("confirm-upload - Confirm that a file has been uploaded to S3.\nVerifies the object exists in S3, checks content-type,\nand transitions the file status from 'pending' to 'ready'.\n\nUsage: confirm-upload [OPTIONS]\n");
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = getClient();
+        const parsedAnswers = unflattenDotNotation(answers);
+        const selectFields = buildSelectFromPaths(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .confirmUpload(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: confirmUpload');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};