@better-media/adapter-jobs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 abenezeratnafu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @better-media/adapter-jobs
+
+Job adapters for background execution in the Better Media framework.
+
+## Overview
+
+Some media pipeline steps (e.g. video transcoding, large virus scans) should not block the main request thread. This package provides:
+
+- **In-Memory Job Adapter**: Simple FIFO queue for development or small-scale apps.
+- **Hook Integration**: Automatically enqueues tasks tagged with `execution: 'background'`.
+
+## Usage
+
+```ts
+import { InMemoryJobAdapter } from "@better-media/adapter-jobs";
+
+const jobs = new InMemoryJobAdapter({ concurrency: 2 });
+```
+
+Visit [better-media.dev/docs/adapters/jobs](https://better-media.dev/docs/adapters/jobs) for more.

package/dist/index.d.mts

@@ -0,0 +1,14 @@
+import { JobAdapter } from '@better-media/core';
+
+interface MemoryJobAdapterOptions {
+    /** When provided, jobs are run in-process via setImmediate (default for background plugins) */
+    processor?: (payload: Record<string, unknown>) => Promise<void>;
+}
+/**
+ * Default in-memory job adapter for development/testing.
+ * When processor is provided, jobs run in-process via setImmediate.
+ * When not provided, jobs are stored only (for manual worker polling).
+ */
+declare function memoryJobAdapter(options?: MemoryJobAdapterOptions): JobAdapter;
+
+export { type MemoryJobAdapterOptions, memoryJobAdapter };

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { JobAdapter } from '@better-media/core';
+
+interface MemoryJobAdapterOptions {
+    /** When provided, jobs are run in-process via setImmediate (default for background plugins) */
+    processor?: (payload: Record<string, unknown>) => Promise<void>;
+}
+/**
+ * Default in-memory job adapter for development/testing.
+ * When processor is provided, jobs run in-process via setImmediate.
+ * When not provided, jobs are stored only (for manual worker polling).
+ */
+declare function memoryJobAdapter(options?: MemoryJobAdapterOptions): JobAdapter;
+
+export { type MemoryJobAdapterOptions, memoryJobAdapter };

package/dist/index.js

@@ -0,0 +1,19 @@
+'use strict';
+
+// src/index.ts
+function memoryJobAdapter(options) {
+  const processor = options?.processor;
+  return {
+    async enqueue(name, payload) {
+      if (processor) {
+        setImmediate(() => {
+          void processor(payload);
+        });
+      }
+    }
+  };
+}
+
+exports.memoryJobAdapter = memoryJobAdapter;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAYO,SAAS,iBAAiB,OAAA,EAA+C;AAC9E,EAAA,MAAM,YAAY,OAAA,EAAS,SAAA;AAC3B,EAAA,OAAO;AAAA,IACL,MAAM,OAAA,CAAQ,IAAA,EAAc,OAAA,EAAkC;AAC5D,MAAA,IAAI,SAAA,EAAW;AACb,QAAA,YAAA,CAAa,MAAM;AACjB,UAAA,KAAK,UAAU,OAAO,CAAA;AAAA,QACxB,CAAC,CAAA;AAAA,MACH;AACK,IACP;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type { JobAdapter } from \"@better-media/core\";\n\nexport interface MemoryJobAdapterOptions {\n  /** When provided, jobs are run in-process via setImmediate (default for background plugins) */\n  processor?: (payload: Record<string, unknown>) => Promise<void>;\n}\n\n/**\n * Default in-memory job adapter for development/testing.\n * When processor is provided, jobs run in-process via setImmediate.\n * When not provided, jobs are stored only (for manual worker polling).\n */\nexport function memoryJobAdapter(options?: MemoryJobAdapterOptions): JobAdapter {\n  const processor = options?.processor;\n  return {\n    async enqueue(name: string, payload: Record<string, unknown>) {\n      if (processor) {\n        setImmediate(() => {\n          void processor(payload);\n        });\n      }\n      void name;\n    },\n  };\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,17 @@
+// src/index.ts
+function memoryJobAdapter(options) {
+  const processor = options?.processor;
+  return {
+    async enqueue(name, payload) {
+      if (processor) {
+        setImmediate(() => {
+          void processor(payload);
+        });
+      }
+    }
+  };
+}
+
+export { memoryJobAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAYO,SAAS,iBAAiB,OAAA,EAA+C;AAC9E,EAAA,MAAM,YAAY,OAAA,EAAS,SAAA;AAC3B,EAAA,OAAO;AAAA,IACL,MAAM,OAAA,CAAQ,IAAA,EAAc,OAAA,EAAkC;AAC5D,MAAA,IAAI,SAAA,EAAW;AACb,QAAA,YAAA,CAAa,MAAM;AACjB,UAAA,KAAK,UAAU,OAAO,CAAA;AAAA,QACxB,CAAC,CAAA;AAAA,MACH;AACK,IACP;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["import type { JobAdapter } from \"@better-media/core\";\n\nexport interface MemoryJobAdapterOptions {\n  /** When provided, jobs are run in-process via setImmediate (default for background plugins) */\n  processor?: (payload: Record<string, unknown>) => Promise<void>;\n}\n\n/**\n * Default in-memory job adapter for development/testing.\n * When processor is provided, jobs run in-process via setImmediate.\n * When not provided, jobs are stored only (for manual worker polling).\n */\nexport function memoryJobAdapter(options?: MemoryJobAdapterOptions): JobAdapter {\n  const processor = options?.processor;\n  return {\n    async enqueue(name: string, payload: Record<string, unknown>) {\n      if (processor) {\n        setImmediate(() => {\n          void processor(payload);\n        });\n      }\n      void name;\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@better-media/adapter-jobs",
+  "version": "0.1.0",
+  "description": "Job adapter implementations for Better Media (in-memory, Redis, etc.)",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@better-media/core": "0.1.0"
+  },
+  "keywords": [],
+  "author": "Abenezer Atnafu",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AbenezerAtnafu/better-media.git"
+  },
+  "homepage": "https://better-media.dev",
+  "bugs": {
+    "url": "https://github.com/AbenezerAtnafu/better-media/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "jest"
+  }
+}