alepha 0.20.5 → 0.20.7

package/dist/topic/redis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/topic/redis/providers/RedisTopicProvider.ts","../../../src/topic/redis/index.ts"],"sourcesContent":["import { $atom, $hook, $inject, $state, Alepha, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, RedisSubscriberProvider } from \"alepha/redis\";\nimport {\n  type SubscribeCallback,\n  TopicProvider,\n  type TopicPublishOptions,\n  type TopicSubscribeOptions,\n  type UnSubscribeFn,\n} from \"alepha/topic\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Redis topic configuration atom.\n */\nexport const redisTopicOptions = $atom({\n  name: \"alepha.topic.redis.options\",\n  schema: t.object({\n    prefix: t.text({\n      default: \"topic\",\n      description: \"Prefix for all topic channels in Redis.\",\n    }),\n  }),\n  default: {\n    prefix: \"topic\",\n  },\n});\n\nexport type RedisTopicOptions = Static<typeof redisTopicOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [redisTopicOptions.key]: RedisTopicOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RedisTopicProvider extends TopicProvider {\n  protected readonly options = $state(redisTopicOptions);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(RedisProvider);\n  protected readonly redisSubscriberProvider = $inject(RedisSubscriberProvider);\n\n  protected readonly log = $logger();\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: async () => {\n      const subscribers = this.subscribers();\n      if (subscribers.length) {\n        await Promise.all(subscribers.map((fn) => fn()));\n        for (const subscriber of subscribers) {\n          this.log.debug(`Subscribed to topic '${subscriber.name}'`);\n        }\n      }\n    },\n  });\n\n  protected override wildcardChar(): string {\n    return \"*\";\n  }\n\n  public prefix(queue: string): string {\n    return `${this.options.prefix}:${queue}`;\n  }\n\n  /**\n   * Publish a message to a topic.\n   */\n  public async publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    if (options?.retain) {\n      await this.redisProvider.set(`${this.prefix(topic)}:retained`, message);\n    }\n    await this.redisProvider.publish(this.prefix(topic), message);\n  }\n\n  /**\n   * Subscribe to a topic.\n   */\n  public async subscribe(\n    name: string,\n    callback: SubscribeCallback,\n    _options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    const topic = this.prefix(name);\n\n    // Subscribe first to avoid message loss window\n    await this.redisSubscriberProvider.subscribe(topic, callback);\n\n    // Then deliver retained message if exists\n    const retained = await this.redisProvider.get(`${topic}:retained`);\n    if (retained) {\n      await callback(retained.toString());\n    }\n\n    return () => this.unsubscribe(name, callback);\n  }\n\n  /**\n   * Unsubscribe from a topic.\n   */\n  public async unsubscribe(\n    name: string,\n    callback?: SubscribeCallback,\n  ): Promise<void> {\n    const topic = this.prefix(name);\n\n    await this.redisSubscriberProvider.unsubscribe(topic, callback);\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaTopic, TopicProvider } from \"alepha/topic\";\nimport { RedisTopicProvider } from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Topic that provides Redis pub/sub capabilities.\n *\n * @see {@link RedisTopicProvider}\n * @module alepha.topic.redis\n */\nexport const AlephaTopicRedis = $module({\n  name: \"alepha.topic.redis\",\n  services: [RedisTopicProvider],\n  register: (alepha: Alepha): Alepha =>\n    alepha\n      .with({\n        optional: true,\n        provide: TopicProvider,\n        use: RedisTopicProvider,\n      })\n      .with(AlephaTopic),\n});\n"],"mappings":";;;;;;;;AAgBA,MAAa,oBAAoB,MAAM;CACrC,MAAM;CACN,QAAQ,EAAE,OAAO,EACf,QAAQ,EAAE,KAAK;EACb,SAAS;EACT,aAAa;EACd,CAAC,EACH,CAAC;CACF,SAAS,EACP,QAAQ,SACT;CACF,CAAC;AAYF,IAAa,qBAAb,cAAwC,cAAc;CACpD,UAA6B,OAAO,kBAAkB;CACtD,SAA4B,QAAQ,OAAO;CAC3C,gBAAmC,QAAQ,cAAc;CACzD,0BAA6C,QAAQ,wBAAwB;CAE7E,MAAyB,SAAS;CAElC,QAA2B,MAAM;EAC/B,IAAI;EACJ,SAAS,YAAY;GACnB,MAAM,cAAc,KAAK,aAAa;AACtC,OAAI,YAAY,QAAQ;AACtB,UAAM,QAAQ,IAAI,YAAY,KAAK,OAAO,IAAI,CAAC,CAAC;AAChD,SAAK,MAAM,cAAc,YACvB,MAAK,IAAI,MAAM,wBAAwB,WAAW,KAAK,GAAG;;;EAIjE,CAAC;CAEF,eAA0C;AACxC,SAAO;;CAGT,OAAc,OAAuB;AACnC,SAAO,GAAG,KAAK,QAAQ,OAAO,GAAG;;;;;CAMnC,MAAa,QACX,OACA,SACA,SACe;AACf,MAAI,SAAS,OACX,OAAM,KAAK,cAAc,IAAI,GAAG,KAAK,OAAO,MAAM,CAAC,YAAY,QAAQ;AAEzE,QAAM,KAAK,cAAc,QAAQ,KAAK,OAAO,MAAM,EAAE,QAAQ;;;;;CAM/D,MAAa,UACX,MACA,UACA,UACwB;EACxB,MAAM,QAAQ,KAAK,OAAO,KAAK;AAG/B,QAAM,KAAK,wBAAwB,UAAU,OAAO,SAAS;EAG7D,MAAM,WAAW,MAAM,KAAK,cAAc,IAAI,GAAG,MAAM,WAAW;AAClE,MAAI,SACF,OAAM,SAAS,SAAS,UAAU,CAAC;AAGrC,eAAa,KAAK,YAAY,MAAM,SAAS;;;;;CAM/C,MAAa,YACX,MACA,UACe;EACf,MAAM,QAAQ,KAAK,OAAO,KAAK;AAE/B,QAAM,KAAK,wBAAwB,YAAY,OAAO,SAAS;;;;;;;;;;;ACjGnE,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK,YAAY;CACvB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/topic/redis/providers/RedisTopicProvider.ts","../../../src/topic/redis/index.ts"],"sourcesContent":["import { $atom, $hook, $inject, $state, Alepha, type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider, RedisSubscriberProvider } from \"alepha/redis\";\nimport {\n  type SubscribeCallback,\n  TopicProvider,\n  type TopicPublishOptions,\n  type TopicSubscribeOptions,\n  type UnSubscribeFn,\n} from \"alepha/topic\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Redis topic configuration atom.\n */\nexport const redisTopicOptions = $atom({\n  name: \"alepha.topic.redis.options\",\n  schema: t.object({\n    prefix: t.text({\n      default: \"topic\",\n      description: \"Prefix for all topic channels in Redis.\",\n    }),\n  }),\n  default: {\n    prefix: \"topic\",\n  },\n});\n\nexport type RedisTopicOptions = Static<typeof redisTopicOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [redisTopicOptions.key]: RedisTopicOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RedisTopicProvider extends TopicProvider {\n  protected readonly options = $state(redisTopicOptions);\n  protected readonly alepha = $inject(Alepha);\n  protected readonly redisProvider = $inject(RedisProvider);\n  protected readonly redisSubscriberProvider = $inject(RedisSubscriberProvider);\n\n  protected readonly log = $logger();\n\n  protected readonly start = $hook({\n    on: \"start\",\n    handler: async () => {\n      const subscribers = this.subscribers();\n      if (subscribers.length) {\n        await Promise.all(subscribers.map((fn) => fn()));\n        for (const subscriber of subscribers) {\n          this.log.debug(`Subscribed to topic '${subscriber.name}'`);\n        }\n      }\n    },\n  });\n\n  protected override wildcardChar(): string {\n    return \"*\";\n  }\n\n  public prefix(queue: string): string {\n    return `${this.options.prefix}:${queue}`;\n  }\n\n  /**\n   * Publish a message to a topic.\n   */\n  public async publish(\n    topic: string,\n    message: string,\n    options?: TopicPublishOptions,\n  ): Promise<void> {\n    if (options?.retain) {\n      await this.redisProvider.set(`${this.prefix(topic)}:retained`, message);\n    }\n    await this.redisProvider.publish(this.prefix(topic), message);\n  }\n\n  /**\n   * Subscribe to a topic.\n   */\n  public async subscribe(\n    name: string,\n    callback: SubscribeCallback,\n    _options?: TopicSubscribeOptions,\n  ): Promise<UnSubscribeFn> {\n    const topic = this.prefix(name);\n\n    // Subscribe first to avoid message loss window\n    await this.redisSubscriberProvider.subscribe(topic, callback);\n\n    // Then deliver retained message if exists\n    const retained = await this.redisProvider.get(`${topic}:retained`);\n    if (retained) {\n      await callback(retained.toString());\n    }\n\n    return () => this.unsubscribe(name, callback);\n  }\n\n  /**\n   * Unsubscribe from a topic.\n   */\n  public async unsubscribe(\n    name: string,\n    callback?: SubscribeCallback,\n  ): Promise<void> {\n    const topic = this.prefix(name);\n\n    await this.redisSubscriberProvider.unsubscribe(topic, callback);\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaTopic, TopicProvider } from \"alepha/topic\";\nimport { RedisTopicProvider } from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisTopicProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Topic that provides Redis pub/sub capabilities.\n *\n * @see {@link RedisTopicProvider}\n * @module alepha.topic.redis\n */\nexport const AlephaTopicRedis = $module({\n  name: \"alepha.topic.redis\",\n  services: [RedisTopicProvider],\n  register: (alepha: Alepha): Alepha =>\n    alepha\n      .with({\n        optional: true,\n        provide: TopicProvider,\n        use: RedisTopicProvider,\n      })\n      .with(AlephaTopic),\n});\n"],"mappings":";;;;;;;;AAgBA,MAAa,oBAAoB,MAAM;CACrC,MAAM;CACN,QAAQ,EAAE,OAAO,EACf,QAAQ,EAAE,KAAK;EACb,SAAS;EACT,aAAa;EACd,CAAC,EACH,CAAC;CACF,SAAS,EACP,QAAQ,SACT;CACF,CAAC;AAYF,IAAa,qBAAb,cAAwC,cAAc;CACpD,UAA6B,OAAO,kBAAkB;CACtD,SAA4B,QAAQ,OAAO;CAC3C,gBAAmC,QAAQ,cAAc;CACzD,0BAA6C,QAAQ,wBAAwB;CAE7E,MAAyB,SAAS;CAElC,QAA2B,MAAM;EAC/B,IAAI;EACJ,SAAS,YAAY;GACnB,MAAM,cAAc,KAAK,aAAa;GACtC,IAAI,YAAY,QAAQ;IACtB,MAAM,QAAQ,IAAI,YAAY,KAAK,OAAO,IAAI,CAAC,CAAC;IAChD,KAAK,MAAM,cAAc,aACvB,KAAK,IAAI,MAAM,wBAAwB,WAAW,KAAK,GAAG;;;EAIjE,CAAC;CAEF,eAA0C;EACxC,OAAO;;CAGT,OAAc,OAAuB;EACnC,OAAO,GAAG,KAAK,QAAQ,OAAO,GAAG;;;;;CAMnC,MAAa,QACX,OACA,SACA,SACe;EACf,IAAI,SAAS,QACX,MAAM,KAAK,cAAc,IAAI,GAAG,KAAK,OAAO,MAAM,CAAC,YAAY,QAAQ;EAEzE,MAAM,KAAK,cAAc,QAAQ,KAAK,OAAO,MAAM,EAAE,QAAQ;;;;;CAM/D,MAAa,UACX,MACA,UACA,UACwB;EACxB,MAAM,QAAQ,KAAK,OAAO,KAAK;EAG/B,MAAM,KAAK,wBAAwB,UAAU,OAAO,SAAS;EAG7D,MAAM,WAAW,MAAM,KAAK,cAAc,IAAI,GAAG,MAAM,WAAW;EAClE,IAAI,UACF,MAAM,SAAS,SAAS,UAAU,CAAC;EAGrC,aAAa,KAAK,YAAY,MAAM,SAAS;;;;;CAM/C,MAAa,YACX,MACA,UACe;EACf,MAAM,QAAQ,KAAK,OAAO,KAAK;EAE/B,MAAM,KAAK,wBAAwB,YAAY,OAAO,SAAS;;;;;;;;;;;ACjGnE,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OACG,KAAK;EACJ,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC,CACD,KAAK,YAAY;CACvB,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "alepha",
   "description": "Easy-to-use modern TypeScript framework for building many kind of applications.",
   "author": "Feunard",
