cf 0.1.0 → 0.3.0

package/dist/r2-data-catalog-Dmipvz5F.mjs

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-import{a as e,f as t,m as n,t as r,u as i}from"./auth-BlSmtIKd.mjs";import{n as a,t as o}from"./body-parser-Br-BoYk-.mjs";import{t as s}from"./output-D7_yAFVR.mjs";import{n as c,t as l}from"./progress-DZfTxbrx.mjs";import{n as u}from"./input-validation-zEO81MWN.mjs";import{t as d}from"./local-VJaJ3BZ1.mjs";function f(e){return e.positional(`bucketName`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`token`,{type:`string`,description:`Provides the Cloudflare API token for accessing R2.`}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1}).option(`body`,{type:`string`,description:`Contains request to store catalog credentials.`})}const p={command:`create <bucketName>`,describe:`Store authentication credentials for a catalog. These credentials are used to authenticate with R2 storage when performing catalog operations.`,builder:f,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog credentials create`,method:`POST`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/credential`,pathParams:{bucketName:String(t.bucketName??``)},bodyKind:`json`,body:{token:t.token,body:t.body}});return}let f=await r(t),p=t.local?d:await e(f);if(t.accountId=p,t.body){let e=o(t.body);s(await l(`Creating`,async()=>f.post(`/accounts/${p}/r2-catalog/${t.bucketName}/credential`,{body:e})),{successLabel:`Created`});return}t.token===void 0&&(t.token=await n(`token`,`Provides the Cloudflare API token for accessing R2.`));let m={};t.token!==void 0&&a(m,[`token`],u(t.token,`token`,`text`)),s(await l(`Creating`,async()=>f.post(`/accounts/${p}/r2-catalog/${t.bucketName}/credential`,{body:Object.keys(m).length>0?m:void 0})),{successLabel:`Created`})}},m={command:`credentials`,describe:`Catalog access credentials for external query engines (Spark, Trino, etc.)`,builder:e=>e.command(p).demandCommand(1,`Please specify a subcommand`),handler:()=>{}};function h(e){return e.positional(`bucketName`,{type:`string`,description:`Specifies the R2 bucket name to disable as catalog.`,demandOption:!0}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1}).option(`force`,{type:`boolean`,alias:`f`,description:`Skip confirmation (useful in scripts and CI)`,default:!1})}const g={command:`disable <bucketName>`,describe:`Disable an R2 bucket as a catalog. This operation deactivates the catalog but preserves existing metadata and data files. The catalog can be re-enabled later.`,builder:h,handler:async n=>{if(n.dryRun){c({command:`cf r2-data-catalog disable`,method:`POST`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${n.bucketName??`<bucketName>`}/disable`,pathParams:{bucketName:String(n.bucketName??``)},bodyKind:`none`});return}let a=await r(n),o=n.local?d:await e(a);if(n.accountId=o,!await t({force:!!n.force,message:`This operation turns off the data catalog for the bucket. Existing namespace or table state remains, but writes stop.`})){process.stderr.write(`Aborted.
-`);return}s(await l(`Deleting`,async()=>a.r2DataCatalog.disable(o,n.bucketName)),{successLabel:`Deleted`})}};function _(e){return e.positional(`bucketName`,{type:`string`,description:`Specifies the R2 bucket name to enable as catalog.`,demandOption:!0}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1})}const v={command:`enable <bucketName>`,describe:`Enable an R2 bucket as an Apache Iceberg catalog. This operation creates the necessary catalog infrastructure and activates the bucket for storing Iceberg metadata and data files.`,builder:_,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog enable`,method:`POST`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/enable`,pathParams:{bucketName:String(t.bucketName??``)},bodyKind:`none`});return}let n=await r(t),a=t.local?d:await e(n);t.accountId=a,s(await l(`Creating`,async()=>n.r2DataCatalog.enable(a,t.bucketName)),{successLabel:`Created`})}};function y(e){return e.positional(`bucketName`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1})}const b={command:`get <bucketName>`,describe:`Retrieve detailed information about a specific R2 catalog by bucket name. Returns catalog status, maintenance configuration, and credential status.`,builder:y,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog get`,method:`GET`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}`,pathParams:{bucketName:String(t.bucketName??``)},bodyKind:`none`});return}let n=await r(t),a=t.local?d:await e(n);t.accountId=a,s(await l(`Loading`,async()=>n.r2DataCatalog.get(a,t.bucketName)),{successLabel:`Loaded`})}};function x(e){return e.option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1})}const S={command:`list`,describe:`Returns a list of R2 buckets that have been enabled as Apache Iceberg catalogs for the specified account. Each catalog represents an R2 bucket configured to store Iceberg metadata and data files.`,builder:x,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog list`,method:`GET`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog`,pathParams:{},bodyKind:`none`});return}let n=await r(t),a=t.local?d:await e(n);t.accountId=a,s(await l(`Loading`,async()=>n.r2DataCatalog.list(a)),{successLabel:`Loaded`})}};function C(e){return e.positional(`bucketName`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1})}const w={command:`get <bucketName>`,describe:`Retrieve the maintenance configuration for a specific catalog, including compaction settings and credential status.`,builder:C,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog maintenance-configs get`,method:`GET`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/maintenance-configs`,pathParams:{bucketName:String(t.bucketName??``)},bodyKind:`none`});return}let n=await r(t),a=t.local?d:await e(n);t.accountId=a,s(await l(`Loading`,async()=>n.r2DataCatalog.maintenanceConfigs.get(a,t.bucketName)),{successLabel:`Loaded`})}};function T(e){return e.positional(`bucketName`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`snapshot-expiration-max-snapshot-age`,{type:`string`,description:`Updates the maximum age for snapshots optionally.`}).option(`snapshot-expiration-min-snapshots-to-keep`,{type:`number`,description:`Updates the minimum number of snapshots to retain optionally.`}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1}).option(`body`,{type:`string`,description:`Contains request to update catalog maintenance configuration.`})}const E={command:`update <bucketName>`,describe:`Update the maintenance configuration for a catalog. This allows you to enable or disable compaction and adjust target file sizes for optimization.`,builder:T,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog maintenance-configs update`,method:`POST`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/maintenance-configs`,pathParams:{bucketName:String(t.bucketName??``)},bodyKind:`json`,body:{snapshotExpirationMaxSnapshotAge:t.snapshotExpirationMaxSnapshotAge,snapshotExpirationMinSnapshotsToKeep:t.snapshotExpirationMinSnapshotsToKeep,body:t.body}});return}let n=await r(t),f=t.local?d:await e(n);if(t.accountId=f,t.body){let e=o(t.body);s(await l(`Creating`,async()=>n.post(`/accounts/${f}/r2-catalog/${t.bucketName}/maintenance-configs`,{body:e})),{successLabel:`Created`});return}let p={};t.snapshotExpirationMaxSnapshotAge!==void 0&&a(p,[`snapshot_expiration`,`max_snapshot_age`],u(t.snapshotExpirationMaxSnapshotAge,`snapshotExpirationMaxSnapshotAge`,`text`)),t.snapshotExpirationMinSnapshotsToKeep!==void 0&&a(p,[`snapshot_expiration`,`min_snapshots_to_keep`],t.snapshotExpirationMinSnapshotsToKeep),s(await l(`Creating`,async()=>n.post(`/accounts/${f}/r2-catalog/${t.bucketName}/maintenance-configs`,{body:Object.keys(p).length>0?p:void 0})),{successLabel:`Created`})}},D={command:`maintenance-configs`,describe:`Table maintenance settings — compaction schedules and snapshot expiration policies`,builder:e=>e.command(w).command(E).demandCommand(1,`Please specify a subcommand`),handler:()=>{}};function O(e){return e.option(`bucket-name`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`page-token`,{type:`string`,description:`Opaque pagination token from a previous response.
-Use this to fetch the next page of results.`}).option(`page-size`,{type:`number`,description:`Maximum number of namespaces to return per page.
-Defaults to 100, maximum 1000.`}).option(`parent`,{type:`string`,description:`Parent namespace to filter by. Only returns direct children of this namespace.
-For nested namespaces, use %1F as separator (e.g., "bronze%1Fanalytics").
-Omit this parameter to list top-level namespaces.`}).option(`return-uuids`,{type:`boolean`,description:`Whether to include namespace UUIDs in the response.
-Set to true to receive the namespace_uuids array.`,default:!1}).option(`return-details`,{type:`boolean`,description:`Whether to include additional metadata (timestamps).
-When true, response includes created_at and updated_at arrays.`,default:!1}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1})}const k={command:`list`,describe:`Returns a list of namespaces in the specified R2 catalog. Supports hierarchical filtering and pagination for efficient traversal of large namespace hierarchies.`,builder:O,handler:async t=>{let n={page_token:t.pageToken,page_size:t.pageSize,parent:t.parent,return_uuids:t.returnUuids,return_details:t.returnDetails};if(t.dryRun){c({command:`cf r2-data-catalog namespaces list`,method:`GET`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/namespaces`,pathParams:{bucketName:String(t.bucketName??``)},query:n,bodyKind:`none`});return}let a=await r(t),o=t.local?d:await e(a);t.accountId=o,s(await l(`Loading`,async()=>a.r2DataCatalog.namespaces.list(o,t.bucketName,n)),{successLabel:`Loaded`})}};function A(e){return e.option(`bucket-name`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`namespace`,{type:`string`,description:`The namespace identifier.
-For nested namespaces, use %1F as separator (e.g., "bronze%1Fanalytics").`,demandOption:!0}).option(`page-token`,{type:`string`,description:`Opaque pagination token from a previous response.
-Use this to fetch the next page of results.`}).option(`page-size`,{type:`number`,description:`Maximum number of tables to return per page.
-Defaults to 100, maximum 1000.`}).option(`return-uuids`,{type:`boolean`,description:`Whether to include table UUIDs in the response.
-Set to true to receive the table_uuids array.`,default:!1}).option(`return-details`,{type:`boolean`,description:`Whether to include additional metadata (timestamps, locations).
-When true, response includes created_at, updated_at, metadata_locations, and locations arrays.`,default:!1}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1})}const j={command:`list`,describe:`Returns a list of tables in the specified namespace within an R2 catalog. Supports pagination for efficient traversal of large table collections.`,builder:A,handler:async t=>{let n={page_token:t.pageToken,page_size:t.pageSize,return_uuids:t.returnUuids,return_details:t.returnDetails};if(t.dryRun){c({command:`cf r2-data-catalog namespaces tables list`,method:`GET`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/namespaces/${t.namespace??`<namespace>`}/tables`,pathParams:{bucketName:String(t.bucketName??``),namespace:String(t.namespace??``)},query:n,bodyKind:`none`});return}let a=await r(t),o=t.local?d:await e(a);t.accountId=o,s(await l(`Loading`,async()=>a.r2DataCatalog.namespaces.tables.list(o,t.bucketName,t.namespace,n)),{successLabel:`Loaded`})}};function M(e){return e.positional(`tableName`,{type:`string`,description:`The table name.`,demandOption:!0}).option(`bucket-name`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`namespace`,{type:`string`,description:`The namespace identifier (use %1F as separator for nested namespaces).`,demandOption:!0}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1})}const N={command:`get <tableName>`,describe:`Retrieve the maintenance configuration for a specific table, including compaction settings.`,builder:M,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog namespaces tables maintenance-configs get`,method:`GET`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/namespaces/${t.namespace??`<namespace>`}/tables/${t.tableName??`<tableName>`}/maintenance-configs`,pathParams:{bucketName:String(t.bucketName??``),namespace:String(t.namespace??``),tableName:String(t.tableName??``)},bodyKind:`none`});return}let n=await r(t),a=t.local?d:await e(n);t.accountId=a,s(await l(`Loading`,async()=>n.r2DataCatalog.namespaces.tables.maintenanceConfigs.get(a,t.bucketName,t.namespace,t.tableName)),{successLabel:`Loaded`})}};function P(e){return e.positional(`tableName`,{type:`string`,description:`The table name.`,demandOption:!0}).option(`bucket-name`,{type:`string`,description:`Specifies the R2 bucket name.`,demandOption:!0}).option(`namespace`,{type:`string`,description:`The namespace identifier (use %1F as separator for nested namespaces).`,demandOption:!0}).option(`snapshot-expiration-max-snapshot-age`,{type:`string`,description:`Updates the maximum age for snapshots optionally.`}).option(`snapshot-expiration-min-snapshots-to-keep`,{type:`number`,description:`Updates the minimum number of snapshots to retain optionally.`}).option(`dry-run`,{type:`boolean`,description:`Validate and show what would happen without executing`,default:!1}).option(`body`,{type:`string`,description:`Contains request to update table maintenance configuration.`})}const F={command:`update <tableName>`,describe:`Update the maintenance configuration for a specific table. This allows you to enable or disable compaction and adjust target file sizes for optimization.`,builder:P,handler:async t=>{if(t.dryRun){c({command:`cf r2-data-catalog namespaces tables maintenance-configs update`,method:`POST`,url:`https://api.cloudflare.com/client/v4/accounts/${i()??`<account-id>`}/r2-catalog/${t.bucketName??`<bucketName>`}/namespaces/${t.namespace??`<namespace>`}/tables/${t.tableName??`<tableName>`}/maintenance-configs`,pathParams:{bucketName:String(t.bucketName??``),namespace:String(t.namespace??``),tableName:String(t.tableName??``)},bodyKind:`json`,body:{snapshotExpirationMaxSnapshotAge:t.snapshotExpirationMaxSnapshotAge,snapshotExpirationMinSnapshotsToKeep:t.snapshotExpirationMinSnapshotsToKeep,body:t.body}});return}let n=await r(t),f=t.local?d:await e(n);if(t.accountId=f,t.body){let e=o(t.body);s(await l(`Creating`,async()=>n.post(`/accounts/${f}/r2-catalog/${t.bucketName}/namespaces/${t.namespace}/tables/${t.tableName}/maintenance-configs`,{body:e})),{successLabel:`Created`});return}let p={};t.snapshotExpirationMaxSnapshotAge!==void 0&&a(p,[`snapshot_expiration`,`max_snapshot_age`],u(t.snapshotExpirationMaxSnapshotAge,`snapshotExpirationMaxSnapshotAge`,`text`)),t.snapshotExpirationMinSnapshotsToKeep!==void 0&&a(p,[`snapshot_expiration`,`min_snapshots_to_keep`],t.snapshotExpirationMinSnapshotsToKeep),s(await l(`Creating`,async()=>n.post(`/accounts/${f}/r2-catalog/${t.bucketName}/namespaces/${t.namespace}/tables/${t.tableName}/maintenance-configs`,{body:Object.keys(p).length>0?p:void 0})),{successLabel:`Created`})}},I={command:`maintenance-configs`,describe:`Logical namespaces that group related tables within the data catalog`,builder:e=>e.command(N).command(F).demandCommand(1,`Please specify a subcommand`),handler:()=>{}},L={command:`tables`,describe:`Logical namespaces that group related tables within the data catalog`,builder:e=>e.command(j).command(I).demandCommand(1,`Please specify a subcommand`),handler:()=>{}},R={command:`namespaces`,describe:`Logical namespaces that group related tables within the data catalog`,builder:e=>e.command(k).command(L).demandCommand(1,`Please specify a subcommand`),handler:()=>{}},z={command:`r2-data-catalog`,describe:`Iceberg-compatible data catalog for R2 — organize objects into tables and namespaces for SQL query engines`,builder:e=>e.command(g).command(v).command(b).command(S).command(m).command(D).command(R).demandCommand(1,`Please specify a subcommand`),handler:()=>{}};export{z as default};