@keboola/api-client 27.0.0 → 31.0.0

package/dist/storageTable-C9crh4Ef.cjs

@@ -0,0 +1,310 @@
+let zod = require("zod");
+//#region src/domain/storageTable/constants.ts
+/** Matches a numeric dev-branch prefix on a legacy-prefix-stripped bucket name. */
+const BRANCH_PREFIX_REGEX = /^(\d+)-(.+)$/;
+/** Characters allowed in a bucket or table name segment. */
+const NAME_CHARSET_REGEX = /^[a-zA-Z0-9_-]+$/;
+//#endregion
+//#region src/domain/storageTable/schema.ts
+const stageSchema = zod.z.enum(["in", "out"]);
+const nameSchema = zod.z.string().min(1, `Invalid name segment: must not be empty`).max(96, `Invalid name segment: exceeds 96 characters`).refine((n) => !n.startsWith("_"), `Invalid name segment: must not start with an underscore`).regex(NAME_CHARSET_REGEX, `Invalid name segment: contains invalid characters`);
+const tableIdSchema = zod.z.string().refine((id) => id.split(".").length === 3, "Invalid table id: must be in \"{stage}.{bucket}.{table}\" form").transform((id) => id.split(".")).pipe(zod.z.tuple([
+	stageSchema,
+	nameSchema,
+	nameSchema
+]));
+const bucketIdSchema = zod.z.string().refine((id) => id.split(".").length === 2, "Invalid bucket id: must be in \"{stage}.{bucket}\" form").transform((id) => id.split(".")).pipe(zod.z.tuple([stageSchema, nameSchema]));
+//#endregion
+//#region src/domain/storageTable/codec.ts
+const createBucketCodec = ({ useLegacyBucketPrefix, hasProtectedDefaultBranch, hasStorageBranches }) => {
+	const decode = (name) => {
+		const hasLegacyPrefix = useLegacyBucketPrefix && name.startsWith("c-");
+		const stripped = hasLegacyPrefix ? name.slice(2) : 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 ? "c-" : "";
+		const baseNameResult = nameSchema.safeParse(bucket.baseName);
+		if (!baseNameResult.success) return {
+			success: false,
+			error: baseNameResult.error
+		};
+		if (bucket.kind === "storage-branch") {
+			const prefixedName = `${prefix}${bucket.baseName}`;
+			return {
+				success: true,
+				data: {
+					kind: "storage-branch",
+					id: `${bucket.stage}.${prefixedName}`,
+					prefixedName
+				}
+			};
+		}
+		const branchedName = `${bucket.branchId ? `${bucket.branchId}-` : ""}${bucket.baseName}`;
+		const prefixedName = `${prefix}${branchedName}`;
+		return {
+			success: true,
+			data: {
+				kind: "legacy",
+				id: `${bucket.stage}.${prefixedName}`,
+				prefixedName,
+				branchedName
+			}
+		};
+	};
+	return {
+		decode,
+		encode
+	};
+};
+//#endregion
+//#region src/domain/storageTable/model.ts
+const 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
+	};
+};
+//#endregion
+//#region src/domain/storageTable/utils.ts
+const webalize = (str) => {
+	const out = str.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^a-z0-9\-_]/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").replace(/^_+/, "").slice(0, 96).replace(/-+$/g, "");
+	if (out.length === 0) throw new Error(`Cannot webalize "${str}" into a valid name segment`);
+	return out;
+};
+//#endregion
+//#region src/domain/storageTable/createStorageTable.ts
+const 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) => {
+		return {
+			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 — 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 ?? ""
+			})
+		};
+	};
+	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 {
+		parse,
+		safeParse,
+		parseBucket,
+		safeParseBucket,
+		createTable,
+		createBucket,
+		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
+		})
+	};
+};
+//#endregion
+Object.defineProperty(exports, "createStorageTable", {
+	enumerable: true,
+	get: function() {
+		return createStorageTable;
+	}
+});
+Object.defineProperty(exports, "createTableModel", {
+	enumerable: true,
+	get: function() {
+		return createTableModel;
+	}
+});
+
+//# sourceMappingURL=storageTable-C9crh4Ef.cjs.map

package/dist/storageTable-C9crh4Ef.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageTable-C9crh4Ef.cjs","names":["z"],"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"],"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"],"mappings":"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"}

package/dist/storageTable-DslXtqNL.js

@@ -0,0 +1,299 @@
+import { z } from "zod";
+//#region src/domain/storageTable/constants.ts
+/** Matches a numeric dev-branch prefix on a legacy-prefix-stripped bucket name. */
+const BRANCH_PREFIX_REGEX = /^(\d+)-(.+)$/;
+/** Characters allowed in a bucket or table name segment. */
+const NAME_CHARSET_REGEX = /^[a-zA-Z0-9_-]+$/;
+//#endregion
+//#region src/domain/storageTable/schema.ts
+const stageSchema = z.enum(["in", "out"]);
+const nameSchema = z.string().min(1, `Invalid name segment: must not be empty`).max(96, `Invalid name segment: exceeds 96 characters`).refine((n) => !n.startsWith("_"), `Invalid name segment: must not start with an underscore`).regex(NAME_CHARSET_REGEX, `Invalid name segment: contains invalid characters`);
+const 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
+]));
+const 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]));
+//#endregion
+//#region src/domain/storageTable/codec.ts
+const createBucketCodec = ({ useLegacyBucketPrefix, hasProtectedDefaultBranch, hasStorageBranches }) => {
+	const decode = (name) => {
+		const hasLegacyPrefix = useLegacyBucketPrefix && name.startsWith("c-");
+		const stripped = hasLegacyPrefix ? name.slice(2) : 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 ? "c-" : "";
+		const baseNameResult = nameSchema.safeParse(bucket.baseName);
+		if (!baseNameResult.success) return {
+			success: false,
+			error: baseNameResult.error
+		};
+		if (bucket.kind === "storage-branch") {
+			const prefixedName = `${prefix}${bucket.baseName}`;
+			return {
+				success: true,
+				data: {
+					kind: "storage-branch",
+					id: `${bucket.stage}.${prefixedName}`,
+					prefixedName
+				}
+			};
+		}
+		const branchedName = `${bucket.branchId ? `${bucket.branchId}-` : ""}${bucket.baseName}`;
+		const prefixedName = `${prefix}${branchedName}`;
+		return {
+			success: true,
+			data: {
+				kind: "legacy",
+				id: `${bucket.stage}.${prefixedName}`,
+				prefixedName,
+				branchedName
+			}
+		};
+	};
+	return {
+		decode,
+		encode
+	};
+};
+//#endregion
+//#region src/domain/storageTable/model.ts
+const 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
+	};
+};
+//#endregion
+//#region src/domain/storageTable/utils.ts
+const webalize = (str) => {
+	const out = str.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^a-z0-9\-_]/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").replace(/^_+/, "").slice(0, 96).replace(/-+$/g, "");
+	if (out.length === 0) throw new Error(`Cannot webalize "${str}" into a valid name segment`);
+	return out;
+};
+//#endregion
+//#region src/domain/storageTable/createStorageTable.ts
+const 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) => {
+		return {
+			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 — 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 ?? ""
+			})
+		};
+	};
+	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 {
+		parse,
+		safeParse,
+		parseBucket,
+		safeParseBucket,
+		createTable,
+		createBucket,
+		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
+		})
+	};
+};
+//#endregion
+export { createTableModel as n, createStorageTable as t };
+
+//# sourceMappingURL=storageTable-DslXtqNL.js.map