-  "version": "0.20.5",
+  "version": "0.20.7",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -27,25 +27,23 @@
     "postgres": "^3.4.9",
     "s3mini": "^0.9.4",
     "tsx": "^4.21.0",
-    "typebox": "^1.1.37",
+    "typebox": "^1.1.38",
     "typescript": "^6.0.3",
-    "vite-bundle-analyzer": "^1.3.8",
-    "ws": "^8.20.0"
+    "vite-bundle-analyzer": "^1.3.8"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.14",
-    "@cloudflare/workers-types": "^4.20260503.1",
+    "@biomejs/biome": "^2.4.15",
+    "@cloudflare/workers-types": "^4.20260510.1",
     "@electric-sql/pglite": "^0.4.5",
     "@faker-js/faker": "^10.4.0",
-    "@tailwindcss/vite": "^4.2.4",
+    "@tailwindcss/vite": "^4.3.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/bun": "^1.3.13",
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.6.2",
     "@types/nodemailer": "^8.0.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@types/ws": "^8.18.1",
     "cron-schedule": "^6.0.0",
     "drizzle-kit": "^0.31.10",
     "jose": "^6.2.3",
@@ -53,13 +51,13 @@
     "nodemailer": "^8.0.7",
     "openid-client": "^6.8.4",
     "prom-client": "^15.1.3",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "shadcn": "^4.6.0",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "shadcn": "^4.7.0",
     "swagger-ui-dist": "^5.32.5",
