@ossy/media-tasks 1.40.2 → 3.0.1

package/README.md

@@ -2,14 +2,25 @@
 
 Changestream-triggered media processing tasks for the Ossy platform.
 
-Tasks in this package are registered with `TaskService.RegisterTask()` at API startup and fire automatically when matching events are detected in the event store change stream.
+Tasks in this package are registered with `TaskService.RegisterTask()` at API startup and fire automatically when matching ADR 0008 resource events appear on the event store change stream.
 
 ## Tasks
 
-| Task | Trigger | Description |
-|------|---------|-------------|
-| `resize-common-web` | `Resource` `Created` (`image/*`) | Generates common web thumbnail and gallery sizes using `sharp` |
-| `visual-content-descriptors` | `Resource` `Created` (`image/*`, `video/*`) | Uses GPT-4o to generate title, description, tags, and alt text |
+| Task id | Trigger | Description |
+|---------|---------|-------------|
+| `@ossy/media-tasks/tasks/resize-common-web` | `@ossy/platform/schema/file` `Created` (`content.ContentType: image/*`) | Generates common web thumbnail and gallery sizes using `sharp` |
+| `@ossy/media-tasks/tasks/visual-content-descriptors` | `@ossy/platform/schema/file` `Created` (`image/*`, `video/*`) | Uses GPT-4o to generate title, description, tags, and alt text |
+
+## Schemas
+
+Task outcome schemas live in `src/*.schema.js` and are auto-discovered at build time:
+
+| Schema | Id |
+|--------|----|
+| Resize Common Web | `@ossy/media-tasks/schema/resize-common-web` |
+| Visual Content Descriptors | `@ossy/media-tasks/schema/visual-content-descriptors` |
+
+These describe optional task-run documents; handlers are implemented in the matching `*.task.js` files.
 
 ## Task contract
 
@@ -17,12 +28,22 @@ Each `*.task.js` file exports:
 
 ```js
 export const metadata = {
-  id: 'my-task',
-  triggers: [{ aggregateType, event, resource?, location? }],
+  id: '@ossy/media-tasks/tasks/my-task',
+  triggers: [{ type, event, match?, location? }],
 }
 
-export default async function ({ event, sdk }) { ... }
+export async function run ({ event, sdk }) { ... }
 ```
 
-- `event` — the raw eventstore `fullDocument` that triggered this handler
+- `metadata.id` — canonical task id (`@ossy/<package>/tasks/…`)
+- `triggers[].type` — resource schema id to watch (e.g. `@ossy/platform/schema/file`)
+- `triggers[].event` — lifecycle event name (`Created`, `Patched`, …)
+- `triggers[].match` — optional field matcher on `event.payload` (e.g. `{ 'content.ContentType': 'image/*' }`)
+- `event` — the raw eventstore `fullDocument` (`resourceId`, `type`, `event`, `payload`, …)
 - `sdk` — platform SDK instance (passed from API startup; `null` during local dev if unconfigured)
+
+## Dependencies
+
+- **`sharp`** (peer) — image resizing in `resize-common-web`
+- **`openai`** (peer) — GPT-4o vision in `visual-content-descriptors`
+- **`@ossy/platform`** — `StorageClient.load` for reading uploaded file bytes (provided at runtime by the platform server)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossy/media-tasks",
-  "version": "1.40.2",
+  "version": "3.0.1",
   "description": "Changestream-triggered media processing tasks (image resize, AI descriptors)",
   "type": "module",
   "main": "./src/index.js",
@@ -15,8 +15,8 @@
     "typecheck": "echo \"No TypeScript in media-tasks package\" && exit 0"
   },
   "dependencies": {
-    "@ossy/observability": "^1.8.2",
-    "@ossy/resources": "^1.12.2"
+    "@ossy/observability": "^3.0.1",
+    "@ossy/resources": "^3.0.1"
   },
   "peerDependencies": {
     "openai": ">=4",
@@ -32,5 +32,5 @@
   ],
   "author": "Ossy <yourfriends@ossy.se> (https://ossy.se)",
   "license": "MIT",
-  "gitHead": "2b8745d57fee8b6c08787e2755b4df489291a5cd"
+  "gitHead": "4a70ec216448680d2fddc57b2a8a0077489720ae"
 }

package/src/{resize-common-web.resource.js → resize-common-web.schema.js}

