@tulip-systems/core 0.6.1 → 0.8.0

package/dist/modules/storage/lib/service.server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service.server.mjs","names":["#db","#blob","#createGetCommand","#putObject","#createPutCommand"],"sources":["../../../../src/modules/storage/lib/service.server.ts"],"sourcesContent":["import {\n  DeleteObjectsCommand,\n  GetObjectCommand,\n  PutObjectCommand,\n  S3Client,\n  type S3ClientConfig,\n} from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport { addSeconds } from \"date-fns\";\nimport { and, asc, eq, inArray, isNotNull, isNull, type SQL } from \"drizzle-orm\";\nimport { after } from \"next/server\";\nimport { BUCKET_NAME } from \"@/lib/config/constants\";\nimport { generateDefaultUUID, type TDatabaseSchema } from \"@/modules/config/entry\";\nimport type { DatabaseClient } from \"@/modules/config/entry.server\";\nimport {\n  convertOrderByToQueryParams,\n  convertSearchToQueryParams,\n} from \"@/modules/data-tables/entry.server\";\nimport type { BulkActionSchema } from \"@/modules/router/entry\";\nimport { ServerError } from \"@/modules/router/lib/error.server\";\nimport { deviceSizes } from \"./constants\";\nimport { getDriveBucketKey, inferNodeSubtype, isFile, isFolder } from \"./helpers\";\nimport { nodePresignedUrls, nodes, nodeVariants } from \"./schema\";\nimport {\n  type CreateFolderNodeSchema,\n  type FileNode,\n  type GetFileURLSchema,\n  type GetNodesByParentIdInput,\n  type GetObjectInput,\n  getFileURLSchemaDefaults,\n  getObjectSchema,\n  type Node,\n  type PresignFileSchema,\n  type PutObjectInput,\n  putObjectSchema,\n  type UpdateNodeSchema,\n  type UploadFileSchema,\n} from \"./validators\";\n\n/**\n * Storage Service Config\n */\nexport type StorageServiceConfig<TSchema extends TDatabaseSchema> = {\n  db: DatabaseClient<TSchema>;\n  config: S3ClientConfig;\n};\n\n/**\n * Storage Service\n */\nexport class StorageService<TSchema extends TDatabaseSchema> {\n  /**\n   * S3 Client\n   */\n  #blob: S3Client;\n  #db: DatabaseClient<TSchema>;\n\n  /**\n   * Constructor\n   */\n  constructor({ db, config }: StorageServiceConfig<TSchema>) {\n    this.#db = db;\n    this.#blob = new S3Client(config);\n  }\n\n  /**\n   * Get Blob\n   */\n  blob() {\n    return this.#blob;\n  }\n\n  /**\n   * Create get command\n   */\n  #createGetCommand(props: GetObjectInput) {\n    const input = getObjectSchema.parse(props);\n\n    return new GetObjectCommand({\n      Bucket: BUCKET_NAME,\n      Key: getDriveBucketKey(input.id, input.variant),\n      ResponseContentDisposition: input.disposition,\n    });\n  }\n\n  /**\n   * Get object\n   */\n  async getObject(id: string, options: GetFileURLSchema = getFileURLSchemaDefaults) {\n    const getCommand = this.#createGetCommand({ ...options, id });\n\n    return await this.#blob.send(getCommand);\n  }\n\n  /**\n   * Create put command\n   */\n  #createPutCommand(props: PutObjectInput) {\n    const input = putObjectSchema.parse(props);\n\n    return new PutObjectCommand({\n      Bucket: BUCKET_NAME,\n      Key: getDriveBucketKey(input.id, input.variant),\n      Body: input.body,\n      ContentType: input.contentType ?? undefined,\n      ContentLength: input.size ?? undefined,\n      Metadata: {\n        nodeId: input.id,\n      },\n    });\n  }\n\n  /**\n   * Put object\n   */\n  async #putObject(props: PutObjectInput) {\n    const putCommand = this.#createPutCommand(props);\n    return await this.#blob.send(putCommand);\n  }\n\n  /**\n   * Get node by id\n   */\n  async getNodeById(id: string) {\n    return this.#db.select().from(nodes).where(eq(nodes.id, id));\n  }\n\n  /**\n   * Get nodes by parent id\n   */\n  async getNodesByParentId({ filters, ...query }: GetNodesByParentIdInput) {\n    const orderBy = convertOrderByToQueryParams(query, nodes, asc(nodes.createdAt));\n    const search = convertSearchToQueryParams(query, [nodes.name]);\n\n    return this.#db\n      .select()\n      .from(nodes)\n      .where(\n        and(\n          filters.nodeIds != null ? inArray(nodes.id, filters.nodeIds) : undefined,\n          filters.types != null ? inArray(nodes.type, filters.types) : undefined,\n          filters.isDeleted != null ? eq(nodes.isDeleted, filters.isDeleted) : undefined,\n          filters.isOrphaned === true\n            ? isNotNull(nodes.orphanedAt)\n            : filters.isOrphaned === false\n              ? isNull(nodes.orphanedAt)\n              : undefined,\n          filters.hidden != null ? eq(nodes.hidden, filters.hidden) : undefined,\n          filters.parentId ? eq(nodes.parentId, filters.parentId) : isNull(nodes.parentId),\n          eq(nodes.namespace, filters.namespace),\n          search,\n        ),\n      )\n      .orderBy(orderBy as SQL);\n  }\n\n  /**\n   * Get file url\n   */\n  async getSignedURL(node: Node, options: GetFileURLSchema = getFileURLSchemaDefaults) {\n    const [presignedUrl] = await this.#db\n      .select({ url: nodePresignedUrls.url, expiresAt: nodePresignedUrls.expiresAt })\n      .from(nodePresignedUrls)\n      .where(\n        and(\n          eq(nodePresignedUrls.nodeId, node.id),\n          eq(nodePresignedUrls.variant, options.variant),\n          eq(nodePresignedUrls.disposition, options.disposition),\n        ),\n      );\n\n    if (presignedUrl && presignedUrl.expiresAt > new Date()) return presignedUrl.url;\n\n    const expiresIn = 3600 * 24;\n\n    // Get the variants\n    const variants = await this.#db\n      .select()\n      .from(nodeVariants)\n      .where(eq(nodeVariants.nodeId, node.id));\n\n    // If the requested variant does not exist, fallback to main\n    const variantExists = variants.find((v) => v.variant === options.variant);\n    const variant = variantExists ? options.variant : \"main\";\n\n    console.info(\n      `Generating new signed url for file: ${node.id} with variant: ${variant} and disposition: ${options.disposition}`,\n    );\n\n    // Generate the get command\n    const getCommand = this.#createGetCommand({\n      id: node.id,\n      variant,\n      disposition: `${options.disposition}; filename=\"${node.name}\"`,\n    });\n\n    // Generate the presigned url that expires in 24 hours\n    const url = await getSignedUrl(this.#blob, getCommand, { expiresIn });\n\n    // Add the presigned url to the database\n    after(async () => {\n      await this.#db\n        .insert(nodePresignedUrls)\n        .values({\n          nodeId: node.id,\n          url,\n          variant,\n          disposition: options.disposition,\n          expiresAt: addSeconds(new Date(), expiresIn),\n        })\n        .onConflictDoUpdate({\n          target: [\n            nodePresignedUrls.nodeId,\n            nodePresignedUrls.variant,\n            nodePresignedUrls.disposition,\n          ],\n          set: { url, expiresAt: addSeconds(new Date(), expiresIn) },\n        });\n    });\n\n    return url;\n  }\n\n  /**\n   * Upload file to S3 and add it to the database\n   **/\n  async uploadFile(input: UploadFileSchema & Pick<PutObjectInput, \"body\">) {\n    const id = input.id ?? generateDefaultUUID();\n\n    return await this.#db.transaction(async (tx) => {\n      const [result] = await tx\n        .insert(nodes)\n        .values({\n          id,\n          type: \"file\",\n          name: input.name,\n          namespace: input.namespace,\n          parentId: input.parentId,\n          size: input.size,\n          contentType: input.contentType,\n          mode: input.mode,\n          subtype: inferNodeSubtype(input),\n        })\n        .returning();\n\n      if (!result) {\n        throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n          message: \"Oep! Er is iets fout gegaan\",\n        });\n      }\n\n      await this.#putObject({\n        id,\n        body: input.body,\n        variant: \"main\",\n        name: input.name,\n        contentType: input.contentType,\n        size: input.size,\n      });\n\n      return result;\n    });\n  }\n\n  /**\n   * Presign a new upload\n   */\n  async presignUpload(input: PresignFileSchema) {\n    // Generate the put command\n    const putCommand = this.#createPutCommand({\n      id: input.id,\n      name: input.name,\n      variant: \"main\",\n      contentType: input.contentType,\n      size: input.size,\n    });\n\n    // Generate the presigned url\n    const presignedUrl = await getSignedUrl(this.#blob, putCommand, { expiresIn: 3600 });\n\n    const [node] = await this.#db\n      .insert(nodes)\n      .values({\n        ...input,\n        subtype: inferNodeSubtype(input),\n        isPending: true,\n        type: \"file\",\n        id: input.id,\n      })\n      .returning();\n\n    if (!node) {\n      throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n        message: \"Oep! Er is iets fout gegaan\",\n      });\n    }\n\n    // Return the result\n    return { id: input.id, presignedUrl, node };\n  }\n\n  /**\n   * Confirm a new upload\n   */\n  async confirmUpload(input: { id: string }) {\n    const [result] = await this.#db\n      .update(nodes)\n      .set({ isPending: false })\n      .where(eq(nodes.id, input.id))\n      .returning();\n\n    if (!result) {\n      throw new ServerError(\"NOT_FOUND\", { message: \"File not found\" });\n    }\n\n    /**\n     * Generate the preview version of the file\n     */\n    // after(async () => {});\n    await this.generatePreviews(input);\n\n    return result as FileNode;\n  }\n\n  /**\n   * Generate preview version of the file\n   */\n  async generatePreviews(input: { id: string }) {\n    /**\n     * Get the main version of the file\n     */\n    const getCommand = this.#createGetCommand({ id: input.id, variant: \"main\" });\n\n    const response = await this.#blob.send(getCommand);\n    const contentType = response.ContentType;\n    if (!response.Body) {\n      throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n        message: \"Oep! Er is iets fout gegaan\",\n      });\n    }\n\n    /**\n     * Transform the main version of the file to a buffer\n     */\n    const byteArray = await response.Body.transformToByteArray();\n    const buffer = Buffer.from(byteArray);\n\n    /**\n     * Generate the preview versions for images\n     */\n    if (contentType?.startsWith(\"image/\")) {\n      const sharp = await import(\"sharp\");\n\n      // Generate the preview versions\n      await Promise.allSettled(\n        deviceSizes.flatMap(async (width) => {\n          // Generate the preview\n          const preview = await sharp.default(buffer).resize({ width }).webp().toBuffer();\n\n          // Upload the preview and add the variant to the database\n          return this.#db.transaction(async (tx) => {\n            await this.#putObject({\n              id: input.id,\n              body: preview,\n              variant: `preview-${width}`,\n              contentType: \"image/webp\",\n              size: preview.byteLength,\n            });\n\n            await tx.insert(nodeVariants).values({\n              nodeId: input.id,\n              variant: `preview-${width}`,\n              width,\n            });\n          });\n        }),\n      );\n    }\n  }\n\n  /**\n   * Create a new folder\n   */\n  async createFolder(input: CreateFolderNodeSchema) {\n    const [parent] = input.parentId\n      ? await this.#db.select().from(nodes).where(eq(nodes.id, input.parentId))\n      : [];\n\n    /**\n     * Validate\n     */\n    if (input.parentId && !parent) {\n      throw new ServerError(\"BAD_REQUEST\", { message: \"Parent not found\" });\n    }\n\n    if (parent && !isFolder(parent)) {\n      throw new ServerError(\"BAD_REQUEST\", { message: \"Parent is not a folder\" });\n    }\n\n    if (parent && parent.namespace !== input.namespace) {\n      throw new ServerError(\"BAD_REQUEST\", {\n        message: \"Parent is not in the same namespace\",\n      });\n    }\n\n    /**\n     * Create the folder\n     */\n    const [result] = await this.#db\n      .insert(nodes)\n      .values({ ...input, type: \"folder\" })\n      .returning();\n\n    if (!result) {\n      throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n        message: \"Folder kon niet worden aangemaakt\",\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Update a node\n   */\n  async updateNode(input: { id: string; data: UpdateNodeSchema }) {\n    const [node] = await this.#db\n      .select({ readonly: nodes.readonly })\n      .from(nodes)\n      .where(eq(nodes.id, input.id));\n\n    if (node?.readonly) {\n      throw new ServerError(\"BAD_REQUEST\", { message: \"Node is readonly\" });\n    }\n\n    const [result] = await this.#db\n      .update(nodes)\n      .set(input.data)\n      .where(eq(nodes.id, input.id))\n      .returning();\n\n    if (!result) {\n      throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n        message: \"Node kon niet worden gewijzigd\",\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Delete nodes\n   */\n  async deleteNodes(input: BulkActionSchema) {\n    const items = await this.#db\n      .select({ id: nodes.id, type: nodes.type, readonly: nodes.readonly })\n      .from(nodes)\n      .where(inArray(nodes.id, input.ids));\n\n    // Check if the nodes are readonly\n    if (items.some((item) => item.readonly)) {\n      throw new ServerError(\"BAD_REQUEST\", { message: \"Nodes are readonly\" });\n    }\n\n    // Split the nodes into folders and files\n    const folders = items.filter(isFolder).map((folder) => folder.id);\n    const files = items.filter(isFile).map((file) => file.id);\n\n    // Delete command for S3\n    const deleteCommand =\n      files.length > 0\n        ? new DeleteObjectsCommand({\n            Bucket: BUCKET_NAME,\n            Delete: {\n              Objects: files.map((id) => ({ Key: id })),\n            },\n          })\n        : undefined;\n\n    /**\n     * Delete files and folders in a transaction\n     */\n    await this.#db.transaction(async (tx) => {\n      await tx.delete(nodes).where(inArray(nodes.id, folders));\n      await tx.delete(nodes).where(inArray(nodes.id, files));\n\n      if (deleteCommand) await this.#blob.send(deleteCommand);\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"service.server.mjs","names":["#db","#adapter","#generateKey","#parseError"],"sources":["../../../../src/modules/storage/lib/service.server.ts"],"sourcesContent":["import { and, desc, eq, inArray, isNotNull, isNull } from \"drizzle-orm\";\nimport z from \"zod\";\nimport { generateDefaultUUID } from \"@/modules/database/lib/helpers\";\nimport type { Database } from \"@/modules/database/lib/service.server\";\nimport type { TDatabaseSchema } from \"@/modules/database/lib/types\";\nimport { ServerError } from \"@/modules/router/lib/error.server\";\nimport { StorageAdapterError } from \"../providers/lib/errors\";\nimport type { StorageAdapter } from \"../providers/lib/types\";\nimport type { GetObjectURLOptions } from \"../providers/lib/validators\";\nimport { storageAssets } from \"./schema\";\nimport {\n  type ConfirmUploadInput,\n  confirmUploadInputSchema,\n  type PresignUploadInput,\n  presignUploadInputSchema,\n  type UploadInput,\n  uploadInputSchema,\n} from \"./validators\";\n\nexport type StorageConfig<TSchema extends TDatabaseSchema> = {\n  db: Database<TSchema>;\n  adapter: StorageAdapter;\n  prefix?: string;\n};\n\n/**\n * Storage service for working with asset metadata and object storage.\n *\n * Use `Storage.init()` to create a fully configured instance in app code.\n *\n * @param props - Storage configuration, including `db` and `adapter`\n * @returns A ready-to-use `Storage` instance\n * @example\n * const storage = Storage.init({\n *   db: drizzle(dbConnection),\n *   adapter: new StorageS3Adapter({\n *     bucketName: \"my-app-uploads\",\n *     region: \"us-east-1\",\n *     credentials: {\n *       accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n *       secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n *     },\n *   }),\n * });\n */\n\nexport class Storage<TSchema extends TDatabaseSchema> {\n  #adapter: StorageAdapter;\n  #db: Database<TSchema>;\n  prefix: string;\n\n  private constructor({ db, adapter, prefix }: StorageConfig<TSchema>) {\n    this.#db = db;\n    this.#adapter = adapter;\n    this.prefix = prefix ?? \"uploads\";\n  }\n\n  /**\n   * Create a storage service instance.\n   *\n   * This keeps the public API aligned with other Tulip services such as\n   * `Database.init()`, `Email.init()`, and `Auth.init()`.\n   *\n   * @param props - Storage configuration, including `db` and `adapter`\n   * @returns A new `Storage` instance\n   * @example\n   * const storage = Storage.init({\n   *   db: drizzle(dbConnection),\n   *   adapter: new StorageS3Adapter({\n   *     bucketName: \"my-app-uploads\",\n   *     region: \"us-east-1\",\n   *     credentials: {\n   *       accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n   *       secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n   *     },\n   *   }),\n   * });\n   */\n  static init<TSchema extends TDatabaseSchema>(props: StorageConfig<TSchema>) {\n    return new Storage(props);\n  }\n\n  /**\n   * Generates the canonical object key for a storage asset id.\n   *\n   * This keeps bucket key structure internal to the storage service,\n   * so callers only work with asset ids and do not manage object paths.\n   *\n   * @param input - Storage asset id (UUID)\n   * @returns Canonical storage key (e.g. `uploads/<id>`)\n   * @example\n   * const key = this.#generateKey(\"019d0051-2c0d-741e-9e3c-e5a5bc4d16a2\");\n   * // key => \"uploads/019d0051-2c0d-741e-9e3c-e5a5bc4d16a2\"\n   */\n  #generateKey(input: string) {\n    const id = z.uuid().parse(input);\n    return `${this.prefix}/${id}`;\n  }\n\n  /**\n   * Builds a query to fetch a storage asset by its ID and the current adapter's provider.\n   * @param id - The asset ID to search for\n   * @returns A dynamic Drizzle query for fetching a single asset\n   * @example\n   * let query = storageService.getAssetByIdQuery(\"asset-123\");\n   * query = query.where(eq(storageAssets.contentType, \"image/png\")); // Add additional conditions if needed\n   * const [asset] = await query;\n   */\n  getAssetByIdQuery(id: string) {\n    return this.#db\n      .select()\n      .from(storageAssets)\n      .where(\n        and(\n          eq(storageAssets.id, id),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          isNull(storageAssets.deletedAt),\n        ),\n      )\n      .limit(1)\n      .$dynamic();\n  }\n\n  /**\n   * Fetches a storage asset by its ID.\n   * @param id - The asset ID to retrieve\n   * @returns The asset object if found, otherwise null\n   * @example\n   * const asset = await storageService.getAssetById(\"asset-123\");\n   * if (asset) {\n   *   console.log(asset.key, asset.contentType);\n   * }\n   */\n  async getAssetById(id: string) {\n    const parsedId = z.uuid().parse(id);\n    const [asset] = await this.getAssetByIdQuery(parsedId);\n    return asset ?? null;\n  }\n\n  /**\n   * Builds a query to fetch a single ready storage asset by key\n   * within the current adapter provider scope.\n   *\n   * Notes:\n   * - Scoped to `this.#adapter.key` to avoid cross-provider leakage.\n   * - Targets ready assets by default.\n   * - Uniqueness is expected on `(provider, bucket, key)`.\n   *\n   * @param key - The object key stored in `storage_assets.key`\n   * @returns A dynamic Drizzle query returning max 1 row\n   * @example\n   * let query = storageService.getAssetByKeyQuery(\"uploads/abc/main\");\n   * query = query.leftJoin(otherTable, eq(otherTable.assetId, storageAssets.id));\n   * const [asset] = await query;\n   */\n  getAssetByKeyQuery(key: string) {\n    return this.#db\n      .select()\n      .from(storageAssets)\n      .where(\n        and(\n          eq(storageAssets.key, key),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          eq(storageAssets.status, \"ready\"),\n          isNull(storageAssets.deletedAt),\n        ),\n      )\n      .limit(1)\n      .$dynamic();\n  }\n\n  /**\n   * Fetches a single ready storage asset by key.\n   *\n   * This is the convenience wrapper around `getAssetByKeyQuery`.\n   * Use this when you only need the result, not query composition.\n   *\n   * @param key - Asset key to look up\n   * @returns The matching asset or `null` if none is found\n   * @example\n   * const asset = await storageService.getAssetByKey(\"uploads/abc/main\");\n   * if (!asset) return;\n   */\n  async getAssetByKey(key: string) {\n    const [result] = await this.getAssetByKeyQuery(key);\n    return result ?? null;\n  }\n\n  /**\n   * Builds a base query for listing storage assets.\n   *\n   * Scope and defaults:\n   * - Scoped to the current adapter provider (`this.#adapter.key`)\n   * - Orders by newest first (`createdAt DESC`)\n   *\n   * This method returns a dynamic query so callers can extend it with\n   * custom filters, joins, pagination, and limits.\n   *\n   * @returns A dynamic Drizzle query for listing assets\n   * @example\n   * const query = storageService\n   *   .listAssetsQuery()\n   *   .limit(50);\n   * const assets = await query;\n   */\n  listAssetsQuery() {\n    return this.#db\n      .select()\n      .from(storageAssets)\n      .where(\n        and(\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          isNull(storageAssets.deletedAt),\n        ),\n      )\n      .orderBy(desc(storageAssets.createdAt))\n      .$dynamic();\n  }\n\n  /**\n   * Lists storage assets using safe default pagination.\n   *\n   * This is the convenience wrapper around `listAssetsQuery`.\n   * Use `listAssetsQuery()` directly when you need custom query composition.\n   *\n   * @returns Up to 100 storage assets sorted by newest first\n   * @example\n   * const assets = await storageService.listAssets();\n   */\n  async listAssets() {\n    const assets = await this.listAssetsQuery().limit(100);\n    return assets ?? [];\n  }\n\n  /**\n   * Creates a pending storage asset record and generates a presigned upload URL.\n   *\n   * Flow:\n   * - Validates the input payload\n   * - Inserts a `pending` asset in the catalog (`storage_assets`)\n   * - Requests a presigned PUT URL from the storage adapter\n   * - Marks the asset as `error` if URL generation fails\n   *\n   * This method is intended for direct-to-storage browser uploads.\n   * The upload should be finalized later via a confirm step.\n   *\n   * @param props - Presign upload input (contentType, size, metadata)\n   * @returns The created asset id, key, and presigned URL\n   * @throws {ServerError} If intent creation or URL generation fails\n   * @example\n   * const result = await storageService.presignUpload({\n   *   contentType: \"image/png\",\n   *   size: 120_000,\n   *   metadata: { uploadToken: crypto.randomUUID() },\n   * });\n   * // result => { id, uploadId, key, presignedUrl }\n   */\n  async presignUpload(props: PresignUploadInput) {\n    const input = presignUploadInputSchema.parse(props);\n\n    const id = generateDefaultUUID();\n    const uploadId = input.uploadId ?? generateDefaultUUID();\n    const key = this.#generateKey(id);\n\n    const { contentType, size, metadata, name, visibility } = input;\n\n    const [record] = await this.#db\n      .insert(storageAssets)\n      .values({\n        id,\n        uploadId,\n        key,\n        size,\n        contentType,\n        name,\n        visibility,\n        provider: this.#adapter.key,\n        bucket: this.#adapter.bucketName,\n        status: \"pending\",\n        metadata,\n      })\n      .returning();\n\n    if (!record) {\n      throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n        message: \"Failed to create upload intent\",\n      });\n    }\n\n    try {\n      const presignedUrl = await this.#adapter.putObjectURL({ key, contentType, size, metadata });\n\n      return { ...record, presignedUrl };\n    } catch (error) {\n      await this.#db\n        .update(storageAssets)\n        .set({ status: \"error\" })\n        .where(eq(storageAssets.id, record.id));\n\n      throw this.#parseError(error, {\n        fallbackMessage: \"Failed to generate upload URL\",\n      });\n    }\n  }\n\n  /**\n   * Confirms a direct-to-storage upload by verifying object existence\n   * and transitioning the asset from `pending` to `ready`.\n   *\n   * Flow:\n   * - Validates confirm input\n   * - Loads the asset record scoped to the current adapter provider\n   * - Returns early if asset is already `ready` (idempotent behavior)\n   * - Verifies object existence/metadata via `adapter.headObject`\n   * - Marks asset as `error` if verification fails\n   * - Updates status to `ready` and stores upload metadata\n   *\n   * @param props - Confirm upload payload containing the asset uploadId\n   * @returns The updated storage asset record\n   * @throws {ServerError} If the asset is missing, verification fails, or update fails\n   * @example\n   * const asset = await storageService.confirmUpload(\"019d0051-2c0d-741e-9e3c-e5a5bc4d16a2\");\n   * // asset.status === \"ready\"\n   */\n  async confirmUpload(props: ConfirmUploadInput) {\n    const uploadId = confirmUploadInputSchema.parse(props);\n\n    const [record] = await this.#db\n      .select()\n      .from(storageAssets)\n      .where(\n        and(\n          eq(storageAssets.uploadId, uploadId),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          isNull(storageAssets.deletedAt),\n        ),\n      )\n      .limit(1);\n\n    if (!record) {\n      throw new ServerError(\"NOT_FOUND\", { message: \"Storage asset not found\" });\n    }\n\n    if (record.status === \"ready\") return record;\n\n    let head: Awaited<ReturnType<StorageAdapter[\"headObject\"]>>;\n\n    try {\n      head = await this.#adapter.headObject({ key: record.key });\n    } catch (error) {\n      await this.#db\n        .update(storageAssets)\n        .set({ status: \"error\" })\n        .where(eq(storageAssets.id, record.id));\n\n      throw this.#parseError(error, {\n        fallbackMessage: \"Failed to verify uploaded object\",\n      });\n    }\n\n    const [updated] = await this.#db\n      .update(storageAssets)\n      .set({\n        status: \"ready\",\n        uploadedAt: new Date(),\n        size: head.size ?? record.size,\n        contentType: head.contentType ?? record.contentType,\n      })\n      .where(and(eq(storageAssets.id, record.id), eq(storageAssets.status, \"pending\")))\n      .returning();\n\n    if (!updated) {\n      throw new ServerError(\"INTERNAL_SERVER_ERROR\", { message: \"Failed to confirm upload\" });\n    }\n\n    return updated;\n  }\n\n  /**\n   * Uploads an asset directly from the server and persists its catalog record.\n   *\n   * Flow:\n   * - Validates upload input\n   * - Creates a `pending` asset record in `storage_assets`\n   * - Uploads the object bytes through the storage adapter\n   * - Marks the record as `ready` and stores upload metadata\n   * - Marks the record as `error` if upload fails\n   *\n   * This method is intended for server-side uploads (non-presigned flow).\n   * For browser direct uploads, use `presignUpload` + `confirmUpload`.\n   *\n   * @param props - Upload payload (body, contentType, size)\n   * @returns The finalized storage asset record\n   * @throws {ServerError} If record creation, upload, or finalization fails\n   * @example\n   * const asset = await storageService.upload({\n   *   body: fileBuffer,\n   *   contentType: \"application/pdf\",\n   *   size: fileBuffer.byteLength,\n   * });\n   */\n  async upload(props: UploadInput) {\n    const { body, contentType, size, metadata, name, visibility } = uploadInputSchema.parse(props);\n\n    const id = generateDefaultUUID();\n    const key = this.#generateKey(id);\n\n    const [record] = await this.#db\n      .insert(storageAssets)\n      .values({\n        id,\n        key,\n        size,\n        contentType,\n        name,\n        visibility,\n        provider: this.#adapter.key,\n        bucket: this.#adapter.bucketName,\n        status: \"pending\",\n        metadata,\n      })\n      .returning();\n\n    if (!record) {\n      throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n        message: \"Failed to create upload record\",\n      });\n    }\n\n    try {\n      const uploaded = await this.#adapter.putObject({ key, body, contentType, size, metadata });\n\n      const [updated] = await this.#db\n        .update(storageAssets)\n        .set({\n          status: \"ready\",\n          uploadedAt: new Date(),\n          size: uploaded.size ?? size ?? record.size,\n          contentType: uploaded.contentType ?? contentType ?? record.contentType,\n        })\n        .where(and(eq(storageAssets.id, record.id), eq(storageAssets.status, \"pending\")))\n        .returning();\n\n      if (!updated) {\n        throw new ServerError(\"INTERNAL_SERVER_ERROR\", {\n          message: \"Failed to finalize upload\",\n        });\n      }\n\n      return updated;\n    } catch (error) {\n      await this.#db\n        .update(storageAssets)\n        .set({ status: \"error\" })\n        .where(and(eq(storageAssets.id, record.id), eq(storageAssets.status, \"pending\")));\n\n      throw this.#parseError(error, {\n        fallbackMessage: \"Failed to upload object\",\n      });\n    }\n  }\n\n  /**\n   * Retrieves the object content for a ready storage asset.\n   *\n   * Flow:\n   * - Looks up the asset record by id, scoped to the current adapter provider\n   * - Ensures the asset is in `ready` status\n   * - Fetches object content from the storage adapter using the stored key\n   *\n   * @param id - The storage asset id\n   * @returns The adapter object response (stream/body + metadata)\n   * @throws {ServerError} If the asset does not exist or is not ready\n   * @example\n   * const object = await storageService.getObject(\"asset-123\");\n   * // object.body can be streamed/consumed by caller\n   */\n  async getObject(input: string) {\n    const id = z.uuid().parse(input);\n\n    const [record] = await this.#db\n      .select()\n      .from(storageAssets)\n      .where(\n        and(\n          eq(storageAssets.id, id),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          eq(storageAssets.status, \"ready\"),\n          isNull(storageAssets.deletedAt),\n        ),\n      )\n      .limit(1);\n\n    if (!record) {\n      throw new ServerError(\"NOT_FOUND\", { message: \"Storage asset not found\" });\n    }\n\n    return this.#adapter.getObject(record.key).catch((error) => {\n      throw this.#parseError(error, {\n        fallbackMessage: \"Failed to retrieve object\",\n      });\n    });\n  }\n\n  /**\n   * Generates a presigned read URL for a ready storage asset.\n   *\n   * Flow:\n   * - Validates the asset id\n   * - Resolves the asset record scoped to the current adapter provider\n   * - Ensures the asset is in `ready` status\n   * - Delegates URL signing to the storage adapter using the stored key\n   *\n   * @param input - Storage asset id (UUID)\n   * @param options - Optional URL options (for example expiration/disposition)\n   * @returns A presigned URL for reading the object\n   * @throws {ServerError} If the asset does not exist or is not ready\n   * @example\n   * const url = await storageService.getObjectURL(\"019d0051-2c0d-741e-9e3c-e5a5bc4d16a2\", {\n   *   expiresIn: 3600,\n   * });\n   */\n\n  async getObjectURL(input: string, options?: GetObjectURLOptions) {\n    const id = z.uuid().parse(input);\n\n    const [record] = await this.#db\n      .select()\n      .from(storageAssets)\n      .where(\n        and(\n          eq(storageAssets.id, id),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          eq(storageAssets.status, \"ready\"),\n          isNull(storageAssets.deletedAt),\n        ),\n      )\n      .limit(1);\n\n    if (!record) {\n      throw new ServerError(\"NOT_FOUND\", { message: \"Storage asset not found\" });\n    }\n\n    return this.#adapter.getObjectURL(record.key, options).catch((error) => {\n      throw this.#parseError(error, {\n        fallbackMessage: \"Failed to generate object URL\",\n      });\n    });\n  }\n\n  /**\n   * Soft deletes a single storage asset by id.\n   *\n   * This is a convenience wrapper around `deleteAssets`.\n   *\n   * @param input - Storage asset id (UUID)\n   * @returns The soft-deleted asset record, or null if not found/already deleted\n   */\n  async deleteAsset(input: string) {\n    const id = z.uuid().parse(input);\n    const [deleted] = await this.deleteAssets([id]);\n    return deleted ?? null;\n  }\n\n  /**\n   * Soft deletes multiple storage assets by setting `deletedAt`.\n   *\n   * Flow:\n   * - Validates and de-duplicates ids\n   * - Resolves provider-scoped active records\n   * - Marks matching rows as deleted by setting `deletedAt`\n   *\n   * @param input - Storage asset ids (UUID[])\n   * @returns Soft-deleted asset records\n   */\n  async deleteAssets(input: string[]) {\n    const ids = [...new Set(z.array(z.uuid()).parse(input))];\n    if (ids.length === 0) return [];\n\n    return this.#db\n      .update(storageAssets)\n      .set({ deletedAt: new Date() })\n      .where(\n        and(\n          inArray(storageAssets.id, ids),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          isNull(storageAssets.deletedAt),\n        ),\n      )\n      .returning();\n  }\n\n  /**\n   * Restores a single soft-deleted storage asset.\n   *\n   * This is a convenience wrapper around `restoreAssets`.\n   *\n   * @param input - Storage asset id (UUID)\n   * @returns The restored asset record, or null if not found/not deleted\n   */\n  async restoreAsset(input: string) {\n    const id = z.uuid().parse(input);\n    const [restored] = await this.restoreAssets([id]);\n    return restored ?? null;\n  }\n\n  /**\n   * Restores multiple soft-deleted storage assets by clearing `deletedAt`.\n   *\n   * @param input - Storage asset ids (UUID[])\n   * @returns Restored asset records\n   */\n  async restoreAssets(input: string[]) {\n    const ids = [...new Set(z.array(z.uuid()).parse(input))];\n    if (ids.length === 0) return [];\n\n    return this.#db\n      .update(storageAssets)\n      .set({ deletedAt: null })\n      .where(\n        and(\n          inArray(storageAssets.id, ids),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n          isNotNull(storageAssets.deletedAt),\n        ),\n      )\n      .returning();\n  }\n\n  /**\n   * Hard deletes a single storage asset.\n   *\n   * This is a convenience wrapper around `purgeAssets`.\n   *\n   * @param input - Storage asset id (UUID)\n   * @returns The purged asset record, or null if not found\n   */\n  async purgeAsset(input: string) {\n    const id = z.uuid().parse(input);\n    const [deleted] = await this.purgeAssets([id]);\n    return deleted ?? null;\n  }\n\n  /**\n   * Hard deletes multiple storage assets.\n   *\n   * Flow:\n   * - Validates and de-duplicates ids\n   * - Resolves provider-scoped records\n   * - Deletes physical objects from the adapter by key\n   * - Hard deletes DB records\n   *\n   * @param input - Storage asset ids (UUID[])\n   * @returns Purged asset records\n   * @throws {ServerError} If provider deletion fails\n   */\n  async purgeAssets(input: string[]) {\n    const ids = [...new Set(z.array(z.uuid()).parse(input))];\n    if (ids.length === 0) return [];\n\n    const records = await this.#db\n      .select({\n        id: storageAssets.id,\n        key: storageAssets.key,\n      })\n      .from(storageAssets)\n      .where(\n        and(\n          inArray(storageAssets.id, ids),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n        ),\n      );\n\n    if (records.length === 0) return [];\n\n    const keys = records.map((r) => r.key);\n\n    try {\n      await this.#adapter.deleteObjects(keys);\n    } catch (error) {\n      throw this.#parseError(error, {\n        fallbackMessage: \"Failed to delete storage objects\",\n      });\n    }\n\n    const deletedIds = records.map((r) => r.id);\n\n    const deleted = await this.#db\n      .delete(storageAssets)\n      .where(\n        and(\n          inArray(storageAssets.id, deletedIds),\n          eq(storageAssets.provider, this.#adapter.key),\n          eq(storageAssets.bucket, this.#adapter.bucketName),\n        ),\n      )\n      .returning();\n\n    return deleted;\n  }\n\n  /**\n   * Normalizes unknown adapter/service errors into a consistent `ServerError`.\n   *\n   * Behavior:\n   * - Returns existing `ServerError` instances unchanged\n   * - Maps known storage adapter errors to application-level server errors\n   * - Falls back to a generic internal server error for unknown failures\n   *\n   * This keeps adapter-specific errors inside the storage layer while exposing\n   * a stable error contract to route handlers and RPC procedures.\n   *\n   * @param error - The unknown error to normalize\n   * @param options - Optional fallback message for non-specific failures\n   * @returns A normalized `ServerError`\n   */\n\n  #parseError(error: unknown, options?: { fallbackMessage: string }) {\n    // If it's already a ServerError, return as-is to avoid double-wrapping\n    if (error instanceof ServerError) return error;\n\n    // Handle known storage adapter errors and convert to appropriate ServerError\n    if (error instanceof StorageAdapterError) {\n      if (error.code === \"OBJECT_NOT_FOUND\") {\n        return new ServerError(\"NOT_FOUND\", {\n          message: \"Storage asset not found\",\n          cause: error,\n        });\n      }\n\n      return new ServerError(\"INTERNAL_SERVER_ERROR\", {\n        message: options?.fallbackMessage ?? \"Storage adapter error\",\n        cause: error,\n      });\n    }\n\n    // For unknown errors, return a generic server error with limited information to avoid leaking details\n    return new ServerError(\"INTERNAL_SERVER_ERROR\", {\n      message: options?.fallbackMessage ?? \"Unknown storage error\",\n      cause: error instanceof Error ? error : undefined,\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/modules/storage/lib/upload.client.d.mts

