@headless-lms/core 0.2.0 → 0.4.0

package/dist/assets/events.d.ts

@@ -6,7 +6,8 @@ declare const assetEvents: {
     orgId: string;
     id: string;
     key: string;
-    kind: "video" | "download" | "content";
+    kind: "image" | "video" | "audio" | "document";
+    source: "library" | "member";
     filename: string;
     contentType: string;
     size: number;
@@ -18,7 +19,8 @@ declare const assetEvents: {
     orgId: string;
     id: string;
     key: string;
-    kind: "video" | "download" | "content";
+    kind: "image" | "video" | "audio" | "document";
+    source: "library" | "member";
     filename: string;
     contentType: string;
     size: number;
@@ -27,21 +29,25 @@ declare const assetEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     kind: import("zod").ZodEnum<{
+      image: "image";
       video: "video";
-      download: "download";
-      content: "content";
+      audio: "audio";
+      document: "document";
+    }>;
+    source: import("zod").ZodEnum<{
+      library: "library";
+      member: "member";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       pending: "pending";
       ready: "ready";
     }>;
     uploadedBy: import("zod").ZodString;
-    key: import("zod").ZodString;
     filename: import("zod").ZodString;
     contentType: import("zod").ZodString;
     size: import("zod").ZodNumber;
@@ -50,7 +56,8 @@ declare const assetEvents: {
     orgId: string;
     id: string;
     key: string;
-    kind: "video" | "download" | "content";
+    kind: "image" | "video" | "audio" | "document";
+    source: "library" | "member";
     filename: string;
     contentType: string;
     size: number;
@@ -62,7 +69,8 @@ declare const assetEvents: {
     orgId: string;
     id: string;
     key: string;
-    kind: "video" | "download" | "content";
+    kind: "image" | "video" | "audio" | "document";
+    source: "library" | "member";
     filename: string;
     contentType: string;
     size: number;
@@ -71,21 +79,25 @@ declare const assetEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     kind: import("zod").ZodEnum<{
+      image: "image";
       video: "video";
-      download: "download";
-      content: "content";
+      audio: "audio";
+      document: "document";
+    }>;
+    source: import("zod").ZodEnum<{
+      library: "library";
+      member: "member";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       pending: "pending";
       ready: "ready";
     }>;
     uploadedBy: import("zod").ZodString;
-    key: import("zod").ZodString;
     filename: import("zod").ZodString;
     contentType: import("zod").ZodString;
     size: import("zod").ZodNumber;
@@ -94,7 +106,8 @@ declare const assetEvents: {
     orgId: string;
     id: string;
     key: string;
-    kind: "video" | "download" | "content";
+    kind: "image" | "video" | "audio" | "document";
+    source: "library" | "member";
     filename: string;
     contentType: string;
     size: number;
@@ -106,7 +119,8 @@ declare const assetEvents: {
     orgId: string;
     id: string;
     key: string;
-    kind: "video" | "download" | "content";
+    kind: "image" | "video" | "audio" | "document";
+    source: "library" | "member";
     filename: string;
     contentType: string;
     size: number;
@@ -115,21 +129,25 @@ declare const assetEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     kind: import("zod").ZodEnum<{
+      image: "image";
       video: "video";
-      download: "download";
-      content: "content";
+      audio: "audio";
+      document: "document";
+    }>;
+    source: import("zod").ZodEnum<{
+      library: "library";
+      member: "member";
     }>;
-    createdAt: import("zod").ZodCoercedDate<unknown>;
-    updatedAt: import("zod").ZodCoercedDate<unknown>;
     status: import("zod").ZodEnum<{
       pending: "pending";
       ready: "ready";
     }>;
     uploadedBy: import("zod").ZodString;
-    key: import("zod").ZodString;
     filename: import("zod").ZodString;
     contentType: import("zod").ZodString;
     size: import("zod").ZodNumber;

package/dist/assets/events.js

@@ -4,8 +4,8 @@ import { defineEvent } from "../shared/events.js";
 const publicAsset = assetSchema.pick({
 	orgId: true,
 	id: true,
-	key: true,
 	kind: true,
+	source: true,
 	filename: true,
 	contentType: true,
 	size: true,

package/dist/assets/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../src/assets/events.ts"],"sourcesContent":["import { assetSchema } from '../types/schemas/index.js';\nimport { defineEvent, type EventOf, type EventOfValues } from '../shared/ports.js';\n\nconst publicAsset = assetSchema\n  .pick({\n    orgId: true,\n    id: true,\n    key: true,\n    kind: true,\n    filename: true,\n    contentType: true,\n    size: true,\n    status: true,\n    uploadedBy: true,\n    createdAt: true,\n    updatedAt: true,\n  })\n  .strip();\n\nexport const assetEvents = {\n  assetCreated: defineEvent({\n    type: 'asset.created',\n    version: 1,\n    data: assetSchema,\n    publicData: publicAsset,\n  }),\n  assetReady: defineEvent({\n    type: 'asset.ready',\n    version: 1,\n    data: assetSchema,\n    publicData: publicAsset,\n  }),\n  assetDeleted: defineEvent({\n    type: 'asset.deleted',\n    version: 1,\n    data: assetSchema,\n    publicData: publicAsset,\n  }),\n};\n\nexport type AssetCreated = EventOf<typeof assetEvents.assetCreated>;\nexport type AssetReady = EventOf<typeof assetEvents.assetReady>;\nexport type AssetDeleted = EventOf<typeof assetEvents.assetDeleted>;\nexport type AssetEvent = EventOfValues<typeof assetEvents>;\n"],"mappings":";;;AAGA,MAAM,cAAc,YACjB,KAAK;CACJ,OAAO;CACP,IAAI;CACJ,KAAK;CACL,MAAM;CACN,UAAU;CACV,aAAa;CACb,MAAM;CACN,QAAQ;CACR,YAAY;CACZ,WAAW;CACX,WAAW;AACb,CAAC,CAAC,CACD,MAAM;AAET,MAAa,cAAc;CACzB,cAAc,YAAY;EACxB,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,YAAY,YAAY;EACtB,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,cAAc,YAAY;EACxB,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;AACH"}
+{"version":3,"file":"events.js","names":[],"sources":["../../src/assets/events.ts"],"sourcesContent":["import { assetSchema } from '../types/schemas/index.js';\nimport { defineEvent, type EventOf, type EventOfValues } from '../shared/ports.js';\n\nconst publicAsset = assetSchema\n  .pick({\n    orgId: true,\n    id: true,\n    kind: true,\n    source: true,\n    filename: true,\n    contentType: true,\n    size: true,\n    status: true,\n    uploadedBy: true,\n    createdAt: true,\n    updatedAt: true,\n  })\n  .strip();\n\nexport const assetEvents = {\n  assetCreated: defineEvent({\n    type: 'asset.created',\n    version: 1,\n    data: assetSchema,\n    publicData: publicAsset,\n  }),\n  assetReady: defineEvent({\n    type: 'asset.ready',\n    version: 1,\n    data: assetSchema,\n    publicData: publicAsset,\n  }),\n  assetDeleted: defineEvent({\n    type: 'asset.deleted',\n    version: 1,\n    data: assetSchema,\n    publicData: publicAsset,\n  }),\n};\n\nexport type AssetCreated = EventOf<typeof assetEvents.assetCreated>;\nexport type AssetReady = EventOf<typeof assetEvents.assetReady>;\nexport type AssetDeleted = EventOf<typeof assetEvents.assetDeleted>;\nexport type AssetEvent = EventOfValues<typeof assetEvents>;\n"],"mappings":";;;AAGA,MAAM,cAAc,YACjB,KAAK;CACJ,OAAO;CACP,IAAI;CACJ,MAAM;CACN,QAAQ;CACR,UAAU;CACV,aAAa;CACb,MAAM;CACN,QAAQ;CACR,YAAY;CACZ,WAAW;CACX,WAAW;AACb,CAAC,CAAC,CACD,MAAM;AAET,MAAa,cAAc;CACzB,cAAc,YAAY;EACxB,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,YAAY,YAAY;EACtB,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,cAAc,YAAY;EACxB,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;AACH"}

package/dist/assets/file-urls.d.ts

@@ -0,0 +1,20 @@
+//#region src/assets/file-urls.d.ts
+type ThumbnailOwner = 'course' | 'download' | 'community';
+/** Stable, access-checked URLs on the API for every file a response refers to.
+ *  Each one is answered by a route that checks access, then redirects to a
+ *  signed storage URL; none of them expires. */
+interface FileUrls {
+  thumbnail(owner: ThumbnailOwner, ownerId: string): string;
+  activityAsset(activityId: string, assetId: string): string;
+  downloadFile(downloadId: string, assetId: string): string;
+  postCover(postId: string): string;
+  messageAttachment(chatId: string, messageId: string, assetId: string): string;
+  personImage(orgUserId: string): string;
+  memberUpload(assetId: string): string;
+  libraryFile(assetId: string): string;
+  libraryDownload(assetId: string): string;
+}
+declare function createFileUrls(apiUrl: string): FileUrls;
+//#endregion
+export { FileUrls, ThumbnailOwner, createFileUrls };
+//# sourceMappingURL=file-urls.d.ts.map

package/dist/assets/file-urls.js

@@ -0,0 +1,25 @@
+//#region src/assets/file-urls.ts
+const THUMBNAIL_PATHS = {
+	course: "courses",
+	download: "downloads",
+	community: "communities"
+};
+function createFileUrls(apiUrl) {
+	const base = apiUrl.replace(/\/+$/, "");
+	const at = (...segments) => `${base}/api/${segments.map((s) => encodeURIComponent(s)).join("/")}`;
+	return {
+		thumbnail: (owner, ownerId) => at("member", THUMBNAIL_PATHS[owner], ownerId, "thumbnail"),
+		activityAsset: (activityId, assetId) => at("member", "activities", activityId, "assets", assetId),
+		downloadFile: (downloadId, assetId) => at("member", "downloads", downloadId, "assets", assetId),
+		postCover: (postId) => at("member", "posts", postId, "cover"),
+		messageAttachment: (chatId, messageId, assetId) => at("member", "chats", chatId, "messages", messageId, "attachments", assetId),
+		personImage: (orgUserId) => at("member", "people", orgUserId, "image"),
+		memberUpload: (assetId) => at("member", "uploads", assetId, "file"),
+		libraryFile: (assetId) => at("assets", assetId, "file"),
+		libraryDownload: (assetId) => at("assets", assetId, "download")
+	};
+}
+//#endregion
+export { createFileUrls };
+
+//# sourceMappingURL=file-urls.js.map

package/dist/assets/file-urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-urls.js","names":[],"sources":["../../src/assets/file-urls.ts"],"sourcesContent":["export type ThumbnailOwner = 'course' | 'download' | 'community';\n\n/** Stable, access-checked URLs on the API for every file a response refers to.\n *  Each one is answered by a route that checks access, then redirects to a\n *  signed storage URL; none of them expires. */\nexport interface FileUrls {\n  thumbnail(owner: ThumbnailOwner, ownerId: string): string;\n  activityAsset(activityId: string, assetId: string): string;\n  downloadFile(downloadId: string, assetId: string): string;\n  postCover(postId: string): string;\n  messageAttachment(chatId: string, messageId: string, assetId: string): string;\n  personImage(orgUserId: string): string;\n  memberUpload(assetId: string): string;\n  libraryFile(assetId: string): string;\n  libraryDownload(assetId: string): string;\n}\n\nconst THUMBNAIL_PATHS: Record<ThumbnailOwner, string> = {\n  course: 'courses',\n  download: 'downloads',\n  community: 'communities',\n};\n\nexport function createFileUrls(apiUrl: string): FileUrls {\n  const base = apiUrl.replace(/\\/+$/, '');\n  const at = (...segments: string[]) =>\n    `${base}/api/${segments.map((s) => encodeURIComponent(s)).join('/')}`;\n  return {\n    thumbnail: (owner, ownerId) => at('member', THUMBNAIL_PATHS[owner], ownerId, 'thumbnail'),\n    activityAsset: (activityId, assetId) =>\n      at('member', 'activities', activityId, 'assets', assetId),\n    downloadFile: (downloadId, assetId) => at('member', 'downloads', downloadId, 'assets', assetId),\n    postCover: (postId) => at('member', 'posts', postId, 'cover'),\n    messageAttachment: (chatId, messageId, assetId) =>\n      at('member', 'chats', chatId, 'messages', messageId, 'attachments', assetId),\n    personImage: (orgUserId) => at('member', 'people', orgUserId, 'image'),\n    memberUpload: (assetId) => at('member', 'uploads', assetId, 'file'),\n    libraryFile: (assetId) => at('assets', assetId, 'file'),\n    libraryDownload: (assetId) => at('assets', assetId, 'download'),\n  };\n}\n"],"mappings":";AAiBA,MAAM,kBAAkD;CACtD,QAAQ;CACR,UAAU;CACV,WAAW;AACb;AAEA,SAAgB,eAAe,QAA0B;CACvD,MAAM,OAAO,OAAO,QAAQ,QAAQ,EAAE;CACtC,MAAM,MAAM,GAAG,aACb,GAAG,KAAK,OAAO,SAAS,KAAK,MAAM,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG;CACpE,OAAO;EACL,YAAY,OAAO,YAAY,GAAG,UAAU,gBAAgB,QAAQ,SAAS,WAAW;EACxF,gBAAgB,YAAY,YAC1B,GAAG,UAAU,cAAc,YAAY,UAAU,OAAO;EAC1D,eAAe,YAAY,YAAY,GAAG,UAAU,aAAa,YAAY,UAAU,OAAO;EAC9F,YAAY,WAAW,GAAG,UAAU,SAAS,QAAQ,OAAO;EAC5D,oBAAoB,QAAQ,WAAW,YACrC,GAAG,UAAU,SAAS,QAAQ,YAAY,WAAW,eAAe,OAAO;EAC7E,cAAc,cAAc,GAAG,UAAU,UAAU,WAAW,OAAO;EACrE,eAAe,YAAY,GAAG,UAAU,WAAW,SAAS,MAAM;EAClE,cAAc,YAAY,GAAG,UAAU,SAAS,MAAM;EACtD,kBAAkB,YAAY,GAAG,UAAU,SAAS,UAAU;CAChE;AACF"}

package/dist/assets/index.d.ts

@@ -1,7 +1,9 @@
 import { Page } from "../types/shared.js";
-import { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import { Asset, AssetKind, AssetSource, AssetStatus, AssetUrls, AssetView, AssetsQuery, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
 import { AssetCreated, AssetDeleted, AssetEvent, AssetReady, assetEvents } from "./events.js";
+import { FileUrls, ThumbnailOwner, createFileUrls } from "./file-urls.js";
 import "./model.js";
-import { AssetsRepository, AssetsService } from "./ports.js";
-import { AssetsServiceImpl } from "./service.js";
-export { type Asset, type AssetCreated, type AssetDeleted, type AssetEvent, type AssetKind, type AssetReady, type AssetStatus, type AssetsQuery, type AssetsRepository, type AssetsService, AssetsServiceImpl, type DownloadTicket, type Page, type RequestUploadInput, type UploadTicket, assetEvents };
+import { AssetFiles, AssetsRepository, AssetsService, LibraryAssetReader, MemberImageReader, MemberUploadInput, OrgDirectory, ReadyFile } from "./ports.js";
+import { AssetsServiceImpl, MEMBER_IMAGE_TYPE, isMemberImageType, kindOf } from "./service.js";
+import { UPLOADS_REMOVE_UNATTACHED_JOB, assetsJobs, assetsRecurringJobs } from "./jobs.js";
+export { type Asset, type AssetCreated, type AssetDeleted, type AssetEvent, type AssetFiles, type AssetKind, type AssetReady, type AssetSource, type AssetStatus, type AssetUrls, type AssetView, type AssetsQuery, type AssetsRepository, type AssetsService, AssetsServiceImpl, type FileUrls, type LibraryAssetReader, MEMBER_IMAGE_TYPE, type MemberImageReader, type MemberUploadInput, type OrgDirectory, type Page, type ReadyFile, type RequestUploadInput, type ThumbnailOwner, UPLOADS_REMOVE_UNATTACHED_JOB, type UploadTicket, assetEvents, assetsJobs, assetsRecurringJobs, createFileUrls, isMemberImageType, kindOf };

package/dist/assets/index.js

@@ -1,3 +1,5 @@
 import { assetEvents } from "./events.js";
-import { AssetsServiceImpl } from "./service.js";
-export { AssetsServiceImpl, assetEvents };
+import { createFileUrls } from "./file-urls.js";
+import { AssetsServiceImpl, MEMBER_IMAGE_TYPE, isMemberImageType, kindOf } from "./service.js";
+import { UPLOADS_REMOVE_UNATTACHED_JOB, assetsJobs, assetsRecurringJobs } from "./jobs.js";
+export { AssetsServiceImpl, MEMBER_IMAGE_TYPE, UPLOADS_REMOVE_UNATTACHED_JOB, assetEvents, assetsJobs, assetsRecurringJobs, createFileUrls, isMemberImageType, kindOf };

package/dist/assets/jobs.d.ts

@@ -0,0 +1,15 @@
+import { Logger } from "../types/ports.js";
+import { RecurringJob, ScheduledJob } from "../shared/ports.js";
+import { AssetsService, OrgDirectory } from "./ports.js";
+//#region src/assets/jobs.d.ts
+declare const UPLOADS_REMOVE_UNATTACHED_JOB = "assets.uploads.removeUnattached";
+interface AssetsJobDeps {
+  assets: Pick<AssetsService, 'removeUnattached'>;
+  orgs: OrgDirectory;
+  logger?: Logger;
+}
+declare function assetsJobs(deps: AssetsJobDeps): ScheduledJob[];
+declare const assetsRecurringJobs: RecurringJob[];
+//#endregion
+export { AssetsJobDeps, UPLOADS_REMOVE_UNATTACHED_JOB, assetsJobs, assetsRecurringJobs };
+//# sourceMappingURL=jobs.d.ts.map

package/dist/assets/jobs.js

@@ -0,0 +1,30 @@
+import { noopLogger } from "../shared/logger.js";
+//#region src/assets/jobs.ts
+const UPLOADS_REMOVE_UNATTACHED_JOB = "assets.uploads.removeUnattached";
+function assetsJobs(deps) {
+	const logger = deps.logger ?? noopLogger;
+	return [{
+		job: UPLOADS_REMOVE_UNATTACHED_JOB,
+		async run(_payload, fire) {
+			let failed = 0;
+			for (const orgId of await deps.orgs.orgIds()) try {
+				await deps.assets.removeUnattached(orgId, fire.startedAt);
+			} catch (err) {
+				failed += 1;
+				logger.error("unattached uploads not swept", {
+					orgId,
+					err
+				});
+			}
+			if (failed > 0) throw new Error(`unattached uploads of ${failed} orgs could not be swept`);
+		}
+	}];
+}
+const assetsRecurringJobs = [{
+	job: UPLOADS_REMOVE_UNATTACHED_JOB,
+	cron: "0 * * * *"
+}];
+//#endregion
+export { UPLOADS_REMOVE_UNATTACHED_JOB, assetsJobs, assetsRecurringJobs };
+
+//# sourceMappingURL=jobs.js.map

package/dist/assets/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","names":[],"sources":["../../src/assets/jobs.ts"],"sourcesContent":["import type { Logger, RecurringJob, ScheduledJob } from '../shared/ports.js';\nimport { noopLogger } from '../shared/logger.js';\nimport type { AssetsService, OrgDirectory } from './ports.js';\n\nexport const UPLOADS_REMOVE_UNATTACHED_JOB = 'assets.uploads.removeUnattached';\n\nexport interface AssetsJobDeps {\n  assets: Pick<AssetsService, 'removeUnattached'>;\n  orgs: OrgDirectory;\n  logger?: Logger;\n}\n\nexport function assetsJobs(deps: AssetsJobDeps): ScheduledJob[] {\n  const logger = deps.logger ?? noopLogger;\n  return [\n    {\n      job: UPLOADS_REMOVE_UNATTACHED_JOB,\n      async run(_payload, fire) {\n        let failed = 0;\n        for (const orgId of await deps.orgs.orgIds()) {\n          try {\n            await deps.assets.removeUnattached(orgId, fire.startedAt);\n          } catch (err) {\n            failed += 1;\n            logger.error('unattached uploads not swept', { orgId, err });\n          }\n        }\n        if (failed > 0) {\n          throw new Error(`unattached uploads of ${failed} orgs could not be swept`);\n        }\n      },\n    },\n  ];\n}\n\nexport const assetsRecurringJobs: RecurringJob[] = [\n  { job: UPLOADS_REMOVE_UNATTACHED_JOB, cron: '0 * * * *' },\n];\n"],"mappings":";;AAIA,MAAa,gCAAgC;AAQ7C,SAAgB,WAAW,MAAqC;CAC9D,MAAM,SAAS,KAAK,UAAU;CAC9B,OAAO,CACL;EACE,KAAK;EACL,MAAM,IAAI,UAAU,MAAM;GACxB,IAAI,SAAS;GACb,KAAK,MAAM,SAAS,MAAM,KAAK,KAAK,OAAO,GACzC,IAAI;IACF,MAAM,KAAK,OAAO,iBAAiB,OAAO,KAAK,SAAS;GAC1D,SAAS,KAAK;IACZ,UAAU;IACV,OAAO,MAAM,gCAAgC;KAAE;KAAO;IAAI,CAAC;GAC7D;GAEF,IAAI,SAAS,GACX,MAAM,IAAI,MAAM,yBAAyB,OAAO,yBAAyB;EAE7E;CACF,CACF;AACF;AAEA,MAAa,sBAAsC,CACjD;CAAE,KAAK;CAA+B,MAAM;AAAY,CAC1D"}

package/dist/assets/model.d.ts

@@ -1,4 +1,4 @@
 import { Page } from "../types/shared.js";
-import { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import { Asset, AssetKind, AssetSource, AssetStatus, AssetUrls, AssetView, AssetsQuery, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
 import "../types/index.js";
-export type { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, Page, RequestUploadInput, UploadTicket };
+export type { Asset, AssetKind, AssetSource, AssetStatus, AssetUrls, AssetView, AssetsQuery, Page, RequestUploadInput, UploadTicket };

package/dist/assets/ports.d.ts

@@ -1,28 +1,59 @@
 import { Page } from "../types/shared.js";
-import { Asset, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import { Asset, AssetView, AssetsQuery, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
 import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
 import "./model.js";
 //#region src/assets/ports.d.ts
-interface AssetsService {
-  /** Register an asset and return a presigned URL to upload its bytes. */
+interface MemberImageReader {
+  ownsImage(orgId: string, assetId: string, orgUserId: string): Promise<boolean>;
+}
+interface LibraryAssetReader {
+  libraryAssetsAmong(orgId: string, assetIds: string[]): Promise<string[]>;
+}
+interface ReadyFile {
+  filename: string;
+  contentType: string;
+  size: number;
+}
+interface AssetFiles {
+  /** Ready files of the org among these ids, with what a download shows of them. */
+  readyFiles(orgId: string, assetIds: readonly string[]): Promise<Record<string, ReadyFile>>;
+  /** A signed storage URL for a ready file of the org, after the caller has checked
+   *  access. `saveAs` makes it a short-lived download under that name. */
+  signFile(orgId: string, assetId: string, opts?: {
+    saveAs?: string;
+  }): Promise<string | null>;
+}
+interface MemberUploadInput {
+  filename: string;
+  contentType: string;
+}
+interface AssetsService extends MemberImageReader, LibraryAssetReader, AssetFiles {
   requestUpload(orgId: string, input: RequestUploadInput): Promise<UploadTicket>;
-  /** After upload, capture size/content-type from storage and mark ready. */
-  confirm(orgId: string, id: string): Promise<Asset | null>;
-  list(orgId: string, query: AssetsQuery): Promise<Page<Asset>>;
-  get(orgId: string, id: string): Promise<Asset | null>;
-  /** Short-lived presigned URL to download/serve the asset. `expiresInSeconds`
-   *  overrides the adapter default — entitled delivery passes its own. */
-  requestDownload(orgId: string, id: string, filename?: string, expiresInSeconds?: number): Promise<DownloadTicket | null>;
-  /** Remove the object from storage and the registry. */
+  requestMemberUpload(orgId: string, orgUserId: string, input: MemberUploadInput): Promise<UploadTicket>;
+  confirm(orgId: string, id: string): Promise<AssetView | null>;
+  confirmOwn(orgId: string, id: string, orgUserId: string): Promise<AssetView | null>;
+  list(orgId: string, query: AssetsQuery): Promise<Page<AssetView>>;
+  get(orgId: string, id: string): Promise<AssetView | null>;
+  libraryFile(orgId: string, assetId: string, opts: {
+    download: boolean;
+  }): Promise<string | null>;
+  ownUploadFile(orgId: string, assetId: string, orgUserId: string): Promise<string | null>;
   remove(orgId: string, id: string): Promise<boolean>;
+  removeOwn(orgId: string, id: string, orgUserId: string): Promise<boolean>;
+  removeUnattached(orgId: string, now: Date): Promise<number>;
+}
+interface OrgDirectory {
+  orgIds(): Promise<string[]>;
 }
 interface AssetsRepository {
   insert(orgId: string, asset: Asset): Promise<Asset>;
   list(orgId: string, query: AssetsQuery): Promise<Page<Asset>>;
-  /** Scoped to the org — returns null if the asset belongs to another org. */
   findById(orgId: string, id: string): Promise<Asset | null>;
-  update(id: string, patch: Partial<Pick<Asset, 'size' | 'contentType' | 'status'>>): Promise<Asset | null>;
-  delete(id: string): Promise<boolean>;
+  findByIds(orgId: string, ids: string[]): Promise<Asset[]>;
+  markReady(orgId: string, id: string, patch: Pick<Asset, 'key' | 'kind' | 'size' | 'contentType'>): Promise<Asset | null>;
+  delete(orgId: string, id: string): Promise<boolean>;
+  listUnreferencedMemberUploads(orgId: string, before: Date): Promise<Asset[]>;
+  heldKeys(orgId: string, keys: string[]): Promise<string[]>;
 }
 interface AssetsWriteScope {
   assets: AssetsRepository;
@@ -30,5 +61,5 @@ interface AssetsWriteScope {
 }
 type AssetsUnitOfWork = UnitOfWork<AssetsWriteScope>;
 //#endregion
-export { AssetsRepository, AssetsService, AssetsUnitOfWork, AssetsWriteScope };
+export { AssetFiles, AssetsRepository, AssetsService, AssetsUnitOfWork, AssetsWriteScope, LibraryAssetReader, MemberImageReader, MemberUploadInput, OrgDirectory, ReadyFile };
 //# sourceMappingURL=ports.d.ts.map

package/dist/assets/service.d.ts

@@ -1,29 +1,60 @@
 import { Page } from "../types/shared.js";
 import { Logger, ObjectStorage } from "../types/ports.js";
-import { Asset, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import { AssetKind, AssetView, AssetsQuery, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
 import "../shared/ports.js";
+import { FileUrls } from "./file-urls.js";
 import "./model.js";
-import { AssetsRepository, AssetsService, AssetsUnitOfWork } from "./ports.js";
+import { AssetsRepository, AssetsService, AssetsUnitOfWork, MemberUploadInput, ReadyFile } from "./ports.js";
 //#region src/assets/service.d.ts
+declare const MEMBER_IMAGE_TYPE: RegExp;
+declare function isMemberImageType(contentType: string): boolean;
+declare function kindOf(contentType: string): AssetKind;
 type AssetsServiceParams = {
   storage: ObjectStorage;
   repo: AssetsRepository;
   uow: AssetsUnitOfWork;
+  memberImageMaxBytes: number;
+  downloadLinkExpirySeconds: number;
+  fileUrls: FileUrls;
   logger?: Logger;
 };
 declare class AssetsServiceImpl implements AssetsService {
   private readonly storage;
   private readonly repo;
   private readonly uow;
+  private readonly memberImageMaxBytes;
+  private readonly downloadLinkExpirySeconds;
+  private readonly fileUrls;
   private readonly logger;
   constructor(params: AssetsServiceParams);
   requestUpload(orgId: string, input: RequestUploadInput): Promise<UploadTicket>;
-  confirm(orgId: string, id: string): Promise<Asset | null>;
-  list(orgId: string, query: AssetsQuery): Promise<Page<Asset>>;
-  get(orgId: string, id: string): Promise<Asset | null>;
-  requestDownload(orgId: string, id: string, filename?: string, expiresInSeconds?: number): Promise<DownloadTicket | null>;
+  requestMemberUpload(orgId: string, orgUserId: string, input: MemberUploadInput): Promise<UploadTicket>;
+  confirm(orgId: string, id: string): Promise<AssetView | null>;
+  confirmOwn(orgId: string, id: string, orgUserId: string): Promise<AssetView | null>;
+  ownUploadFile(orgId: string, assetId: string, orgUserId: string): Promise<string | null>;
+  ownsImage(orgId: string, assetId: string, orgUserId: string): Promise<boolean>;
+  libraryAssetsAmong(orgId: string, assetIds: string[]): Promise<string[]>;
+  list(orgId: string, query: AssetsQuery): Promise<Page<AssetView>>;
+  get(orgId: string, id: string): Promise<AssetView | null>;
+  readyFiles(orgId: string, assetIds: readonly string[]): Promise<Record<string, ReadyFile>>;
+  signFile(orgId: string, assetId: string, opts?: {
+    saveAs?: string;
+  }): Promise<string | null>;
+  libraryFile(orgId: string, assetId: string, opts: {
+    download: boolean;
+  }): Promise<string | null>;
   remove(orgId: string, id: string): Promise<boolean>;
+  removeOwn(orgId: string, id: string, orgUserId: string): Promise<boolean>;
+  removeUnattached(orgId: string, now: Date): Promise<number>;
+  private strayUploads;
+  private finalize;
+  private finalizeMember;
+  private markReady;
+  private readyAmong;
+  private view;
+  private discard;
+  private removeObject;
 }
 //#endregion
-export { AssetsServiceImpl, AssetsServiceParams };
+export { AssetsServiceImpl, AssetsServiceParams, MEMBER_IMAGE_TYPE, isMemberImageType, kindOf };
 //# sourceMappingURL=service.d.ts.map