@@ -1,6 +1,6 @@
 export default {
   name: 'Resize Common Web',
-  id: '@ossy/tasks/resize-common-web',
+  id: '@ossy/media-tasks/schema/resize-common-web',
   categoryName: 'Media processing',
   icon: 'attribution',
   fields: [

package/src/resize-common-web.task.js

@@ -1,4 +1,5 @@
 import { createLogger } from '@ossy/observability'
+import { StorageClient } from '@ossy/platform'
 import { GetResource } from '@ossy/resources'
 
 const log = createLogger('media-tasks')
@@ -13,47 +14,46 @@ const Sizes = [
 ]
 
 export const metadata = {
-  id: 'resize-common-web',
+  id: '@ossy/media-tasks/tasks/resize-common-web',
   triggers: [
     {
-      aggregateType: 'Resource',
+      type: '@ossy/platform/schema/file',
       event: 'Created',
-      resource: { type: 'image/*' },
+      match: { 'content.ContentType': 'image/*' },
     },
   ],
 }
 
 export async function run ({ event, sdk }) {
   const { default: sharp } = await import('sharp')
-  const resourceId = event.aggregateId
+  const resourceId = event.resourceId
 
-  log.info(`[resize-common-web] starting for resource ${resourceId}`)
+  log.info(`[media-tasks/tasks/resize-common-web] starting for resource ${resourceId}`)
 
-  const resource = await sdk.invoke(GetResource, { id: resourceId })
-  const image = await fetch(resource.content.src).then((response) => response.arrayBuffer())
-
-  log.info(`[resize-common-web] Resizing ${resourceId}`)
+  const resource = await sdk.invoke(GetResource, { resourceId })
+  const key = resource?.content?.Key
+  if (!key) {
+    throw new Error(`[media-tasks/tasks/resize-common-web] missing storage key for ${resourceId}`)
+  }
 
-  for (const { width, height, name } of Sizes) {
-    const imageBuffer = await sharp(image).resize(width, height).toBuffer()
+  const { buffer: sourceBuffer, exists } = await StorageClient.load(key)
+  if (!exists || !sourceBuffer) {
+    throw new Error(`[media-tasks/tasks/resize-common-web] missing file bytes for ${resourceId}`)
+  }
 
-    log.info(`[resize-common-web] Created image buffer for ${name}`)
+  log.info(`[media-tasks/tasks/resize-common-web] Resizing ${resourceId}`)
 
-    const file = new File([new Uint8Array(imageBuffer)], name, { type: resource.type })
+  for (const { width, height, name } of Sizes) {
+    const resizedBuffer = await sharp(sourceBuffer).resize(width, height).toBuffer()
+    const mime = resource.content?.ContentType ?? 'image/jpeg'
+    const file = new File([new Uint8Array(resizedBuffer)], name, { type: mime })
 
-    log.info(`[resize-common-web] Uploading ${name} for ${resourceId}`)
+    log.info(`[media-tasks/tasks/resize-common-web] Uploading ${name} for ${resourceId}`)
     try {
-      // TODO: remove named version concept
-      await sdk.resources.uploadNamedVersion({
-        id: resourceId,
-        name: name,
-        file: file,
-      })
+      await sdk.resources.uploadNamedVersion({ id: resourceId, name, file })
     } catch (error) {
-      log.error(`[resize-common-web] Error uploading ${name} for ${resourceId}`, undefined, error)
+      log.error(`[media-tasks/tasks/resize-common-web] Error uploading ${name} for ${resourceId}`, undefined, error)
       throw error
     }
-
-    log.info(`[resize-common-web] Uploaded ${name} for ${resourceId}`)
   }
 }

package/src/{visual-content-descriptors.resource.js → visual-content-descriptors.schema.js}

@@ -1,6 +1,6 @@
 export default {
   name: 'Visual Content Descriptors',
-  id: '@ossy/tasks/visual-content-descriptors',
+  id: '@ossy/media-tasks/schema/visual-content-descriptors',
   categoryName: 'Media processing',
   icon: 'attribution',
   fields: [

package/src/visual-content-descriptors.task.js

@@ -2,25 +2,25 @@ import { GetResource, UpdateResourceName, UpdateResourceContent } from '@ossy/re
 import { OpenAi } from './openai.integration.js'
 
 export const metadata = {
-  id: 'visual-content-descriptors',
+  id: '@ossy/media-tasks/tasks/visual-content-descriptors',
   triggers: [
     {
-      aggregateType: 'Resource',
+      type: '@ossy/platform/schema/file',
       event: 'Created',
-      resource: { type: 'image/*' },
+      match: { 'content.ContentType': 'image/*' },
     },
     {
-      aggregateType: 'Resource',
+      type: '@ossy/platform/schema/file',
       event: 'Created',
-      resource: { type: 'video/*' },
+      match: { 'content.ContentType': 'video/*' },
     },
   ],
 }
 
 export async function run ({ event, sdk }) {
-  const resourceId = event.aggregateId
+  const resourceId = event.resourceId
 
-  const resource = await sdk.invoke(GetResource, { id: resourceId })
+  const resource = await sdk.invoke(GetResource, { resourceId })
   const visualContentDescriptors = await OpenAi.getVisualContentDescriptors(resource.content.src)
 
   await sdk.invoke(UpdateResourceName, { id: resource.id, name: visualContentDescriptors.title })