@better-media/framework 0.1.0 → 0.2.0

package/README.md

@@ -46,4 +46,4 @@ console.log("Uploaded file key:", result.fileKey);
 
 ## Documentation
 
-Full documentation is available at [better-media.dev](https://better-media.dev).
+Full documentation is available at [better-media-platform.vercel.app](https://better-media-platform.vercel.app/).

package/dist/index.js

@@ -1,10 +1,10 @@
 'use strict';
 
-var core = require('@better-media/core');
 var fs2 = require('fs/promises');
 var crypto = require('crypto');
 var adapterJobs = require('@better-media/adapter-jobs');
-var path = require('path');
+var core = require('@better-media/core');
+var path2 = require('path');
 var fs = require('fs');
 var os = require('os');
 var stream = require('stream');
@@ -12,25 +12,10 @@ var stream = require('stream');
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var fs2__default = /*#__PURE__*/_interopDefault(fs2);
-var path__default = /*#__PURE__*/_interopDefault(path);
+var path2__default = /*#__PURE__*/_interopDefault(path2);
 var os__default = /*#__PURE__*/_interopDefault(os);
 
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/core/lifecycle-engine.ts
-var lifecycle_engine_exports = {};
-__export(lifecycle_engine_exports, {
-  LifecycleEngine: () => LifecycleEngine,
-  createSecureContext: () => createSecureContext
-});
+// src/index.ts
 function createSecureContext(context, pluginName, namespace, trustLevel, capabilities) {
   const api = {
     emitMetadata(patch) {
@@ -127,52 +112,48 @@ function createSecureContext(context, pluginName, namespace, trustLevel, capabil
   });
   return { proxy, api };
 }
-var JOB_QUEUE_NAME, LifecycleEngine;
-var init_lifecycle_engine = __esm({
-  "src/core/lifecycle-engine.ts"() {
-    JOB_QUEUE_NAME = "better-media:background";
-    LifecycleEngine = class {
-      constructor(registry, jobAdapter) {
-        this.registry = registry;
-        this.jobAdapter = jobAdapter;
-      }
-      async trigger(hookName, context) {
-        const handlers = this.registry.get(hookName) ?? [];
-        const syncHandlers = handlers.filter((h) => h.mode === "sync");
-        const backgroundHandlers = handlers.filter((h) => h.mode === "background");
-        for (const { name, fn, manifest } of syncHandlers) {
-          const { proxy, api } = createSecureContext(
-            context,
-            name,
-            manifest.namespace,
-            manifest.trustLevel,
-            manifest.capabilities
-          );
-          const result = await fn(proxy, api);
-          if (result !== void 0 && typeof result === "object" && "valid" in result) {
-            if (result.valid === false) return result;
-          }
-        }
-        for (const { name, manifest } of backgroundHandlers) {
-          const payload = {
-            recordId: context.recordId,
-            metadata: JSON.parse(JSON.stringify(context.metadata)),
-            file: JSON.parse(JSON.stringify(context.file)),
-            storageLocation: JSON.parse(JSON.stringify(context.storageLocation)),
-            processing: JSON.parse(JSON.stringify(context.processing)),
-            hookName,
-            pluginName: name,
-            manifest: JSON.parse(JSON.stringify(manifest))
-          };
-          await this.jobAdapter.enqueue(JOB_QUEUE_NAME, payload);
-        }
+
+// src/core/lifecycle-engine.ts
+var JOB_QUEUE_NAME = "better-media:background";
+var LifecycleEngine = class {
+  constructor(registry, jobAdapter) {
+    this.registry = registry;
+    this.jobAdapter = jobAdapter;
+  }
+  async trigger(hookName, context) {
+    const handlers = this.registry.get(hookName) ?? [];
+    const syncHandlers = handlers.filter((h) => h.mode === "sync");
+    const backgroundHandlers = handlers.filter((h) => h.mode === "background");
+    for (const { name, fn, manifest } of syncHandlers) {
+      const { proxy, api } = createSecureContext(
+        context,
+        name,
+        manifest.namespace,
+        manifest.trustLevel,
+        manifest.capabilities
+      );
+      const result = await fn(proxy, api);
+      if (result !== void 0 && typeof result === "object" && "valid" in result) {
+        if (result.valid === false) return result;
       }
-    };
+    }
+    for (const { name, manifest } of backgroundHandlers) {
+      const payload = {
+        recordId: context.recordId,
+        metadata: JSON.parse(JSON.stringify(context.metadata)),
+        file: JSON.parse(JSON.stringify(context.file)),
+        storageLocation: JSON.parse(JSON.stringify(context.storageLocation)),
+        processing: JSON.parse(JSON.stringify(context.processing)),
+        hookName,
+        pluginName: name,
+        manifest: JSON.parse(JSON.stringify(manifest))
+      };
+      await this.jobAdapter.enqueue(JOB_QUEUE_NAME, payload);
+    }
   }
-});
+};
 
 // src/plugins/plugin-registry.ts
-init_lifecycle_engine();
 function createEmptyRegistry() {
   const reg = /* @__PURE__ */ new Map();
   for (const name of core.HOOK_NAMES) {
@@ -336,9 +317,6 @@ function hasBackgroundHandlers(registry) {
   }
   return false;
 }
-
-// src/index.ts
-init_lifecycle_engine();
 async function loadTrustedFromDb(database, recordId) {
   const record = await database.findOne({
     model: "media",
@@ -407,8 +385,8 @@ async function saveTrustedToDb(database, recordId, fileKey, trusted, initialArgs
   }
 }
 async function streamToTempFile(stream$1, fileKey) {
-  const ext = path__default.default.extname(fileKey) || ".bin";
-  const tmpPath = path__default.default.join(os__default.default.tmpdir(), `better-media-${crypto.randomUUID()}${ext}`);
+  const ext = path2__default.default.extname(fileKey) || ".bin";
+  const tmpPath = path2__default.default.join(os__default.default.tmpdir(), `better-media-${crypto.randomUUID()}${ext}`);
   const nodeStream = stream$1 instanceof stream.Readable ? stream$1 : stream.Readable.fromWeb(stream$1);
   const writeStream = fs.createWriteStream(tmpPath);
   await new Promise((resolve, reject) => {
@@ -426,6 +404,10 @@ async function loadFileIntoContext(context, fileHandling) {
   const storageWithExtras = storage;
   if (!context.utilities) context.utilities = {};
   const fileContent = {};
+  if (context.storageLocation.url && context.storageLocation.url === context.file.key) {
+    context.utilities.fileContent = fileContent;
+    return;
+  }
   let useStream = false;
   if (maxBufferBytes != null && typeof storageWithExtras.getSize === "function" && typeof storageWithExtras.getStream === "function") {
     const size = await storageWithExtras.getSize(fileKey);
@@ -466,8 +448,22 @@ async function cleanupTempFile(context) {
 function buildFileInfo(fileKey, metadata) {
   const mime = metadata.contentType ?? metadata.mimeType ?? metadata["content-type"];
   const size = typeof metadata.size === "number" ? metadata.size : void 0;
-  const originalName = metadata.originalName ?? metadata.originalname;
-  const ext = originalName ? path__default.default.extname(originalName).toLowerCase() : path__default.default.extname(fileKey).toLowerCase();
+  const originalName = metadata.originalName ?? metadata.originalname ?? (() => {
+    try {
+      const url = new URL(fileKey);
+      return path2__default.default.basename(url.pathname);
+    } catch {
+      return void 0;
+    }
+  })();
+  const ext = originalName ? path2__default.default.extname(originalName).toLowerCase() : (() => {
+    try {
+      const url = new URL(fileKey);
+      return path2__default.default.extname(url.pathname).toLowerCase();
+    } catch {
+      return path2__default.default.extname(fileKey).toLowerCase();
+    }
+  })();
   return {
     key: fileKey,
     size,
@@ -477,12 +473,12 @@ function buildFileInfo(fileKey, metadata) {
     checksums: void 0
   };
 }
-function buildStorageLocation(fileKey) {
+function buildStorageLocation(fileKey, referenceUrl) {
   return {
     key: fileKey,
     bucket: void 0,
     region: void 0,
-    url: void 0
+    url: referenceUrl
   };
 }
 function syncTrustedToFile(context) {
@@ -515,7 +511,7 @@ var PipelineExecutor = class {
     const context = {
       recordId,
       file: buildFileInfo(fileKey, meta),
-      storageLocation: buildStorageLocation(fileKey),
+      storageLocation: buildStorageLocation(fileKey, appContext.referenceUrl),
       processing: {},
       metadata: { ...meta, ...appContext },
       // Merge for plugins to read backwards-compatibly
@@ -580,7 +576,7 @@ async function runBackgroundJob(payload, registry, storage, database, jobs, file
     size: typeof meta.size === "number" ? meta.size : void 0,
     mimeType: typeof (meta.contentType ?? meta.mimeType ?? meta["content-type"]) === "string" ? meta.contentType ?? meta.mimeType ?? meta["content-type"] : void 0,
     originalName: typeof (meta.originalName ?? meta.originalname) === "string" ? meta.originalName ?? meta.originalname : void 0,
-    extension: path__default.default.extname(legacyKey).toLowerCase() || void 0
+    extension: path2__default.default.extname(legacyKey).toLowerCase() || void 0
   } : { key: "" });
   const recordId = payloadRecordId ?? file.key ?? "unknown";
   const storageLocation = payloadStorage ?? { key: file.key };
@@ -609,8 +605,7 @@ async function runBackgroundJob(payload, registry, storage, database, jobs, file
       throw new Error(`Handler not found: ${hookName}/${pluginName}`);
     }
     const manifest = handler.manifest;
-    const { createSecureContext: createSecureContext2 } = await Promise.resolve().then(() => (init_lifecycle_engine(), lifecycle_engine_exports));
-    const { proxy, api } = createSecureContext2(
+    const { proxy, api } = createSecureContext(
       context,
       pluginName,
       manifest.namespace,
@@ -912,7 +907,7 @@ async function normalizeInput(input, fileHandling) {
     data = Buffer.concat(chunks);
   } else if ("url" in file && file.url) {
     if (file.mode === "reference") {
-      throw new Error("URL reference mode is not fully implemented yet.");
+      return { metadata, shouldDeleteSource: false, isReference: true, referenceUrl: file.url };
     }
     const response = await fetch(file.url);
     if (!response.ok) throw new Error(`Failed to fetch URL: ${response.statusText}`);
@@ -948,15 +943,19 @@ function createBetterMedia(config) {
       async ingest(input) {
         const normalized = await normalizeInput(input, fileHandling);
         const recordId = crypto.randomUUID();
-        const finalKey = input.key ?? normalized.metadata.filename ?? recordId;
+        const finalKey = input.key ?? normalized.metadata.filename ?? (normalized.isReference ? normalized.referenceUrl : void 0) ?? recordId;
         try {
-          await storage.put(finalKey, normalized.data);
-          await runPipeline(
-            recordId,
-            finalKey,
-            normalized.metadata,
-            normalized.metadata.context ?? {}
-          );
+          if (normalized.isReference && normalized.referenceUrl) {
+            normalized.metadata.referenceUrl = normalized.referenceUrl;
+          } else if (normalized.data) {
+            await storage.put(finalKey, normalized.data);
+          } else {
+            throw new Error("Ingest failed: No data and not a reference.");
+          }
+          await runPipeline(recordId, finalKey, normalized.metadata, {
+            ...normalized.metadata.context ?? {},
+            referenceUrl: normalized.referenceUrl
+          });
           return {
             id: recordId,
             key: finalKey,