@seliseblocks/cli-os 0.1.3 → 0.1.5

package/dist/commands/auth/oidc-clients/delete.js

@@ -0,0 +1,23 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function authOidcClientsDelete(argv) {
+    const { args, flags } = parseCommand(argv);
+    const clientId = args[0] || stringFlag(flags, "client-id", { required: true });
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: `/iam/v4/oidc-clients/${clientId}` }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Delete OIDC client '${clientId}'. This revokes all issued tokens and is irreversible.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest(`/iam/v4/oidc-clients/${encodeURIComponent(clientId)}`, {
+        impersonatedProjectAuth: true,
+        method: "DELETE",
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/auth/oidc-clients/get.d.ts

@@ -0,0 +1 @@
+export declare function authOidcClientsGet(argv: string[]): Promise<void>;

package/dist/commands/auth/oidc-clients/get.js

@@ -0,0 +1,16 @@
+import { stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function authOidcClientsGet(argv) {
+    const { args, flags } = parseCommand(argv);
+    const clientId = args[0] || stringFlag(flags, "client-id", { required: true });
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest(`/iam/v4/oidc-clients/${encodeURIComponent(clientId)}`, {
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/auth/oidc-clients/list.d.ts

@@ -0,0 +1 @@
+export declare function authOidcClientsList(argv: string[]): Promise<void>;

package/dist/commands/auth/oidc-clients/list.js

@@ -0,0 +1,14 @@
+import { blocksRequest } from "../../../lib/api.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function authOidcClientsList(argv) {
+    const { flags } = parseCommand(argv);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/iam/v4/oidc-clients", {
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/auth/oidc-clients/rotate-secret.d.ts

@@ -0,0 +1 @@
+export declare function authOidcClientsRotateSecret(argv: string[]): Promise<void>;

package/dist/commands/auth/oidc-clients/rotate-secret.js

@@ -0,0 +1,23 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function authOidcClientsRotateSecret(argv) {
+    const { args, flags } = parseCommand(argv);
+    const clientId = args[0] || stringFlag(flags, "client-id", { required: true });
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: `/iam/v4/oidc-clients/${clientId}/rotate-secret` }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Rotate the client secret for OIDC client '${clientId}'. The old secret stops working immediately; the new one is shown once.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest(`/iam/v4/oidc-clients/${encodeURIComponent(clientId)}/rotate-secret`, {
+        impersonatedProjectAuth: true,
+        method: "POST",
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/auth/oidc-clients/save.d.ts

@@ -0,0 +1,2 @@
+/** Upsert: omit --item-id to register a new OIDC client, pass it to update an existing one. */
+export declare function authOidcClientsSave(argv: string[]): Promise<void>;

package/dist/commands/auth/oidc-clients/save.js

@@ -0,0 +1,57 @@
+import { booleanFlag, optionalBooleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { compact, jsonBodyFlag, listFlag } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+/** Upsert: omit --item-id to register a new OIDC client, pass it to update an existing one. */
+export async function authOidcClientsSave(argv) {
+    const { flags } = parseCommand(argv);
+    const body = {
+        ...(await jsonBodyFlag(flags)),
+        ...compact({
+            allowedMfaMethods: listFlag(flags, "allowed-mfa-methods")?.map(Number),
+            allowedResponseTypes: listFlag(flags, "allowed-response-types"),
+            allowedScopes: listFlag(flags, "allowed-scopes"),
+            backChannelLogoutUri: stringFlag(flags, "back-channel-logout-uri") || undefined,
+            clientBrandColor: stringFlag(flags, "client-brand-color") || undefined,
+            clientDisplayName: stringFlag(flags, "client-display-name") || undefined,
+            clientLogoUrl: stringFlag(flags, "client-logo-url") || undefined,
+            clientType: stringFlag(flags, "client-type") || undefined,
+            externalDiscoveryEndpoint: stringFlag(flags, "external-discovery-endpoint") || undefined,
+            frontChannelLogoutUri: stringFlag(flags, "front-channel-logout-uri") || undefined,
+            isActive: optionalBooleanFlag(flags, "active"),
+            isAutoRedirect: optionalBooleanFlag(flags, "auto-redirect"),
+            isDeviceFlowClient: optionalBooleanFlag(flags, "device-flow-client"),
+            itemId: stringFlag(flags, "item-id") || undefined,
+            loginMode: stringFlag(flags, "login-mode") || undefined,
+            postLogoutRedirectUris: listFlag(flags, "post-logout-redirect-uris"),
+            redirectUris: listFlag(flags, "redirect-uris"),
+            registerAsIdentityProvider: optionalBooleanFlag(flags, "register-as-identity-provider"),
+            requireConsent: optionalBooleanFlag(flags, "require-consent"),
+            requireMfa: optionalBooleanFlag(flags, "require-mfa"),
+            requirePkce: optionalBooleanFlag(flags, "require-pkce"),
+            scope: stringFlag(flags, "scope") || undefined,
+            useTokensCookie: optionalBooleanFlag(flags, "use-tokens-cookie")
+        })
+    };
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/iam/v4/oidc-clients", request: redactSecret(body) }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Save OIDC client '${body.clientDisplayName ?? body.itemId ?? "(new)"}'. The response's client secret is shown once.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/iam/v4/oidc-clients", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}
+function redactSecret(body) {
+    if (!body.clientSecret)
+        return body;
+    return { ...body, clientSecret: "***" };
+}

package/dist/commands/auth/refresh.js

@@ -13,7 +13,7 @@ export async function authRefresh(argv) {
     if (!project)
         return;
     if (!config.selectedProject?.tenantId) {
-        throw new Error("No project selected. Run `blocks-os use <tenantId>` first.");
+        throw new Error("No project selected. Run `blocks use <tenantId>` first.");
     }
     const projectToken = store.accounts[account.account]?.projects?.[config.selectedProject.tenantId];
     if (!projectToken?.refreshToken && !projectToken?.accessToken) {

package/dist/commands/data/config/create.d.ts

@@ -0,0 +1 @@
+export declare function dataConfigCreate(argv: string[]): Promise<void>;

package/dist/commands/data/config/create.js

@@ -0,0 +1,38 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { compact, jsonBodyFlag } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataConfigCreate(argv) {
+    const { flags } = parseCommand(argv);
+    const body = {
+        ...(await jsonBodyFlag(flags)),
+        ...compact({
+            connectionString: stringFlag(flags, "connection-string") || undefined,
+            databaseName: stringFlag(flags, "database-name") || undefined
+        })
+    };
+    if (!body.connectionString)
+        throw new Error("Provide --connection-string (or set it in --body/--file).");
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/data/v4/configurations", request: redactSecret(body) }, flags);
+        return;
+    }
+    await confirmMutation(flags, "Create a new data source configuration for this project. This points the Data Gateway at an external database.");
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/configurations", {
+        body: { ...body, projectKey },
+        impersonatedProjectAuth: true,
+        method: "POST",
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}
+function redactSecret(body) {
+    if (!body.connectionString)
+        return body;
+    return { ...body, connectionString: "***" };
+}

package/dist/commands/data/config/get.d.ts

@@ -0,0 +1 @@
+export declare function dataConfigGet(argv: string[]): Promise<void>;

package/dist/commands/data/config/get.js

@@ -0,0 +1,14 @@
+import { blocksRequest } from "../../../lib/api.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataConfigGet(argv) {
+    const { flags } = parseCommand(argv);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/configurations", {
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/config/update.d.ts

@@ -0,0 +1 @@
+export declare function dataConfigUpdate(argv: string[]): Promise<void>;

package/dist/commands/data/config/update.js

@@ -0,0 +1,41 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { compact, jsonBodyFlag } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataConfigUpdate(argv) {
+    const { flags } = parseCommand(argv);
+    const body = {
+        ...(await jsonBodyFlag(flags)),
+        ...compact({
+            collectionNamePattern: stringFlag(flags, "collection-name-pattern") || undefined,
+            connectionString: stringFlag(flags, "connection-string") || undefined,
+            databaseName: stringFlag(flags, "database-name") || undefined,
+            isCollectionNameEditable: booleanFlag(flags, "collection-name-editable") || undefined,
+            itemId: stringFlag(flags, "item-id") || undefined
+        })
+    };
+    if (!body.itemId)
+        throw new Error("Provide --item-id (the existing configuration's id).");
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/data/v4/configurations", request: redactSecret(body) }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Update data source configuration '${body.itemId}'.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/configurations", {
+        body: { ...body, projectKey },
+        impersonatedProjectAuth: true,
+        method: "PUT",
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}
+function redactSecret(body) {
+    if (!body.connectionString)
+        return body;
+    return { ...body, connectionString: "***" };
+}

package/dist/commands/data/files/create-folder.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesCreateFolder(argv: string[]): Promise<void>;

package/dist/commands/data/files/create-folder.js

@@ -0,0 +1,34 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { compact, jsonBodyFlag, listFlag } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesCreateFolder(argv) {
+    const { args, flags } = parseCommand(argv);
+    const artifactName = args[0] || stringFlag(flags, "name", { required: true });
+    const body = {
+        ...(await jsonBodyFlag(flags)),
+        ...compact({
+            artifactName,
+            configurationName: stringFlag(flags, "configuration-name") || undefined,
+            description: stringFlag(flags, "description") || undefined,
+            parentId: stringFlag(flags, "parent-id"),
+            tags: listFlag(flags, "tags")
+        })
+    };
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/data/v4/Files/CreateFolder", request: body }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Create DMS folder '${artifactName}'.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/CreateFolder", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/delete-folder.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesDeleteFolder(argv: string[]): Promise<void>;

package/dist/commands/data/files/delete-folder.js

@@ -0,0 +1,25 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { compact } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesDeleteFolder(argv) {
+    const { args, flags } = parseCommand(argv);
+    const folderId = args[0] || stringFlag(flags, "folder-id", { required: true });
+    const body = { folderId, ...compact({ configurationName: stringFlag(flags, "configuration-name") || undefined }) };
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/data/v4/Files/DeleteFolder", request: body }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Delete DMS folder '${folderId}'.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/DeleteFolder", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/delete.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesDelete(argv: string[]): Promise<void>;

package/dist/commands/data/files/delete.js

@@ -0,0 +1,28 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { compact } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesDelete(argv) {
+    const { args, flags } = parseCommand(argv);
+    const fileId = args[0] || stringFlag(flags, "file-id", { required: true });
+    const body = { fileId, ...compact({
+            configurationName: stringFlag(flags, "configuration-name") || undefined,
+            eventQueueName: stringFlag(flags, "event-queue-name") || undefined
+        }) };
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/data/v4/Files/DeleteFile", request: body }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Delete file '${fileId}'.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/DeleteFile", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/dms-list.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesDmsList(argv: string[]): Promise<void>;

package/dist/commands/data/files/dms-list.js

@@ -0,0 +1,27 @@
+import { integerFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { compact } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesDmsList(argv) {
+    const { flags } = parseCommand(argv);
+    const body = {
+        parentId: stringFlag(flags, "parent-id"),
+        take: integerFlag(flags, "take", 20),
+        ...compact({
+            configurationName: stringFlag(flags, "configuration-name") || undefined,
+            moduleName: stringFlag(flags, "module-name") || undefined,
+            searchKey: stringFlag(flags, "search") || undefined,
+            skip: integerFlag(flags, "skip", 0) || undefined
+        })
+    };
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/GetDmsFileAndFolder", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/dms-upload.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Registers an already-uploaded file (via presigned-upload-url/upload-to-url or
+ * upload-to-local-storage) so it shows up in a DMS folder. `--file-storage-id` covers the
+ * common single-file case; pass --body/--file with an `upload` array to register several at once.
+ */
+export declare function dataFilesDmsUpload(argv: string[]): Promise<void>;

package/dist/commands/data/files/dms-upload.js

@@ -0,0 +1,41 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { compact, jsonBodyFlag, listFlag } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+/**
+ * Registers an already-uploaded file (via presigned-upload-url/upload-to-url or
+ * upload-to-local-storage) so it shows up in a DMS folder. `--file-storage-id` covers the
+ * common single-file case; pass --body/--file with an `upload` array to register several at once.
+ */
+export async function dataFilesDmsUpload(argv) {
+    const { flags } = parseCommand(argv);
+    const fileStorageId = stringFlag(flags, "file-storage-id");
+    const body = await jsonBodyFlag(flags);
+    if (fileStorageId) {
+        body.upload = [compact({
+                artifactName: stringFlag(flags, "artifact-name") || undefined,
+                fileStorageId,
+                parentId: stringFlag(flags, "parent-id"),
+                tags: listFlag(flags, "tags")
+            })];
+    }
+    if (!Array.isArray(body.upload) || !body.upload.length) {
+        throw new Error("Provide --file-storage-id (with --artifact-name) or an 'upload' array via --body/--file.");
+    }
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/data/v4/Files/UploadFile", request: body }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Register ${body.upload.length} file(s) into DMS.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/UploadFile", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/get-many.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesGetMany(argv: string[]): Promise<void>;

package/dist/commands/data/files/get-many.js

@@ -0,0 +1,24 @@
+import { stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { compact, listFlag } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesGetMany(argv) {
+    const { args, flags } = parseCommand(argv);
+    const fileIds = listFlag(flags, "file-ids") ?? args;
+    if (!fileIds.length)
+        throw new Error("Provide file ids as arguments or --file-ids a,b.");
+    const body = compact({
+        configurationName: stringFlag(flags, "configuration-name") || undefined,
+        fileIds
+    });
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/GetFiles", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/get.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesGet(argv: string[]): Promise<void>;

package/dist/commands/data/files/get.js

@@ -0,0 +1,21 @@
+import { integerFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesGet(argv) {
+    const { args, flags } = parseCommand(argv);
+    const fileId = args[0] || stringFlag(flags, "file-id", { required: true });
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/GetFile", {
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey,
+        query: {
+            ConfigurationName: stringFlag(flags, "configuration-name") || undefined,
+            FileId: fileId,
+            Version: integerFlag(flags, "version", 0) || undefined
+        }
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/info.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesInfo(argv: string[]): Promise<void>;

package/dist/commands/data/files/info.js

@@ -0,0 +1,30 @@
+import { booleanFlag, integerFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { compact } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesInfo(argv) {
+    const { flags } = parseCommand(argv);
+    const filter = compact({
+        name: stringFlag(flags, "name") || undefined,
+        tenantId: stringFlag(flags, "tenant-id") || undefined
+    });
+    const body = {
+        filter: Object.keys(filter).length ? filter : undefined,
+        page: integerFlag(flags, "page", 1),
+        pageSize: integerFlag(flags, "page-size", 20),
+        sort: {
+            isDescending: booleanFlag(flags, "sort-desc"),
+            property: stringFlag(flags, "sort-by") || undefined
+        }
+    };
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/GetFilesInfo", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/presigned-upload-url.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cloud-storage upload path, step 1 of 2: get a pre-signed URL, then PUT the file bytes to it
+ * with `data:files:upload-to-url`. For local-storage-backed projects use
+ * `data:files:upload-to-local-storage` instead (single call, no presign step).
+ */
+export declare function dataFilesPresignedUploadUrl(argv: string[]): Promise<void>;

package/dist/commands/data/files/presigned-upload-url.js

@@ -0,0 +1,34 @@
+import { optionalIntegerFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { compact, jsonBodyFlag } from "../../../lib/json-flag.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+/**
+ * Cloud-storage upload path, step 1 of 2: get a pre-signed URL, then PUT the file bytes to it
+ * with `data:files:upload-to-url`. For local-storage-backed projects use
+ * `data:files:upload-to-local-storage` instead (single call, no presign step).
+ */
+export async function dataFilesPresignedUploadUrl(argv) {
+    const { flags } = parseCommand(argv);
+    const body = {
+        ...(await jsonBodyFlag(flags)),
+        ...compact({
+            accessModifier: stringFlag(flags, "access-modifier") || undefined,
+            configurationName: stringFlag(flags, "configuration-name") || undefined,
+            metaData: stringFlag(flags, "meta-data") || undefined,
+            moduleName: optionalIntegerFlag(flags, "module-name"),
+            name: stringFlag(flags, "name", { required: true }),
+            parentDirectoryId: stringFlag(flags, "parent-directory-id"),
+            tags: stringFlag(flags, "tags") || undefined
+        })
+    };
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/GetPreSignedUrlForUpload", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/update-additional-info.d.ts

@@ -0,0 +1 @@
+export declare function dataFilesUpdateAdditionalInfo(argv: string[]): Promise<void>;

package/dist/commands/data/files/update-additional-info.js

@@ -0,0 +1,26 @@
+import { booleanFlag, stringFlag } from "../../../lib/args.js";
+import { blocksRequest } from "../../../lib/api.js";
+import { confirmMutation } from "../../../lib/confirm.js";
+import { writeOutput } from "../../../lib/output.js";
+import { requestContext } from "../../../lib/request-context.js";
+import { parseCommand, selectedProject } from "../../../lib/workspace.js";
+export async function dataFilesUpdateAdditionalInfo(argv) {
+    const { args, flags } = parseCommand(argv);
+    const itemId = args[0] || stringFlag(flags, "item-id", { required: true });
+    const additionalPropertiesRaw = stringFlag(flags, "additional-properties", { required: true });
+    const additionalProperties = JSON.parse(additionalPropertiesRaw);
+    const body = { additionalProperties, itemId };
+    if (booleanFlag(flags, "dry-run")) {
+        writeOutput({ dryRun: true, endpoint: "/data/v4/Files/UpdateFileAdditionalInfo", request: body }, flags);
+        return;
+    }
+    await confirmMutation(flags, `Update additional info for file '${itemId}'.`);
+    const projectKey = await selectedProject(flags);
+    const result = await blocksRequest("/data/v4/Files/UpdateFileAdditionalInfo", {
+        body,
+        impersonatedProjectAuth: true,
+        ...requestContext(flags),
+        projectTenantId: projectKey
+    });
+    writeOutput(result, flags);
+}

package/dist/commands/data/files/upload-to-local-storage.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The one-call alternative to presigned-upload-url + upload-to-url, for projects backed
+ * by local storage (not cloud object storage). Sends multipart/form-data with the file bytes.
+ */
+export declare function dataFilesUploadToLocalStorage(argv: string[]): Promise<void>;