-    "tailwindcss": "^4.2.4",
-    "tsdown": "^0.21.10",
-    "vite": "^8.0.10",
+    "tailwindcss": "^4.3.0",
+    "tsdown": "^0.22.0",
+    "vite": "^8.0.11",
     "vitest": "^4.1.5"
   },
   "peerDependencies": {
@@ -151,6 +149,11 @@
       "import": "./dist/api/payments/index.js",
       "default": "./dist/api/payments/index.js"
     },
+    "./api/subscriptions": {
+      "types": "./dist/api/subscriptions/index.d.ts",
+      "import": "./dist/api/subscriptions/index.js",
+      "default": "./dist/api/subscriptions/index.js"
+    },
     "./api/users": {
       "types": "./dist/api/users/index.d.ts",
       "react-native": "./dist/api/users/index.browser.js",
@@ -187,6 +190,11 @@
       "import": "./dist/cache/core/index.js",
       "default": "./dist/cache/core/index.js"
     },
+    "./cache/database": {
+      "types": "./dist/cache/database/index.d.ts",
+      "import": "./dist/cache/database/index.js",
+      "default": "./dist/cache/database/index.js"
+    },
     "./cache/redis": {
       "types": "./dist/cache/redis/index.d.ts",
       "import": "./dist/cache/redis/index.js",
@@ -364,11 +372,6 @@
       "import": "./dist/react/ui/index.js",
       "default": "./dist/react/ui/index.js"
     },
