import {z} from 'zod' export type StorageName = string; export type CreateBucketRequest = {name: StorageName, stage?: ('in' | 'out' | 'sys') | undefined, description?: string | undefined, backend?: ('snowflake' | 'bigquery') | undefined, displayName?: StorageName | undefined, color?: string | undefined}; export type LinkBucketRequest = {name: StorageName, displayName?: StorageName | undefined, sourceProjectId: number, sourceBucketId: string, stage?: ('in' | 'out' | 'sys') | undefined}; export type CreateApiV2StorageBranchBranchIdBucketsArgs = {async?: boolean | undefined, branchId: string, 'X-KBC-Backend'?: ({context?: (string | null) | undefined}) | undefined, body: CreateBucketRequest | LinkBucketRequest}; export type CreateApiV2StorageBranchBranchIdBucketsOptions = {baseUrl?: string | undefined, StorageKey?: string | undefined, fetch?: typeof fetch | undefined}; export const actorResponse = z.object({type: z.enum(["token", "session", "pat", "system"]), id: z.string(), name: z.string(), adminId: z.number().int().nullable()}); export const metadataItemResponse = z.object({id: z.string(), key: z.string(), value: z.string().nullable(), provider: z.string(), timestamp: z.string()}); export const sharedBucketResponse = z.object({id: z.string(), name: z.string(), displayName: z.string(), stage: z.enum(["in", "out", "sys"]), description: z.string(), sharing: z.enum(["organization", "organization-project", "specific-projects", "specific-users", "null"]).nullable(), created: z.string(), lastChangeDate: z.string().nullable(), dataSizeBytes: z.number().int(), rowsCount: z.number().int(), backend: z.string(), hasExternalSchema: z.boolean(), databaseName: z.string(), path: z.string(), project: z.object({id: z.number().int(), name: z.string()}), color: z.string().nullable(), tables: z.array(z.object({id: z.string(), name: z.string(), displayName: z.string(), path: z.string()})).optional(), sharingParameters: z.union([z.object({projects: z.array(z.object({id: z.number().int(), name: z.string()})).optional(), users: z.array(z.object({id: z.number().int(), name: z.string(), email: z.string()})).optional()}), z.array(z.unknown())]).optional(), sharedBy: z.object({id: z.number().int().nullable(), name: z.string().nullable(), date: z.string()}).optional(), sharedByActor: actorResponse.nullable(), owner: z.object({id: z.number().int(), name: z.string(), email: z.string()}).nullable(), metadata: z.array(metadataItemResponse).optional()}); export const bucketCreateResponse = z.object({uri: z.string(), id: z.string(), name: z.string(), displayName: z.string(), idBranch: z.number().int(), stage: z.enum(["in", "out", "sys"]), description: z.string(), tables: z.string(), created: z.string(), lastChangeDate: z.string().nullable(), updated: z.string().nullable(), isReadOnly: z.boolean(), dataSizeBytes: z.number().int(), rowsCount: z.number().int(), isMaintenance: z.boolean(), backend: z.string(), sharing: z.enum(["organization", "organization-project", "specific-projects", "specific-users", "null"]).nullable(), hasExternalSchema: z.boolean(), databaseName: z.string(), path: z.string(), isSnowflakeSharedDatabase: z.boolean(), isLinkedBucket: z.boolean(), color: z.string().nullable(), bucketSharingAllowed: z.boolean(), sharingParameters: z.union([z.object({projects: z.array(z.object({id: z.number().int(), name: z.string()})).optional(), users: z.array(z.object({id: z.number().int(), name: z.string(), email: z.string()})).optional()}), z.array(z.unknown())]).optional(), sharedBy: z.object({id: z.number().int().nullable(), name: z.string().nullable(), date: z.string()}).optional(), sharedByActor: actorResponse.nullable(), owner: z.object({id: z.number().int(), name: z.string(), email: z.string()}).nullable(), sourceBucket: sharedBucketResponse.optional(), backendPath: z.array(z.string()), attributes: z.array(z.object({}))}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Create bucket or link a shared bucket * * POST /v2/storage/branch/{branchId}/buckets * * Also accepts auth: ManageKey, BearerAuth */ export const createApiV2StorageBranchBranchIdBuckets = async (args: CreateApiV2StorageBranchBranchIdBucketsArgs, options?: CreateApiV2StorageBranchBranchIdBucketsOptions) => { const {baseUrl = "https://connection.keboola.com", fetch: fetchFn = fetch, StorageKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (args.async != null) query.append("async", String(args.async)) if (args['X-KBC-Backend'] != null) headers.set("X-KBC-Backend", JSON.stringify(args['X-KBC-Backend'])) if (StorageKey !== undefined) headers.set("X-StorageApi-Token", StorageKey) const url = `${baseUrl.replace(/\/+$/, '')}/v2/storage/branch/${encodeURIComponent(String(args.branchId))}/buckets${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(bucketCreateResponse, await res.json()) };