@@ -0,0 +1,58 @@
+import { PresignUploadInput, PresignUploadOutput, SelectStorageAssetSchema } from "./validators.mjs";
+import { StorageRouterInputs, StorageRouterOutputs } from "./procedures.server.mjs";
+
+//#region src/modules/storage/lib/upload.client.d.ts
+/**
+ * Upload request
+ */
+type UploadFileRequest = PresignUploadInput & {
+  file: File;
+};
+type PrepareUploadInput = Omit<UploadFileRequest, "name" | "contentType" | "size">;
+type UploadHooks = {
+  beforePresign?: (input: UploadFileRequest) => Promise<void> | void;
+  afterPresign?: (presignResult: PresignUploadOutput) => Promise<void> | void;
+  beforeConfirm?: (presignResult: PresignUploadOutput) => Promise<void> | void;
+  afterConfirm?: (asset: SelectStorageAssetSchema) => Promise<void> | void;
+};
+/**
+ * Upload client
+ */
+type UploadClient = {
+  prepareUpload: (input: PrepareUploadInput) => UploadFileRequest;
+  upload: (input: UploadFileRequest, hooks?: UploadHooks) => Promise<SelectStorageAssetSchema>;
+  deleteAsset: (id: string) => Promise<SelectStorageAssetSchema | null>;
+  deleteAssets: (ids: string[]) => Promise<SelectStorageAssetSchema[]>;
+  restoreAsset: (id: string) => Promise<SelectStorageAssetSchema | null>;
+  restoreAssets: (ids: string[]) => Promise<SelectStorageAssetSchema[]>;
+  purgeAsset: (id: string) => Promise<SelectStorageAssetSchema | null>;
+  purgeAssets: (ids: string[]) => Promise<SelectStorageAssetSchema[]>;
+};
+/**
+ * Create upload client props
+ */
+type CreateStorageClientProps = {
+  endpoints: {
+    presign: (input: StorageRouterInputs["presign"]) => Promise<StorageRouterOutputs["presign"]>;
+    confirm: (uploadId: StorageRouterInputs["confirm"]) => Promise<StorageRouterOutputs["confirm"]>;
+    deleteAssets: (ids: StorageRouterInputs["deleteAssets"]) => Promise<StorageRouterOutputs["deleteAssets"]>;
+    deleteAsset: (id: StorageRouterInputs["deleteAsset"]) => Promise<StorageRouterOutputs["deleteAsset"]>;
+    restoreAsset: (id: StorageRouterInputs["restoreAsset"]) => Promise<StorageRouterOutputs["restoreAsset"]>;
+    restoreAssets: (ids: StorageRouterInputs["restoreAssets"]) => Promise<StorageRouterOutputs["restoreAssets"]>;
+    purgeAsset: (id: StorageRouterInputs["purgeAsset"]) => Promise<StorageRouterOutputs["purgeAsset"]>;
+    purgeAssets: (ids: StorageRouterInputs["purgeAssets"]) => Promise<StorageRouterOutputs["purgeAssets"]>;
+  };
+};
+/**
+ * Creates an upload client for the storage module.
+ *
+ * Flow:
+ * - Prepare upload payload with generated id and resolved key
+ * - Request presigned upload URL from server
+ * - Upload file bytes directly to object storage
+ * - Confirm upload and receive finalized storage asset
+ */
+declare function createUploadClient(props: CreateStorageClientProps): UploadClient;
+//#endregion
+export { PrepareUploadInput, UploadClient, UploadFileRequest, UploadHooks, createUploadClient };
+//# sourceMappingURL=upload.client.d.mts.map