-    "./react/websocket": {
-      "types": "./dist/react/websocket/index.d.ts",
-      "import": "./dist/react/websocket/index.js",
-      "default": "./dist/react/websocket/index.js"
-    },
     "./redis": {
       "types": "./dist/redis/index.d.ts",
       "bun": "./dist/redis/index.bun.js",
@@ -489,13 +492,6 @@
       "import": "./dist/topic/redis/index.js",
       "default": "./dist/topic/redis/index.js"
     },
-    "./websocket": {
-      "types": "./dist/websocket/index.d.ts",
-      "react-native": "./dist/websocket/index.browser.js",
-      "browser": "./dist/websocket/index.browser.js",
-      "import": "./dist/websocket/index.js",
-      "default": "./dist/websocket/index.js"
-    },
     "./tsconfig.base": "./tsconfig.base.json",
     "./package.json": "./package.json"
   },
@@ -556,6 +552,11 @@
         "import": "./dist/api/payments/index.js",
         "default": "./dist/api/payments/index.js"
       },
+      "./api/subscriptions": {
+        "types": "./dist/api/subscriptions/index.d.ts",
+        "import": "./dist/api/subscriptions/index.js",
+        "default": "./dist/api/subscriptions/index.js"
+      },
       "./api/users": {
         "types": "./dist/api/users/index.d.ts",
         "react-native": "./dist/api/users/index.browser.js",
@@ -592,6 +593,11 @@
         "import": "./dist/cache/core/index.js",
         "default": "./dist/cache/core/index.js"
       },
