@keboola/api-client 2.0.0 → 3.0.1

package/dist/domain/storageTable/index.js

@@ -0,0 +1,264 @@
+import { z } from 'zod';
+
+// src/domain/storageTable/constants.ts
+var BRANCH_PREFIX_REGEX = /^(\d+)-(.+)$/;
+var LEGACY_BUCKET_PREFIX = "c-";
+var NAME_CHARSET_REGEX = /^[a-zA-Z0-9_-]+$/;
+var NAME_MAX_LENGTH = 96;
+var stageSchema = z.enum(["in", "out"]);
+var nameSchema = z.string().min(1, `Invalid name segment: must not be empty`).max(NAME_MAX_LENGTH, `Invalid name segment: exceeds ${NAME_MAX_LENGTH} characters`).refine((n) => !n.startsWith("_"), `Invalid name segment: must not start with an underscore`).regex(NAME_CHARSET_REGEX, `Invalid name segment: contains invalid characters`);
+var tableIdSchema = z.string().refine(
+  (id) => id.split(".").length === 3,
+  'Invalid table id: must be in "{stage}.{bucket}.{table}" form'
+).transform((id) => id.split(".")).pipe(z.tuple([stageSchema, nameSchema, nameSchema]));
+var bucketIdSchema = z.string().refine(
+  (id) => id.split(".").length === 2,
+  'Invalid bucket id: must be in "{stage}.{bucket}" form'
+).transform((id) => id.split(".")).pipe(z.tuple([stageSchema, nameSchema]));
+
+// src/domain/storageTable/codec.ts
+var createBucketCodec = ({
+  useLegacyBucketPrefix,
+  hasProtectedDefaultBranch,
+  hasStorageBranches
+}) => {
+  const decode = (name) => {
+    const hasLegacyPrefix = useLegacyBucketPrefix && name.startsWith(LEGACY_BUCKET_PREFIX);
+    const stripped = hasLegacyPrefix ? name.slice(LEGACY_BUCKET_PREFIX.length) : name;
+    if (hasProtectedDefaultBranch || hasStorageBranches)
+      return {
+        kind: "storage-branch",
+        baseName: stripped,
+        hasLegacyPrefix
+      };
+    const branchMatch = BRANCH_PREFIX_REGEX.exec(stripped);
+    return {
+      kind: "legacy",
+      hasLegacyPrefix,
+      branchId: branchMatch?.[1] ?? null,
+      baseName: branchMatch?.[2] ?? stripped
+    };
+  };
+  const encode = (bucket) => {
+    const stageResult = stageSchema.safeParse(bucket.stage);
+    if (!stageResult.success) return { success: false, error: stageResult.error };
+    const prefix = bucket.hasLegacyPrefix ? LEGACY_BUCKET_PREFIX : "";
+    const baseNameResult = nameSchema.safeParse(bucket.baseName);
+    if (!baseNameResult.success) return { success: false, error: baseNameResult.error };
+    if (bucket.kind === "storage-branch") {
+      const prefixedName2 = `${prefix}${bucket.baseName}`;
+      return {
+        success: true,
+        data: {
+          kind: "storage-branch",
+          id: `${bucket.stage}.${prefixedName2}`,
+          prefixedName: prefixedName2
+        }
+      };
+    }
+    const branch = bucket.branchId ? `${bucket.branchId}-` : "";
+    const branchedName = `${branch}${bucket.baseName}`;
+    const prefixedName = `${prefix}${branchedName}`;
+    return {
+      success: true,
+      data: {
+        kind: "legacy",
+        id: `${bucket.stage}.${prefixedName}`,
+        prefixedName,
+        branchedName
+      }
+    };
+  };
+  return { decode, encode };
+};
+
+// src/domain/storageTable/model.ts
+var createTableModel = (options) => {
+  const codec = createBucketCodec(options);
+  const decodeTable = (stage, bucketName, tableName) => ({
+    name: tableName,
+    bucket: { ...codec.decode(bucketName), stage }
+  });
+  const serializeBucketDisplayName = (bucket) => {
+    const result = codec.encode(bucket);
+    if (!result.success) throw result.error;
+    return result.data.kind === "storage-branch" ? bucket.baseName : result.data.branchedName;
+  };
+  const serializeBucketName = (bucket) => {
+    const result = codec.encode(bucket);
+    if (!result.success) throw result.error;
+    return result.data.prefixedName;
+  };
+  const serializeBucketId = (bucket) => {
+    const result = codec.encode(bucket);
+    if (!result.success) throw result.error;
+    return result.data.id;
+  };
+  const serializeTableId = (table) => `${serializeBucketId(table.bucket)}.${nameSchema.parse(table.name)}`;
+  const safeSerializeBucketName = (bucket) => {
+    const result = codec.encode(bucket);
+    if (!result.success) return null;
+    return result.data.prefixedName;
+  };
+  const safeSerializeBucketId = (bucket) => {
+    const result = codec.encode(bucket);
+    if (!result.success) return null;
+    return result.data.id;
+  };
+  const safeSerializeTableId = (table) => {
+    const bucketId = safeSerializeBucketId(table.bucket);
+    const tableNameResult = nameSchema.safeParse(table.name);
+    if (!bucketId || !tableNameResult.success) return null;
+    return `${bucketId}.${tableNameResult.data}`;
+  };
+  const parse = (id) => {
+    const data = tableIdSchema.parse(id);
+    return decodeTable(...data);
+  };
+  const safeParse = (id) => {
+    const parseResult = tableIdSchema.safeParse(id);
+    if (!parseResult.success) return null;
+    return decodeTable(...parseResult.data);
+  };
+  const parseBucket = (id) => {
+    const [stage, bucketName] = bucketIdSchema.parse(id);
+    return { ...codec.decode(bucketName), stage };
+  };
+  const safeParseBucket = (id) => {
+    const parseResult = bucketIdSchema.safeParse(id);
+    if (!parseResult.success) return null;
+    const [stage, bucketName] = parseResult.data;
+    return { ...codec.decode(bucketName), stage };
+  };
+  const createBucket = (input) => {
+    const decoded = codec.decode(input.name);
+    if (decoded.kind === "storage-branch")
+      return { ...decoded, stage: input.stage, hasLegacyPrefix: options.useLegacyBucketPrefix };
+    return {
+      ...decoded,
+      stage: input.stage,
+      hasLegacyPrefix: options.useLegacyBucketPrefix,
+      branchId: input.branchId ?? decoded.branchId
+    };
+  };
+  const createTable = (input) => ({
+    name: input.tableName,
+    bucket: createBucket({ stage: input.stage, name: input.bucketName, branchId: input.branchId })
+  });
+  return {
+    parse,
+    safeParse,
+    parseBucket,
+    safeParseBucket,
+    createTable,
+    createBucket,
+    serializeTableId,
+    serializeBucketId,
+    serializeBucketName,
+    serializeBucketDisplayName,
+    safeSerializeTableId,
+    safeSerializeBucketId,
+    safeSerializeBucketName
+  };
+};
+
+// src/domain/storageTable/utils.ts
+var webalize = (str) => {
+  const out = str.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^a-z0-9\-_]/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").replace(/^_+/, "").slice(0, NAME_MAX_LENGTH).replace(/-+$/g, "");
+  if (out.length === 0) {
+    throw new Error(`Cannot webalize "${str}" into a valid name segment`);
+  }
+  return out;
+};
+
+// src/domain/storageTable/createStorageTable.ts
+var createStorageTable = (flags) => {
+  const model = createTableModel(flags);
+  const branchIt = (bucket, branchId) => bucket.kind !== "legacy" ? bucket : { ...bucket, branchId };
+  const unbranchIt = (bucket, branchId) => bucket.kind !== "legacy" || bucket.branchId !== branchId ? bucket : { ...bucket, branchId: null };
+  const make = (bucket, tableName) => {
+    const self = {
+      bucket,
+      name: tableName,
+      isInBranch: (branchId) => bucket.kind === "legacy" && bucket.branchId === branchId,
+      addBranch: (branchId) => {
+        if (branchId.length === 0) throw new Error("branchId is required");
+        return make(branchIt(bucket, branchId), tableName);
+      },
+      removeBranch: (branchId) => {
+        if (branchId.length === 0) throw new Error("branchId is required");
+        return make(unbranchIt(bucket, branchId), tableName);
+      },
+      addTableName: (name) => {
+        if (name.length === 0) throw new Error("tableName is required");
+        return make(bucket, name);
+      },
+      getBucketName: () => model.serializeBucketName(bucket),
+      getBucketDisplayName: () => model.serializeBucketDisplayName(bucket),
+      getBucketBaseName: () => bucket.baseName,
+      getTableName: () => {
+        if (tableName === null)
+          throw new Error(
+            "getTableName() requires a table name \u2014 instance was built via createBucket"
+          );
+        return tableName;
+      },
+      getBucketId: () => model.serializeBucketId(bucket),
+      getTableId: () => model.serializeTableId({ bucket, name: tableName ?? "" }),
+      getSafeBucketId: () => model.safeSerializeBucketId(bucket),
+      getSafeTableId: () => model.safeSerializeTableId({ bucket, name: tableName ?? "" })
+    };
+    return self;
+  };
+  const parse = (id) => {
+    const table = model.parse(id);
+    return make(table.bucket, table.name);
+  };
+  const safeParse = (id) => {
+    const table = model.safeParse(id);
+    return table ? make(table.bucket, table.name) : null;
+  };
+  const parseBucket = (id) => make(model.parseBucket(id), null);
+  const safeParseBucket = (id) => {
+    const bucket = model.safeParseBucket(id);
+    return bucket ? make(bucket, null) : null;
+  };
+  const createTable = (input) => {
+    const { bucket, name } = model.createTable(input);
+    return make(bucket, name);
+  };
+  const createBucket = (input) => make(model.createBucket(input), null);
+  return {
+    // generic
+    parse,
+    safeParse,
+    parseBucket,
+    safeParseBucket,
+    createTable,
+    createBucket,
+    // Business
+    createDefaultCsvImportTable: (configId) => {
+      const bucketName = flags.useLegacyBucketPrefix ? "c-csv-import" : webalize(`keboola.csv-import-${configId}`);
+      const tableName = flags.useLegacyBucketPrefix ? configId : "data";
+      return createTable({
+        stage: "in",
+        tableName,
+        bucketName
+      });
+    },
+    createDefaultBucket: ({ stage, name }) => createBucket({ stage, name: webalize(name) }),
+    safeCreateDefaultBucket: ({ stage, name }) => {
+      try {
+        return createBucket({ stage, name: webalize(name) });
+      } catch {
+        return null;
+      }
+    },
+    createDefaultConfigBucket: ({ stage, componentId, configId }) => createBucket({ stage, name: webalize(`${componentId}-${configId}`) }),
+    createDefaultConfigTable: ({ stage, componentId, configId, tableName }) => createTable({ stage, bucketName: webalize(`${componentId}-${configId}`), tableName })
+  };
+};
+
+export { createStorageTable, createTableModel };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/domain/storageTable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/domain/storageTable/constants.ts","../../../src/domain/storageTable/schema.ts","../../../src/domain/storageTable/codec.ts","../../../src/domain/storageTable/model.ts","../../../src/domain/storageTable/utils.ts","../../../src/domain/storageTable/createStorageTable.ts"],"names":["prefixedName"],"mappings":"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","file":"index.js","sourcesContent":["/** Matches a numeric dev-branch prefix on a legacy-prefix-stripped bucket name. */\nexport const BRANCH_PREFIX_REGEX = /^(\\d+)-(.+)$/;\n/** Historical `c-` prefix Storage prepends to legacy bucket names. */\nexport const LEGACY_BUCKET_PREFIX = 'c-';\n/** Characters allowed in a bucket or table name segment. */\nexport const NAME_CHARSET_REGEX = /^[a-zA-Z0-9_-]+$/;\n/** Max length of a bucket or table name segment. */\nexport const NAME_MAX_LENGTH = 96;\n","import { z } from 'zod';\n\nimport { NAME_CHARSET_REGEX, NAME_MAX_LENGTH } from './constants';\n\nexport const stageSchema = z.enum(['in', 'out']);\n\nexport const nameSchema = z\n  .string()\n  .min(1, `Invalid name segment: must not be empty`)\n  .max(NAME_MAX_LENGTH, `Invalid name segment: exceeds ${NAME_MAX_LENGTH} characters`)\n  .refine((n) => !n.startsWith('_'), `Invalid name segment: must not start with an underscore`)\n  .regex(NAME_CHARSET_REGEX, `Invalid name segment: contains invalid characters`);\n\nexport const tableIdSchema = z\n  .string()\n  .refine(\n    (id) => id.split('.').length === 3,\n    'Invalid table id: must be in \"{stage}.{bucket}.{table}\" form',\n  )\n  .transform((id) => id.split('.') as [string, string, string])\n  .pipe(z.tuple([stageSchema, nameSchema, nameSchema]));\n\nexport const bucketIdSchema = z\n  .string()\n  .refine(\n    (id) => id.split('.').length === 2,\n    'Invalid bucket id: must be in \"{stage}.{bucket}\" form',\n  )\n  .transform((id) => id.split('.') as [string, string])\n  .pipe(z.tuple([stageSchema, nameSchema]));\n","import type z from 'zod';\n\nimport { BRANCH_PREFIX_REGEX, LEGACY_BUCKET_PREFIX } from './constants';\nimport { nameSchema, stageSchema } from './schema';\nimport type {\n  Bucket,\n  BucketId,\n  BucketName,\n  LegacyBucket,\n  ModelOptions,\n  ParsedBucket,\n  StorageBranchBucket,\n} from './types';\n\ntype EncodedBucket =\n  | {\n      kind: 'legacy';\n      id: BucketId;\n      /** baseName + `{branchId}-` prefix, without `c-`. User-facing. e.g. `123-main` */\n      branchedName: BucketName;\n      /** baseName + branch + `c-` prefix. On-disk (Storage `bucket.name`). e.g. `c-123-main` */\n      prefixedName: BucketName;\n    }\n  | {\n      kind: 'storage-branch';\n      id: BucketId;\n      /** baseName + `c-` prefix when hasLegacyPrefix. On-disk (Storage `bucket.name`). e.g. `c-main` */\n      prefixedName: BucketName;\n    };\n\nexport const createBucketCodec = ({\n  useLegacyBucketPrefix,\n  hasProtectedDefaultBranch,\n  hasStorageBranches,\n}: ModelOptions) => {\n  const decode = (name: BucketName): ParsedBucket => {\n    const hasLegacyPrefix = useLegacyBucketPrefix && name.startsWith(LEGACY_BUCKET_PREFIX);\n    const stripped = hasLegacyPrefix ? name.slice(LEGACY_BUCKET_PREFIX.length) : name;\n\n    // Native branched storage: branch is BE-side (no `{branchId}-` decoration), but the\n    // legacy `c-` prefix is still applied independently of the branch model.\n    if (hasProtectedDefaultBranch || hasStorageBranches)\n      return {\n        kind: 'storage-branch',\n        baseName: stripped,\n        hasLegacyPrefix,\n      } satisfies StorageBranchBucket;\n\n    const branchMatch = BRANCH_PREFIX_REGEX.exec(stripped);\n\n    return {\n      kind: 'legacy',\n      hasLegacyPrefix,\n      branchId: branchMatch?.[1] ?? null,\n      baseName: branchMatch?.[2] ?? stripped,\n    } satisfies LegacyBucket;\n  };\n\n  const encode = (\n    bucket: Bucket,\n  ): { success: true; data: EncodedBucket } | { success: false; error: z.ZodError<string> } => {\n    const stageResult = stageSchema.safeParse(bucket.stage);\n    if (!stageResult.success) return { success: false, error: stageResult.error };\n\n    const prefix = bucket.hasLegacyPrefix ? LEGACY_BUCKET_PREFIX : '';\n    const baseNameResult = nameSchema.safeParse(bucket.baseName);\n    if (!baseNameResult.success) return { success: false, error: baseNameResult.error };\n\n    if (bucket.kind === 'storage-branch') {\n      const prefixedName = `${prefix}${bucket.baseName}`;\n\n      return {\n        success: true,\n        data: {\n          kind: 'storage-branch',\n          id: `${bucket.stage}.${prefixedName}` satisfies BucketId,\n          prefixedName,\n        },\n      };\n    }\n\n    const branch = bucket.branchId ? `${bucket.branchId}-` : '';\n    const branchedName = `${branch}${bucket.baseName}`;\n    const prefixedName = `${prefix}${branchedName}`;\n\n    return {\n      success: true,\n      data: {\n        kind: 'legacy',\n        id: `${bucket.stage}.${prefixedName}` satisfies BucketId,\n        prefixedName,\n        branchedName,\n      },\n    };\n  };\n\n  return { decode, encode };\n};\n","import { createBucketCodec } from './codec';\nimport { bucketIdSchema, nameSchema, tableIdSchema } from './schema';\nimport type {\n  Bucket,\n  BucketId,\n  BucketName,\n  BucketStage,\n  ModelOptions,\n  Table,\n  TableId,\n  TableName,\n} from './types';\n\nexport type CreateBucketFn = (input: {\n  stage: BucketStage;\n  name: BucketName;\n  branchId?: string | null;\n}) => Bucket;\n\nexport type CreateTableFn = (input: {\n  stage: BucketStage;\n  tableName: TableName;\n  bucketName: BucketName;\n  branchId?: string | null;\n}) => Table;\n\nexport type TableModel = {\n  parse(id: string): Table;\n  parseBucket(id: string): Bucket;\n\n  safeParse(id: string): Table | null;\n  safeParseBucket(id: string): Bucket | null;\n\n  serializeTableId(table: Table): TableId;\n  serializeBucketId(bucket: Bucket): BucketId;\n  serializeBucketName(bucket: Bucket): BucketName;\n  serializeBucketDisplayName(bucket: Bucket): BucketName;\n\n  safeSerializeTableId(table: Table): TableId | null;\n  safeSerializeBucketId(bucket: Bucket): BucketId | null;\n  safeSerializeBucketName(bucket: Bucket): BucketName | null;\n\n  createTable: CreateTableFn;\n  createBucket: CreateBucketFn;\n};\n\nexport const createTableModel = (options: ModelOptions): TableModel => {\n  const codec = createBucketCodec(options);\n\n  const decodeTable = (stage: BucketStage, bucketName: string, tableName: string): Table => ({\n    name: tableName,\n    bucket: { ...codec.decode(bucketName), stage },\n  });\n\n  const serializeBucketDisplayName = (bucket: Bucket) => {\n    const result = codec.encode(bucket);\n    if (!result.success) throw result.error;\n    // Storage-branch display name is just the bare baseName (no branch decoration to apply);\n    // encode is still called so the empty-name guard throws consistently.\n    return result.data.kind === 'storage-branch' ? bucket.baseName : result.data.branchedName;\n  };\n\n  const serializeBucketName = (bucket: Bucket) => {\n    const result = codec.encode(bucket);\n    if (!result.success) throw result.error;\n    return result.data.prefixedName;\n  };\n\n  const serializeBucketId = (bucket: Bucket): BucketId => {\n    const result = codec.encode(bucket);\n    if (!result.success) throw result.error;\n    return result.data.id;\n  };\n\n  const serializeTableId = (table: Table): TableId =>\n    `${serializeBucketId(table.bucket)}.${nameSchema.parse(table.name)}`;\n\n  // Safe counterparts: return null instead of throwing when a required segment is empty.\n  const safeSerializeBucketName = (bucket: Bucket): BucketName | null => {\n    const result = codec.encode(bucket);\n    if (!result.success) return null;\n    return result.data.prefixedName;\n  };\n\n  const safeSerializeBucketId = (bucket: Bucket): BucketId | null => {\n    const result = codec.encode(bucket);\n    if (!result.success) return null;\n    return result.data.id;\n  };\n\n  const safeSerializeTableId = (table: Table): TableId | null => {\n    const bucketId = safeSerializeBucketId(table.bucket);\n    const tableNameResult = nameSchema.safeParse(table.name);\n    if (!bucketId || !tableNameResult.success) return null;\n    return `${bucketId}.${tableNameResult.data}`;\n  };\n\n  const parse = (id: string) => {\n    const data = tableIdSchema.parse(id);\n    return decodeTable(...data);\n  };\n\n  const safeParse = (id: string): Table | null => {\n    const parseResult = tableIdSchema.safeParse(id);\n    if (!parseResult.success) return null;\n    return decodeTable(...parseResult.data);\n  };\n\n  const parseBucket = (id: string): Bucket => {\n    const [stage, bucketName] = bucketIdSchema.parse(id);\n    return { ...codec.decode(bucketName), stage };\n  };\n\n  const safeParseBucket = (id: string): Bucket | null => {\n    const parseResult = bucketIdSchema.safeParse(id);\n    if (!parseResult.success) return null;\n    const [stage, bucketName] = parseResult.data;\n    return { ...codec.decode(bucketName), stage };\n  };\n\n  const createBucket: CreateBucketFn = (input) => {\n    // Normalize the input the same way decoding does (strips a `c-`/`{branchId}-`\n    // a caller may have passed), so `baseName` always holds the bare name.\n    const decoded = codec.decode(input.name);\n    // On create the prefix is decided by the project flag — not by whether the\n    // input happened to start with `c-`. This applies to both bucket models.\n    if (decoded.kind === 'storage-branch')\n      return { ...decoded, stage: input.stage, hasLegacyPrefix: options.useLegacyBucketPrefix };\n\n    return {\n      ...decoded,\n      stage: input.stage,\n      hasLegacyPrefix: options.useLegacyBucketPrefix,\n      branchId: input.branchId ?? decoded.branchId,\n    };\n  };\n\n  const createTable: CreateTableFn = (input) => ({\n    name: input.tableName,\n    bucket: createBucket({ stage: input.stage, name: input.bucketName, branchId: input.branchId }),\n  });\n\n  return {\n    parse,\n    safeParse,\n    parseBucket,\n    safeParseBucket,\n\n    createTable,\n    createBucket,\n\n    serializeTableId,\n    serializeBucketId,\n    serializeBucketName,\n    serializeBucketDisplayName,\n\n    safeSerializeTableId,\n    safeSerializeBucketId,\n    safeSerializeBucketName,\n  };\n};\n","import { NAME_MAX_LENGTH } from './constants';\n\nexport const webalize = (str: string): string => {\n  const out = str\n    .normalize('NFD')\n    .replace(/\\p{M}/gu, '') // strip diacritics after NFD decomposition: á→a, č→c, ý→y …\n    .toLowerCase()\n    .replace(/[^a-z0-9\\-_]/g, '-')\n    .replace(/-+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .replace(/^_+/, '')\n    .slice(0, NAME_MAX_LENGTH)\n    .replace(/-+$/g, '');\n\n  if (out.length === 0) {\n    throw new Error(`Cannot webalize \"${str}\" into a valid name segment`);\n  }\n\n  return out;\n};\n","import { type CreateBucketFn, type CreateTableFn, createTableModel } from './model';\nimport type {\n  Bucket,\n  BucketId,\n  BucketName,\n  BucketStage,\n  ModelOptions,\n  TableId,\n  TableName,\n} from './types';\nimport { webalize } from './utils';\n\nexport type StorageTableInstance = {\n  readonly bucket: Bucket;\n  readonly name: TableName | null;\n  isInBranch(branchId: string): boolean;\n  addBranch(branchId: string): StorageTableInstance;\n  removeBranch(branchId: string): StorageTableInstance;\n  /** A new instance with the table name set (or replaced). */\n  addTableName(tableName: TableName): StorageTableInstance;\n  getBucketName(): BucketName;\n  /** Bucket name as shown to users: dev-branch prefix kept, legacy `c-` prefix always dropped. */\n  getBucketDisplayName(): BucketName;\n  /** Bare bucket name: no `c-` prefix, no dev-branch prefix (legacy `baseName`, or the canonical storage-branch name). */\n  getBucketBaseName(): BucketName;\n  getBucketId(): BucketId;\n  getSafeBucketId(): BucketId | null;\n  /** @throws when there is no table name (the instance was built via `createBucket`). */\n  getTableName(): TableName;\n  /** @throws when there is no table name (the instance was built via `createBucket`). */\n  getTableId(): TableId;\n  /** Null when there is no table name (built via `createBucket`) or a segment is empty. */\n  getSafeTableId(): TableId | null;\n};\n\nexport type StorageTable = {\n  parse(id: string): StorageTableInstance;\n  safeParse(id: string): StorageTableInstance | null;\n  /** Decode a bucket id (`{stage}.{bucket}`) into a bucket-only instance. */\n  parseBucket(id: string): StorageTableInstance;\n  safeParseBucket(id: string): StorageTableInstance | null;\n  createTable(input: Parameters<CreateTableFn>[0]): StorageTableInstance;\n  createBucket(input: Parameters<CreateBucketFn>[0]): StorageTableInstance;\n\n  // Business\n  createDefaultBucket(input: { stage: BucketStage; name: string }): StorageTableInstance;\n  /** Like `createDefaultBucket`, but returns null instead of throwing when the name sanitizes to an empty/invalid segment. */\n  safeCreateDefaultBucket(input: { stage: BucketStage; name: string }): StorageTableInstance | null;\n  createDefaultConfigBucket(input: {\n    stage: BucketStage;\n    componentId: string;\n    configId: string;\n  }): StorageTableInstance;\n  createDefaultConfigTable(input: {\n    stage: BucketStage;\n    componentId: string;\n    configId: string;\n    tableName: string;\n  }): StorageTableInstance;\n  createDefaultCsvImportTable(configId: string): StorageTableInstance;\n};\n\nexport const createStorageTable = (flags: ModelOptions): StorageTable => {\n  const model = createTableModel(flags);\n\n  const branchIt = (bucket: Bucket, branchId: string): Bucket =>\n    bucket.kind !== 'legacy' ? bucket : { ...bucket, branchId };\n\n  const unbranchIt = (bucket: Bucket, branchId: string): Bucket =>\n    bucket.kind !== 'legacy' || bucket.branchId !== branchId\n      ? bucket\n      : { ...bucket, branchId: null };\n\n  const make = (bucket: Bucket, tableName: TableName | null): StorageTableInstance => {\n    const self: StorageTableInstance = {\n      bucket,\n      name: tableName,\n      isInBranch: (branchId) => bucket.kind === 'legacy' && bucket.branchId === branchId,\n      addBranch: (branchId) => {\n        if (branchId.length === 0) throw new Error('branchId is required');\n        return make(branchIt(bucket, branchId), tableName);\n      },\n      removeBranch: (branchId) => {\n        if (branchId.length === 0) throw new Error('branchId is required');\n        return make(unbranchIt(bucket, branchId), tableName);\n      },\n      addTableName: (name) => {\n        if (name.length === 0) throw new Error('tableName is required');\n        return make(bucket, name);\n      },\n\n      getBucketName: () => model.serializeBucketName(bucket),\n      getBucketDisplayName: () => model.serializeBucketDisplayName(bucket),\n      getBucketBaseName: () => bucket.baseName,\n      getTableName: () => {\n        if (tableName === null)\n          throw new Error(\n            'getTableName() requires a table name — instance was built via createBucket',\n          );\n        return tableName;\n      },\n\n      getBucketId: () => model.serializeBucketId(bucket),\n      getTableId: () => model.serializeTableId({ bucket, name: tableName ?? '' }),\n\n      getSafeBucketId: () => model.safeSerializeBucketId(bucket),\n      getSafeTableId: () => model.safeSerializeTableId({ bucket, name: tableName ?? '' }),\n    };\n\n    return self;\n  };\n\n  const parse = (id: TableId) => {\n    const table = model.parse(id);\n    return make(table.bucket, table.name);\n  };\n  const safeParse = (id: TableId) => {\n    const table = model.safeParse(id);\n    return table ? make(table.bucket, table.name) : null;\n  };\n\n  const parseBucket = (id: BucketId) => make(model.parseBucket(id), null);\n\n  const safeParseBucket = (id: BucketId) => {\n    const bucket = model.safeParseBucket(id);\n    return bucket ? make(bucket, null) : null;\n  };\n\n  const createTable = (input: Parameters<CreateTableFn>[0]) => {\n    const { bucket, name } = model.createTable(input);\n    return make(bucket, name);\n  };\n\n  const createBucket = (input: Parameters<CreateBucketFn>[0]): StorageTableInstance =>\n    make(model.createBucket(input), null);\n\n  return {\n    // generic\n    parse,\n    safeParse,\n    parseBucket,\n    safeParseBucket,\n    createTable,\n    createBucket,\n\n    // Business\n    createDefaultCsvImportTable: (configId: string) => {\n      const bucketName = flags.useLegacyBucketPrefix\n        ? 'c-csv-import'\n        : webalize(`keboola.csv-import-${configId}`);\n      const tableName = flags.useLegacyBucketPrefix ? configId : 'data';\n\n      return createTable({\n        stage: 'in',\n        tableName,\n        bucketName,\n      });\n    },\n    createDefaultBucket: ({ stage, name }) => createBucket({ stage, name: webalize(name) }),\n    safeCreateDefaultBucket: ({ stage, name }) => {\n      try {\n        return createBucket({ stage, name: webalize(name) });\n      } catch {\n        // webalize() throws when the input sanitizes to an empty name segment — surface as null per the safe-* contract\n        return null;\n      }\n    },\n    createDefaultConfigBucket: ({ stage, componentId, configId }) =>\n      createBucket({ stage, name: webalize(`${componentId}-${configId}`) }),\n    createDefaultConfigTable: ({ stage, componentId, configId, tableName }) =>\n      createTable({ stage, bucketName: webalize(`${componentId}-${configId}`), tableName }),\n  };\n};\n"]}

package/dist/editor/index.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkTIIRBQUA_cjs = require('../chunk-TIIRBQUA.cjs');
-require('../chunk-HPVTVQBJ.cjs');
+var chunkREXMA2IN_cjs = require('../chunk-REXMA2IN.cjs');
+require('../chunk-MTFRH3R5.cjs');
 
 
 
 Object.defineProperty(exports, "createEditorClient", {
   enumerable: true,
-  get: function () { return chunkTIIRBQUA_cjs.createEditorClient; }
+  get: function () { return chunkREXMA2IN_cjs.createEditorClient; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/editor/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CreateSqlSessionBody, G as GetSqlSessionPath, a as GetSqlSessionsQuery, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, d as components, P as PostSqlRunQueryPath, e as PostSqlRunQueryBody, f as PostSqlTablePreviewPath, g as PostSqlTablePreviewBody, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, j as PostSqlSessionLoadPath, k as PostSqlSessionLoadBody, l as PostSqlSessionUnloadPath, m as PostSqlSessionUnloadBody } from '../types-C0Owx2P7.cjs';
-import { C as ClientInitOptions } from '../types-DgaMV8FF.cjs';
+import { C as CreateSqlSessionBody, G as GetSqlSessionPath, a as GetSqlSessionsQuery, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, d as components, P as PostSqlRunQueryPath, e as PostSqlRunQueryBody, f as PostSqlTablePreviewPath, g as PostSqlTablePreviewBody, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, j as PostSqlSessionLoadPath, k as PostSqlSessionLoadBody, l as PostSqlSessionUnloadPath, m as PostSqlSessionUnloadBody } from '../types-DBVQGCI1.cjs';
+import { C as ClientInitOptions } from '../types-Bom8wyth.cjs';
 import '../types-C7mpAfq-.cjs';
 import 'qs';
 

package/dist/editor/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CreateSqlSessionBody, G as GetSqlSessionPath, a as GetSqlSessionsQuery, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, d as components, P as PostSqlRunQueryPath, e as PostSqlRunQueryBody, f as PostSqlTablePreviewPath, g as PostSqlTablePreviewBody, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, j as PostSqlSessionLoadPath, k as PostSqlSessionLoadBody, l as PostSqlSessionUnloadPath, m as PostSqlSessionUnloadBody } from '../types-B--u7l2H.js';
-import { C as ClientInitOptions } from '../types-DgaMV8FF.js';
+import { C as CreateSqlSessionBody, G as GetSqlSessionPath, a as GetSqlSessionsQuery, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, d as components, P as PostSqlRunQueryPath, e as PostSqlRunQueryBody, f as PostSqlTablePreviewPath, g as PostSqlTablePreviewBody, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, j as PostSqlSessionLoadPath, k as PostSqlSessionLoadBody, l as PostSqlSessionUnloadPath, m as PostSqlSessionUnloadBody } from '../types-CqWXdTMg.js';
+import { C as ClientInitOptions } from '../types-Bom8wyth.js';
 import '../types-C7mpAfq-.js';
 import 'qs';
 

package/dist/editor/index.js

@@ -1,4 +1,4 @@
-export { createEditorClient } from '../chunk-OKVYLO6C.js';
-import '../chunk-PD3LJYS2.js';
+export { createEditorClient } from '../chunk-76Q2CTFV.js';
+import '../chunk-QXWPUKK2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/editor/types.d.cts

@@ -1,2 +1,2 @@
 import '../types-C7mpAfq-.cjs';
-export { C as CreateSqlSessionBody, G as GetSqlSessionPath, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, a as GetSqlSessionsQuery, e as PostSqlRunQueryBody, P as PostSqlRunQueryPath, k as PostSqlSessionLoadBody, j as PostSqlSessionLoadPath, m as PostSqlSessionUnloadBody, l as PostSqlSessionUnloadPath, g as PostSqlTablePreviewBody, f as PostSqlTablePreviewPath, S as Session, n as SessionSchema, o as SessionSchemaBucket, p as SessionSchemaColumn, q as SessionSchemaDatabase, r as SessionSchemaTable, s as SqlSession } from '../types-C0Owx2P7.cjs';
+export { C as CreateSqlSessionBody, G as GetSqlSessionPath, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, a as GetSqlSessionsQuery, e as PostSqlRunQueryBody, P as PostSqlRunQueryPath, k as PostSqlSessionLoadBody, j as PostSqlSessionLoadPath, m as PostSqlSessionUnloadBody, l as PostSqlSessionUnloadPath, g as PostSqlTablePreviewBody, f as PostSqlTablePreviewPath, S as Session, n as SessionSchema, o as SessionSchemaBucket, p as SessionSchemaColumn, q as SessionSchemaDatabase, r as SessionSchemaTable, s as SqlSession } from '../types-DBVQGCI1.cjs';

package/dist/editor/types.d.ts

@@ -1,2 +1,2 @@
 import '../types-C7mpAfq-.js';
-export { C as CreateSqlSessionBody, G as GetSqlSessionPath, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, a as GetSqlSessionsQuery, e as PostSqlRunQueryBody, P as PostSqlRunQueryPath, k as PostSqlSessionLoadBody, j as PostSqlSessionLoadPath, m as PostSqlSessionUnloadBody, l as PostSqlSessionUnloadPath, g as PostSqlTablePreviewBody, f as PostSqlTablePreviewPath, S as Session, n as SessionSchema, o as SessionSchemaBucket, p as SessionSchemaColumn, q as SessionSchemaDatabase, r as SessionSchemaTable, s as SqlSession } from '../types-B--u7l2H.js';
+export { C as CreateSqlSessionBody, G as GetSqlSessionPath, b as GetSqlSessionSchemaPath, c as GetSqlSessionSchemaQuery, h as GetSqlSessionTableDdlPath, i as GetSqlSessionTableDdlQuery, a as GetSqlSessionsQuery, e as PostSqlRunQueryBody, P as PostSqlRunQueryPath, k as PostSqlSessionLoadBody, j as PostSqlSessionLoadPath, m as PostSqlSessionUnloadBody, l as PostSqlSessionUnloadPath, g as PostSqlTablePreviewBody, f as PostSqlTablePreviewPath, S as Session, n as SessionSchema, o as SessionSchemaBucket, p as SessionSchemaColumn, q as SessionSchemaDatabase, r as SessionSchemaTable, s as SqlSession } from '../types-CqWXdTMg.js';

package/dist/encryption/index.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkHCNNMUTR_cjs = require('../chunk-HCNNMUTR.cjs');
-require('../chunk-HPVTVQBJ.cjs');
+var chunkKOO3ZG5X_cjs = require('../chunk-KOO3ZG5X.cjs');
+require('../chunk-MTFRH3R5.cjs');
 
 
 
 Object.defineProperty(exports, "createEncryptionClient", {
   enumerable: true,
-  get: function () { return chunkHCNNMUTR_cjs.createEncryptionClient; }
+  get: function () { return chunkKOO3ZG5X_cjs.createEncryptionClient; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/encryption/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientInitOptions } from '../types-DgaMV8FF.cjs';
+import { C as ClientInitOptions } from '../types-Bom8wyth.cjs';
 import { EncryptQuery } from './types.cjs';
 import 'qs';
 

package/dist/encryption/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientInitOptions } from '../types-DgaMV8FF.js';
+import { C as ClientInitOptions } from '../types-Bom8wyth.js';
 import { EncryptQuery } from './types.js';
 import 'qs';
 

package/dist/encryption/index.js

@@ -1,4 +1,4 @@
-export { createEncryptionClient } from '../chunk-IJMQCOBC.js';
-import '../chunk-PD3LJYS2.js';
+export { createEncryptionClient } from '../chunk-V35JLM5Q.js';
+import '../chunk-QXWPUKK2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/import/index.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunk3T54WH4X_cjs = require('../chunk-3T54WH4X.cjs');
-require('../chunk-HPVTVQBJ.cjs');
+var chunk6D3MJRXE_cjs = require('../chunk-6D3MJRXE.cjs');
+require('../chunk-MTFRH3R5.cjs');
 
 
 
 Object.defineProperty(exports, "createImportClient", {
   enumerable: true,
-  get: function () { return chunk3T54WH4X_cjs.createImportClient; }
+  get: function () { return chunk6D3MJRXE_cjs.createImportClient; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/import/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientInitOptions } from '../types-DgaMV8FF.cjs';
+import { C as ClientInitOptions } from '../types-Bom8wyth.cjs';
 import { U as UploadFileParams, a as UploadedFile } from '../types-Dg1tEsVR.cjs';
 import 'qs';
 

package/dist/import/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientInitOptions } from '../types-DgaMV8FF.js';
+import { C as ClientInitOptions } from '../types-Bom8wyth.js';
 import { U as UploadFileParams, a as UploadedFile } from '../types-Dg1tEsVR.js';
 import 'qs';
 

package/dist/import/index.js

@@ -1,4 +1,4 @@
-export { createImportClient } from '../chunk-FBQHHAL5.js';
-import '../chunk-PD3LJYS2.js';
+export { createImportClient } from '../chunk-T23NVI3Q.js';
+import '../chunk-QXWPUKK2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map