package/dist/modules/storage/lib/upload.client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.client.d.mts","names":[],"sources":["../../../../src/modules/storage/lib/upload.client.ts"],"mappings":";;;;;;AAUA;KAAY,iBAAA,GAAoB,kBAAA;EAAuB,IAAA,EAAM,IAAA;AAAA;AAAA,KACjD,kBAAA,GAAqB,IAAA,CAAK,iBAAA;AAAA,KAC1B,WAAA;EACV,aAAA,IAAiB,KAAA,EAAO,iBAAA,KAAsB,OAAA;EAC9C,YAAA,IAAgB,aAAA,EAAe,mBAAA,KAAwB,OAAA;EACvD,aAAA,IAAiB,aAAA,EAAe,mBAAA,KAAwB,OAAA;EACxD,YAAA,IAAgB,KAAA,EAAO,wBAAA,KAA6B,OAAA;AAAA;;;;KAM1C,YAAA;EACV,aAAA,GAAgB,KAAA,EAAO,kBAAA,KAAuB,iBAAA;EAC9C,MAAA,GAAS,KAAA,EAAO,iBAAA,EAAmB,KAAA,GAAQ,WAAA,KAAgB,OAAA,CAAQ,wBAAA;EACnE,WAAA,GAAc,EAAA,aAAe,OAAA,CAAQ,wBAAA;EACrC,YAAA,GAAe,GAAA,eAAkB,OAAA,CAAQ,wBAAA;EACzC,YAAA,GAAe,EAAA,aAAe,OAAA,CAAQ,wBAAA;EACtC,aAAA,GAAgB,GAAA,eAAkB,OAAA,CAAQ,wBAAA;EAC1C,UAAA,GAAa,EAAA,aAAe,OAAA,CAAQ,wBAAA;EACpC,WAAA,GAAc,GAAA,eAAkB,OAAA,CAAQ,wBAAA;AAAA;;;;KAMrC,wBAAA;EACH,SAAA;IACE,OAAA,GAAU,KAAA,EAAO,mBAAA,gBAAmC,OAAA,CAAQ,oBAAA;IAC5D,OAAA,GAAU,QAAA,EAAU,mBAAA,gBAAmC,OAAA,CAAQ,oBAAA;IAC/D,YAAA,GACE,GAAA,EAAK,mBAAA,qBACF,OAAA,CAAQ,oBAAA;IACb,WAAA,GACE,EAAA,EAAI,mBAAA,oBACD,OAAA,CAAQ,oBAAA;IACb,YAAA,GACE,EAAA,EAAI,mBAAA,qBACD,OAAA,CAAQ,oBAAA;IACb,aAAA,GACE,GAAA,EAAK,mBAAA,sBACF,OAAA,CAAQ,oBAAA;IACb,UAAA,GACE,EAAA,EAAI,mBAAA,mBACD,OAAA,CAAQ,oBAAA;IACb,WAAA,GACE,GAAA,EAAK,mBAAA,oBACF,OAAA,CAAQ,oBAAA;EAAA;AAAA;;;;;;;AAnCjB;;;iBAgDgB,kBAAA,CAAmB,KAAA,EAAO,wBAAA,GAA2B,YAAA"}