+      "./cache/database": {
+        "types": "./dist/cache/database/index.d.ts",
+        "import": "./dist/cache/database/index.js",
+        "default": "./dist/cache/database/index.js"
+      },
       "./cache/redis": {
         "types": "./dist/cache/redis/index.d.ts",
         "import": "./dist/cache/redis/index.js",
@@ -769,11 +775,6 @@
         "import": "./dist/react/ui/index.js",
         "default": "./dist/react/ui/index.js"
       },
-      "./react/websocket": {
-        "types": "./dist/react/websocket/index.d.ts",
-        "import": "./dist/react/websocket/index.js",
-        "default": "./dist/react/websocket/index.js"
-      },
       "./redis": {
         "types": "./dist/redis/index.d.ts",
         "bun": "./dist/redis/index.bun.js",
@@ -894,13 +895,6 @@
         "import": "./dist/topic/redis/index.js",
         "default": "./dist/topic/redis/index.js"
       },
-      "./websocket": {
-        "types": "./dist/websocket/index.d.ts",
-        "react-native": "./dist/websocket/index.browser.js",
-        "browser": "./dist/websocket/index.browser.js",
-        "import": "./dist/websocket/index.js",
-        "default": "./dist/websocket/index.js"
-      },
       "./tsconfig.base": "./tsconfig.base.json",
       "./package.json": "./package.json"
     }

package/src/api/audits/controllers/AdminAuditController.ts

@@ -1,6 +1,8 @@
 import { $inject, t } from "alepha";
+import { $repository } from "alepha/orm";
 import { $secure } from "alepha/security";
 import { $action } from "alepha/server";
+import { audits } from "../entities/audits.ts";
 import { auditQuerySchema } from "../schemas/auditQuerySchema.ts";
 import { auditResourceSchema } from "../schemas/auditResourceSchema.ts";
 import { createAuditSchema } from "../schemas/createAuditSchema.ts";
