@jaypie/fabric 0.2.0 → 0.2.2

package/dist/esm/index.js

@@ -32,7 +32,7 @@ const FABRIC_MODEL_FIELDS = {
     // Identity (required)
     ID: "id",
     // Schema
-    CLASS: "class",
+    CATEGORY: "category",
     MODEL: "model",
     TYPE: "type",
     // Storage
@@ -797,8 +797,8 @@ const DEFAULT_INDEXES = [
         sparse: true,
     },
     {
-        name: "indexClass",
-        pk: ["scope", "model", "class"],
+        name: "indexCategory",
+        pk: ["scope", "model", "category"],
         sk: ["sequence"],
         sparse: true,
     },
@@ -1457,42 +1457,68 @@ async function processField(fieldName, value, definition) {
 function isService(value) {
     return typeof value === "function" && "$fabric" in value;
 }
+/**
+ * Run serializer hook if provided
+ * Returns transformed output or original if serializer returns undefined/null/void
+ */
+async function runSerializer(data, serializer, context) {
+    if (!serializer) {
+        return data.output;
+    }
+    const result = await serializer(data, context);
+    if (result !== undefined && result !== null) {
+        return result;
+    }
+    return data.output;
+}
 /**
  * Fabric a service function
  *
- * Service builds a function that initiates a "controller" step that:
+ * Service builds a function that:
  * - Parses the input if it is a string to object
  * - Fabrics each input field to its type
  * - Calls the validation function or regular expression or checks the array
- * - Calls the service function and returns the response
+ * - Calls the service function
+ * - Calls the serializer hook (can transform output)
+ * - Returns the response
  *
  * The returned function has config properties for introspection.
  */
 function fabricService(config) {
-    const { input: inputDefinitions, service } = config;
+    const { input: inputDefinitions, serializer, service } = config;
     const handler = async (rawInput, context) => {
         // Parse input (handles string JSON)
         const parsedInput = parseInput(rawInput);
         // If no input definitions, pass through to service or return parsed input
         if (!inputDefinitions) {
+            let output;
             if (service) {
-                return service(parsedInput, context);
+                output = await service(parsedInput, context);
+            }
+            else {
+                output = parsedInput;
             }
-            return parsedInput;
+            // Run serializer
+            return (await runSerializer({ input: parsedInput, output }, serializer, context));
         }
         // Process all fields in parallel
         const entries = Object.entries(inputDefinitions);
         const processedValues = await Promise.all(entries.map(([fieldName, definition]) => processField(fieldName, parsedInput[fieldName], definition)));
         // Build processed input object
-        const processedInput = {};
+        const processedInputObj = {};
         entries.forEach(([fieldName], index) => {
-            processedInput[fieldName] = processedValues[index];
+            processedInputObj[fieldName] = processedValues[index];
         });
-        // Return processed input if no service, otherwise call service
+        // Call service or return processed input
+        let output;
         if (service) {
-            return service(processedInput, context);
+            output = await service(processedInputObj, context);
+        }
+        else {
+            output = processedInputObj;
         }
-        return processedInput;
+        // Run serializer hook
+        return (await runSerializer({ input: processedInputObj, output }, serializer, context));
     };
     // Attach config properties directly to handler for flat access
     const typedHandler = handler;
@@ -1503,6 +1529,8 @@ function fabricService(config) {
         typedHandler.description = config.description;
     if (config.input !== undefined)
         typedHandler.input = config.input;
+    if (config.serializer !== undefined)
+        typedHandler.serializer = config.serializer;
     if (config.service !== undefined)
         typedHandler.service = config.service;
     return typedHandler;
@@ -1521,6 +1549,7 @@ function fabricService(config) {
  * - `alias` overrides service.alias
  * - `description` overrides service.description
  * - `input` overrides service.input
+ * - `serializer` overrides service.serializer
  *
  * The original Service is never mutated - a new Service is created when overrides
  * are applied.
@@ -1544,7 +1573,7 @@ function fabricService(config) {
  * ```
  */
 function resolveService(config) {
-    const { alias, description, input, service } = config;
+    const { alias, description, input, serializer, service } = config;
     if (isService(service)) {
         // Service is pre-instantiated - config fields act as overrides
         // Create new Service with merged properties (config overrides service)
@@ -1552,6 +1581,7 @@ function resolveService(config) {
             alias: alias ?? service.alias,
             description: description ?? service.description,
             input: input ?? service.input,
+            serializer: serializer ?? service.serializer,
             service: service.service,
         });
     }
@@ -1560,6 +1590,7 @@ function resolveService(config) {
         alias,
         description,
         input,
+        serializer,
         service,
     });
 }
@@ -1626,7 +1657,9 @@ function extractEnumValues(type) {
         return undefined;
     // Check if it's a validated string enum (array of strings, possibly with RegExp)
     const stringValues = type.filter((item) => typeof item === "string");
-    if (stringValues.length > 0 && stringValues.length === type.filter((item) => typeof item === "string").length) {
+    if (stringValues.length > 0 &&
+        stringValues.length ===
+            type.filter((item) => typeof item === "string").length) {
         // All non-RegExp items are strings
         return stringValues;
     }
@@ -1665,7 +1698,6 @@ function hasRequiredInputs(inputs) {
  */
 function createServiceSuite(config) {
     const { name, version } = config;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const serviceRegistry = new Map();
     const categorySet = new Set();
     const suite = {
@@ -1692,9 +1724,8 @@ function createServiceSuite(config) {
             }
             return entry.service(inputs);
         },
-        register(
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        service, category) {
+        register(service, options) {
+            const { category } = options;
             const serviceName = service.alias;
             if (!serviceName) {
                 throw new Error("Service must have an alias to be registered");
@@ -1710,11 +1741,9 @@ function createServiceSuite(config) {
             serviceRegistry.set(serviceName, { service, meta });
             categorySet.add(category);
         },
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         getServiceFunctions() {
             return Array.from(serviceRegistry.values()).map((entry) => entry.service);
         },
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         getServiceFunction(serviceName) {
             return serviceRegistry.get(serviceName)?.service;
         },