package/dist/modules/storage/lib/upload.client.mjs

@@ -0,0 +1,87 @@
+//#region src/modules/storage/lib/upload.client.ts
+/**
+* Creates an upload client for the storage module.
+*
+* Flow:
+* - Prepare upload payload with generated id and resolved key
+* - Request presigned upload URL from server
+* - Upload file bytes directly to object storage
+* - Confirm upload and receive finalized storage asset
+*/
+function createUploadClient(props) {
+	/**
+	* Create input schema for the upload method
+	* @param {PrepareUploadInput} input
+	* @returns {UploadFileRequest}
+	*/
+	function prepareUpload(input) {
+		return {
+			...input,
+			uploadId: input.uploadId ?? crypto.randomUUID(),
+			name: input.file.name,
+			size: input.file.size,
+			contentType: input.file.type || "application/octet-stream"
+		};
+	}
+	/**
+	* Upload file to the server
+	* @param {UploadFileRequest} input
+	* @returns {Promise<SelectStorageAssetSchema>}
+	*/
+	async function upload(input, hooks) {
+		let presignResult = null;
+		try {
+			/**
+			* Presign
+			*/
+			await hooks?.beforePresign?.(input);
+			presignResult = await props.endpoints.presign(input);
+			await hooks?.afterPresign?.(presignResult);
+			/**
+			* Upload the file
+			*/
+			const uploadResponse = await fetch(presignResult.presignedUrl, {
+				method: "PUT",
+				headers: { "Content-Type": input.contentType || "application/octet-stream" },
+				body: input.file
+			});
+			if (!uploadResponse.ok) {
+				const message = await uploadResponse.text();
+				throw new Error(`Upload failed: ${message}`);
+			}
+			/**
+			* Confirm
+			*/
+			await hooks?.beforeConfirm?.(presignResult);
+			const asset = await props.endpoints.confirm(presignResult.uploadId);
+			await hooks?.afterConfirm?.(asset);
+			/**
+			* Return
+			*/
+			return asset;
+		} catch (err) {
+			console.error("Upload error: ", err);
+			/**
+			* Delete if upload failed
+			* */
+			if (presignResult) await props.endpoints.deleteAsset(presignResult.id).catch((deleteErr) => {
+				console.error("Failed to delete asset after upload error: ", deleteErr);
+			});
+			throw err;
+		}
+	}
+	return {
+		prepareUpload,
+		upload,
+		deleteAsset: props.endpoints.deleteAsset,
+		deleteAssets: props.endpoints.deleteAssets,
+		restoreAsset: props.endpoints.restoreAsset,
+		restoreAssets: props.endpoints.restoreAssets,
+		purgeAsset: props.endpoints.purgeAsset,
+		purgeAssets: props.endpoints.purgeAssets
+	};
+}
+
+//#endregion
+export { createUploadClient };
+//# sourceMappingURL=upload.client.mjs.map