@@ -19,6 +21,7 @@ export class AdminAuditController {
   protected readonly url = "/audits";
   protected readonly group = "admin:audits";
   protected readonly auditService = $inject(AuditService);
+  protected readonly repo = $repository(audits);
 
   /**
    * Find audit entries with filtering and pagination.
@@ -52,6 +55,32 @@ export class AdminAuditController {
     handler: ({ params }) => this.auditService.getById(params.id),
   });
 
+  /**
+   * Delete many audit entries by id in one repository call. Use with care —
+   * audit logs are usually retained for compliance reasons.
+   */
+  public readonly deleteAudits = $action({
+    method: "POST",
+    path: `${this.url}/delete`,
+    group: this.group,
+    use: [$secure({ permissions: ["admin:audit:delete"] })],
+    description: "Delete many audit entries",
+    schema: {
+      body: t.object({
+        ids: t.array(t.text(), { minItems: 1, maxItems: 1000 }),
+      }),
+      response: t.object({
+        deleted: t.array(t.text()),
+      }),
+    },
+    handler: async ({ body }) => {
+      const deleted = await this.repo.deleteMany({
+        id: { inArray: body.ids },
+      });
+      return { deleted: deleted.map(String) };
+    },
+  });
+
   /**
    * Create a new audit entry.
    * System-only — this permission should never be assigned to human roles.

package/src/api/audits/entities/audits.ts

@@ -26,6 +26,7 @@ export const audits = $entity({
   schema: t.object({
     id: db.primaryKey(t.bigint()),
     createdAt: db.createdAt(),
+    organizationId: db.organization(),
 
     /**
      * Audit event type (e.g., "auth", "user", "payment", "system").

package/src/api/files/controllers/FileController.ts

@@ -50,6 +50,30 @@ export class FileController {
     handler: ({ params }) => this.fileService.deleteFile(params.id),
   });
 
+  /**
+   * POST /files/delete - Delete many files in one request, batching the
+   * underlying bucket calls per bucket (R2/S3 batch where supported).
+   */
+  public readonly deleteFiles = $action({
+    method: "POST",
+    path: `${this.url}/delete`,
+    group: `admin:${this.group}`,
+    use: [$secure({ permissions: ["admin:file:delete"] })],
+    description: "Delete many files",
+    schema: {
+      body: t.object({
+        ids: t.array(t.uuid(), { minItems: 1, maxItems: 1000 }),
+      }),
+      response: t.object({
+        deleted: t.array(t.string()),
+      }),
+    },
+    handler: async ({ body }) => {
+      const deleted = await this.fileService.deleteFiles(body.ids);
+      return { deleted };
+    },
+  });
+
   /**
    * POST /files - Uploads a new file to storage.
    * Creates a database record with metadata and calculates checksum.

package/src/api/files/entities/files.ts

@@ -8,6 +8,7 @@ export const files = $entity({
     version: db.version(),
     createdAt: db.createdAt(),
     updatedAt: db.updatedAt(),
+    organizationId: db.organization(),
     blobId: t.text(),
     creator: t.optional(t.uuid()),
     creatorRealm: t.optional(t.string()),

package/src/api/files/services/FileService.ts

@@ -324,6 +324,47 @@ export class FileService {
     return { ok: true, id: String(file.id) };
   }
 
+  /**
+   * Delete many files in one round-trip per bucket. The database rows are
+   * removed in a single `deleteMany`, and each affected bucket gets a single
+   * `bucket.deleteMany` call (R2/S3 batch where supported).
+   */
+  public async deleteFiles(ids: string[]): Promise<string[]> {
+    if (ids.length === 0) return [];
+
+    const files = await this.fileRepository.findMany({
+      where: { id: { inArray: ids } },
+      columns: ["id", "bucket", "blobId"],
+    });
+    if (files.length === 0) return [];
+
+    const dbDeleted = await this.fileRepository.deleteMany({
+      id: { inArray: files.map((f) => f.id) },
+    });
+
+    const blobsByBucket = new Map<string, string[]>();
+    for (const f of files) {
+      const list = blobsByBucket.get(f.bucket) ?? [];
+      list.push(f.blobId);
+      blobsByBucket.set(f.bucket, list);
+    }
+
+    for (const [bucketName, blobIds] of blobsByBucket) {
+      try {
+        await this.bucket(bucketName).deleteMany(blobIds, true);
+      } catch (e) {
+        // DB rows already gone — log and continue. Orphaned blobs are
+        // recoverable; orphaned DB rows would be worse.
+        this.log.warn(
+          `Failed to bulk-delete ${blobIds.length} files from bucket ${bucketName}`,
+          e,
+        );
+      }
+    }
+
+    return dbDeleted.map(String);
+  }
+
   /**
    * Retrieves a file entity by its ID.
    * If already an entity object, returns it as-is (convenience method).