package/dist/modules/storage/lib/upload.client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.client.mjs","names":[],"sources":["../../../../src/modules/storage/lib/upload.client.ts"],"sourcesContent":["import type { StorageRouterInputs, StorageRouterOutputs } from \"./procedures.server\";\nimport type {\n  PresignUploadInput,\n  PresignUploadOutput,\n  SelectStorageAssetSchema,\n} from \"./validators\";\n\n/**\n * Upload request\n */\nexport type UploadFileRequest = PresignUploadInput & { file: File };\nexport type PrepareUploadInput = Omit<UploadFileRequest, \"name\" | \"contentType\" | \"size\">;\nexport type UploadHooks = {\n  beforePresign?: (input: UploadFileRequest) => Promise<void> | void;\n  afterPresign?: (presignResult: PresignUploadOutput) => Promise<void> | void;\n  beforeConfirm?: (presignResult: PresignUploadOutput) => Promise<void> | void;\n  afterConfirm?: (asset: SelectStorageAssetSchema) => Promise<void> | void;\n};\n\n/**\n * Upload client\n */\nexport type UploadClient = {\n  prepareUpload: (input: PrepareUploadInput) => UploadFileRequest;\n  upload: (input: UploadFileRequest, hooks?: UploadHooks) => Promise<SelectStorageAssetSchema>;\n  deleteAsset: (id: string) => Promise<SelectStorageAssetSchema | null>;\n  deleteAssets: (ids: string[]) => Promise<SelectStorageAssetSchema[]>;\n  restoreAsset: (id: string) => Promise<SelectStorageAssetSchema | null>;\n  restoreAssets: (ids: string[]) => Promise<SelectStorageAssetSchema[]>;\n  purgeAsset: (id: string) => Promise<SelectStorageAssetSchema | null>;\n  purgeAssets: (ids: string[]) => Promise<SelectStorageAssetSchema[]>;\n};\n\n/**\n * Create upload client props\n */\ntype CreateStorageClientProps = {\n  endpoints: {\n    presign: (input: StorageRouterInputs[\"presign\"]) => Promise<StorageRouterOutputs[\"presign\"]>;\n    confirm: (uploadId: StorageRouterInputs[\"confirm\"]) => Promise<StorageRouterOutputs[\"confirm\"]>;\n    deleteAssets: (\n      ids: StorageRouterInputs[\"deleteAssets\"],\n    ) => Promise<StorageRouterOutputs[\"deleteAssets\"]>;\n    deleteAsset: (\n      id: StorageRouterInputs[\"deleteAsset\"],\n    ) => Promise<StorageRouterOutputs[\"deleteAsset\"]>;\n    restoreAsset: (\n      id: StorageRouterInputs[\"restoreAsset\"],\n    ) => Promise<StorageRouterOutputs[\"restoreAsset\"]>;\n    restoreAssets: (\n      ids: StorageRouterInputs[\"restoreAssets\"],\n    ) => Promise<StorageRouterOutputs[\"restoreAssets\"]>;\n    purgeAsset: (\n      id: StorageRouterInputs[\"purgeAsset\"],\n    ) => Promise<StorageRouterOutputs[\"purgeAsset\"]>;\n    purgeAssets: (\n      ids: StorageRouterInputs[\"purgeAssets\"],\n    ) => Promise<StorageRouterOutputs[\"purgeAssets\"]>;\n  };\n};\n\n/**\n * Creates an upload client for the storage module.\n *\n * Flow:\n * - Prepare upload payload with generated id and resolved key\n * - Request presigned upload URL from server\n * - Upload file bytes directly to object storage\n * - Confirm upload and receive finalized storage asset\n */\nexport function createUploadClient(props: CreateStorageClientProps): UploadClient {\n  /**\n   * Create input schema for the upload method\n   * @param {PrepareUploadInput} input\n   * @returns {UploadFileRequest}\n   */\n  function prepareUpload(input: PrepareUploadInput): UploadFileRequest {\n    return {\n      ...input,\n      uploadId: input.uploadId ?? crypto.randomUUID(),\n      name: input.file.name,\n      size: input.file.size,\n      contentType: input.file.type || \"application/octet-stream\",\n    };\n  }\n\n  /**\n   * Upload file to the server\n   * @param {UploadFileRequest} input\n   * @returns {Promise<SelectStorageAssetSchema>}\n   */\n  async function upload(\n    input: UploadFileRequest,\n    hooks?: UploadHooks,\n  ): Promise<SelectStorageAssetSchema> {\n    let presignResult: PresignUploadOutput | null = null;\n\n    try {\n      /**\n       * Presign\n       */\n      await hooks?.beforePresign?.(input);\n      presignResult = await props.endpoints.presign(input);\n      await hooks?.afterPresign?.(presignResult);\n\n      /**\n       * Upload the file\n       */\n      const uploadResponse = await fetch(presignResult.presignedUrl, {\n        method: \"PUT\",\n        headers: { \"Content-Type\": input.contentType || \"application/octet-stream\" },\n        body: input.file,\n      });\n\n      if (!uploadResponse.ok) {\n        const message = await uploadResponse.text();\n        throw new Error(`Upload failed: ${message}`);\n      }\n\n      /**\n       * Confirm\n       */\n      await hooks?.beforeConfirm?.(presignResult);\n      const asset = await props.endpoints.confirm(presignResult.uploadId);\n      await hooks?.afterConfirm?.(asset);\n      /**\n       * Return\n       */\n      return asset;\n    } catch (err) {\n      console.error(\"Upload error: \", err);\n\n      /**\n       * Delete if upload failed\n       * */\n      if (presignResult) {\n        await props.endpoints.deleteAsset(presignResult.id).catch((deleteErr) => {\n          console.error(\"Failed to delete asset after upload error: \", deleteErr);\n        });\n      }\n\n      throw err;\n    }\n  }\n\n  return {\n    prepareUpload,\n    upload,\n    deleteAsset: props.endpoints.deleteAsset,\n    deleteAssets: props.endpoints.deleteAssets,\n    restoreAsset: props.endpoints.restoreAsset,\n    restoreAssets: props.endpoints.restoreAssets,\n    purgeAsset: props.endpoints.purgeAsset,\n    purgeAssets: props.endpoints.purgeAssets,\n  };\n}\n"],"mappings":";;;;;;;;;;AAsEA,SAAgB,mBAAmB,OAA+C;;;;;;CAMhF,SAAS,cAAc,OAA8C;AACnE,SAAO;GACL,GAAG;GACH,UAAU,MAAM,YAAY,OAAO,YAAY;GAC/C,MAAM,MAAM,KAAK;GACjB,MAAM,MAAM,KAAK;GACjB,aAAa,MAAM,KAAK,QAAQ;GACjC;;;;;;;CAQH,eAAe,OACb,OACA,OACmC;EACnC,IAAI,gBAA4C;AAEhD,MAAI;;;;AAIF,SAAM,OAAO,gBAAgB,MAAM;AACnC,mBAAgB,MAAM,MAAM,UAAU,QAAQ,MAAM;AACpD,SAAM,OAAO,eAAe,cAAc;;;;GAK1C,MAAM,iBAAiB,MAAM,MAAM,cAAc,cAAc;IAC7D,QAAQ;IACR,SAAS,EAAE,gBAAgB,MAAM,eAAe,4BAA4B;IAC5E,MAAM,MAAM;IACb,CAAC;AAEF,OAAI,CAAC,eAAe,IAAI;IACtB,MAAM,UAAU,MAAM,eAAe,MAAM;AAC3C,UAAM,IAAI,MAAM,kBAAkB,UAAU;;;;;AAM9C,SAAM,OAAO,gBAAgB,cAAc;GAC3C,MAAM,QAAQ,MAAM,MAAM,UAAU,QAAQ,cAAc,SAAS;AACnE,SAAM,OAAO,eAAe,MAAM;;;;AAIlC,UAAO;WACA,KAAK;AACZ,WAAQ,MAAM,kBAAkB,IAAI;;;;AAKpC,OAAI,cACF,OAAM,MAAM,UAAU,YAAY,cAAc,GAAG,CAAC,OAAO,cAAc;AACvE,YAAQ,MAAM,+CAA+C,UAAU;KACvE;AAGJ,SAAM;;;AAIV,QAAO;EACL;EACA;EACA,aAAa,MAAM,UAAU;EAC7B,cAAc,MAAM,UAAU;EAC9B,cAAc,MAAM,UAAU;EAC9B,eAAe,MAAM,UAAU;EAC/B,YAAY,MAAM,UAAU;EAC5B,aAAa,MAAM,UAAU;EAC9B"}