@vivero/stoma-core 0.1.0-rc.0

package/dist/chunk-GHURCBEG.js

@@ -0,0 +1,45 @@
+// src/debug.ts
+var noopDebugLogger = () => {
+};
+function createDebugger(namespace, enabled) {
+  if (!enabled) return noopDebugLogger;
+  if (typeof enabled === "string" && !matchNamespace(namespace, enabled)) {
+    return noopDebugLogger;
+  }
+  return (message, ...args) => {
+    const parts = [`[${namespace}]`, message];
+    for (const arg of args) {
+      parts.push(
+        typeof arg === "object" && arg !== null ? JSON.stringify(arg) : String(arg)
+      );
+    }
+    console.debug(parts.join(" "));
+  };
+}
+function matchNamespace(namespace, pattern) {
+  const patterns = pattern.split(",").map((p) => p.trim());
+  return patterns.some((p) => {
+    if (p === "*") return true;
+    const regexStr = p.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+    return new RegExp(`^${regexStr}$`).test(namespace);
+  });
+}
+function createDebugFactory(enabled) {
+  if (!enabled) return () => noopDebugLogger;
+  const cache = /* @__PURE__ */ new Map();
+  return (namespace) => {
+    const cached = cache.get(namespace);
+    if (cached) return cached;
+    const logger = createDebugger(namespace, enabled);
+    cache.set(namespace, logger);
+    return logger;
+  };
+}
+
+export {
+  noopDebugLogger,
+  createDebugger,
+  matchNamespace,
+  createDebugFactory
+};
+//# sourceMappingURL=chunk-GHURCBEG.js.map

package/dist/chunk-GHURCBEG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/debug.ts"],"sourcesContent":["/**\n * Zero-dependency debug logging for edge runtimes.\n *\n * Provides `debug`-style namespace-based logging without the `debug` npm\n * package (which relies on `process.env` / `localStorage` and doesn't work\n * reliably in edge runtimes). Output goes to `console.debug()`.\n *\n * Shared between `@vivero/stoma` (gateway) and\n * `@vivero/stoma-analytics` (analytics pipeline).\n *\n * @module debug\n *\n * @example\n * ```ts\n * // Gateway usage\n * createGateway({ debug: \"stoma:policy:*\", ... });\n *\n * // Analytics usage\n * createProcessor({ debug: \"stoma-analytics:processor\", ... });\n *\n * // Direct usage\n * const debug = createDebugger(\"stoma:gateway\", true);\n * debug(\"route registered\", { path: \"/api/users\", methods: [\"GET\"] });\n * // Output: [stoma:gateway] route registered {\"path\":\"/api/users\",\"methods\":[\"GET\"]}\n * ```\n */\n\n/** A debug logging function - call with a message and optional structured data. */\nexport type DebugLogger = (message: string, ...args: unknown[]) => void;\n\n/** No-op logger used when debug is disabled */\nexport const noopDebugLogger: DebugLogger = () => {};\n\n/**\n * Create a debug logger for the given namespace.\n *\n * @param namespace - e.g. \"stoma:gateway\", \"stoma-analytics:processor\"\n * @param enabled - true = all namespaces, false/undefined = none, string = comma-separated glob patterns\n *\n * @example\n * ```ts\n * const debug = createDebugger(\"stoma:gateway\", true);\n * debug(\"route registered\", { path: \"/api/users\", methods: [\"GET\"] });\n *\n * const debug2 = createDebugger(\"stoma:policy:cache\", \"stoma:policy:*\");\n * debug2(\"HIT\", \"GET:/api/users\");\n * ```\n */\nexport function createDebugger(\n  namespace: string,\n  enabled: boolean | string | undefined\n): DebugLogger {\n  if (!enabled) return noopDebugLogger;\n\n  if (typeof enabled === \"string\" && !matchNamespace(namespace, enabled)) {\n    return noopDebugLogger;\n  }\n\n  return (message: string, ...args: unknown[]) => {\n    const parts = [`[${namespace}]`, message];\n    for (const arg of args) {\n      parts.push(\n        typeof arg === \"object\" && arg !== null\n          ? JSON.stringify(arg)\n          : String(arg)\n      );\n    }\n    console.debug(parts.join(\" \"));\n  };\n}\n\n/**\n * Check if a namespace matches a comma-separated list of glob patterns.\n *\n * Supports `*` as a wildcard for any sequence of characters.\n *\n * @example\n * ```ts\n * matchNamespace(\"stoma:gateway\", \"stoma:*\")                    // true\n * matchNamespace(\"stoma:policy:cache\", \"stoma:policy:*\")        // true\n * matchNamespace(\"stoma:gateway\", \"stoma:upstream\")             // false\n * matchNamespace(\"stoma:gateway\", \"stoma:gateway,stoma:upstream\") // true\n * matchNamespace(\"stoma:gateway\", \"*\")                          // true\n * ```\n */\nexport function matchNamespace(namespace: string, pattern: string): boolean {\n  const patterns = pattern.split(\",\").map((p) => p.trim());\n  return patterns.some((p) => {\n    if (p === \"*\") return true;\n    // Escape regex special chars, then convert * to .*\n    const regexStr = p\n      .replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\")\n      .replace(/\\*/g, \".*\");\n    return new RegExp(`^${regexStr}$`).test(namespace);\n  });\n}\n\n/**\n * Create a debug factory that produces namespaced loggers.\n * Caches loggers by namespace so repeated calls return the same function.\n *\n * @param enabled - The gateway/processor debug setting\n * @returns A factory function: `(namespace) => DebugLogger`\n */\nexport function createDebugFactory(\n  enabled: boolean | string | undefined\n): (namespace: string) => DebugLogger {\n  if (!enabled) return () => noopDebugLogger;\n\n  const cache = new Map<string, DebugLogger>();\n\n  return (namespace: string) => {\n    const cached = cache.get(namespace);\n    if (cached) return cached;\n\n    const logger = createDebugger(namespace, enabled);\n    cache.set(namespace, logger);\n    return logger;\n  };\n}\n"],"mappings":";AA+BO,IAAM,kBAA+B,MAAM;AAAC;AAiB5C,SAAS,eACd,WACA,SACa;AACb,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI,OAAO,YAAY,YAAY,CAAC,eAAe,WAAW,OAAO,GAAG;AACtE,WAAO;AAAA,EACT;AAEA,SAAO,CAAC,YAAoB,SAAoB;AAC9C,UAAM,QAAQ,CAAC,IAAI,SAAS,KAAK,OAAO;AACxC,eAAW,OAAO,MAAM;AACtB,YAAM;AAAA,QACJ,OAAO,QAAQ,YAAY,QAAQ,OAC/B,KAAK,UAAU,GAAG,IAClB,OAAO,GAAG;AAAA,MAChB;AAAA,IACF;AACA,YAAQ,MAAM,MAAM,KAAK,GAAG,CAAC;AAAA,EAC/B;AACF;AAgBO,SAAS,eAAe,WAAmB,SAA0B;AAC1E,QAAM,WAAW,QAAQ,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACvD,SAAO,SAAS,KAAK,CAAC,MAAM;AAC1B,QAAI,MAAM,IAAK,QAAO;AAEtB,UAAM,WAAW,EACd,QAAQ,qBAAqB,MAAM,EACnC,QAAQ,OAAO,IAAI;AACtB,WAAO,IAAI,OAAO,IAAI,QAAQ,GAAG,EAAE,KAAK,SAAS;AAAA,EACnD,CAAC;AACH;AASO,SAAS,mBACd,SACoC;AACpC,MAAI,CAAC,QAAS,QAAO,MAAM;AAE3B,QAAM,QAAQ,oBAAI,IAAyB;AAE3C,SAAO,CAAC,cAAsB;AAC5B,UAAM,SAAS,MAAM,IAAI,SAAS;AAClC,QAAI,OAAQ,QAAO;AAEnB,UAAM,SAAS,eAAe,WAAW,OAAO;AAChD,UAAM,IAAI,WAAW,MAAM;AAC3B,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/debug.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Zero-dependency debug logging for edge runtimes.
+ *
+ * Provides `debug`-style namespace-based logging without the `debug` npm
+ * package (which relies on `process.env` / `localStorage` and doesn't work
+ * reliably in edge runtimes). Output goes to `console.debug()`.
+ *
+ * Shared between `@vivero/stoma` (gateway) and
+ * `@vivero/stoma-analytics` (analytics pipeline).
+ *
+ * @module debug
+ *
+ * @example
+ * ```ts
+ * // Gateway usage
+ * createGateway({ debug: "stoma:policy:*", ... });
+ *
+ * // Analytics usage
+ * createProcessor({ debug: "stoma-analytics:processor", ... });
+ *
+ * // Direct usage
+ * const debug = createDebugger("stoma:gateway", true);
+ * debug("route registered", { path: "/api/users", methods: ["GET"] });
+ * // Output: [stoma:gateway] route registered {"path":"/api/users","methods":["GET"]}
+ * ```
+ */
+/** A debug logging function - call with a message and optional structured data. */
+type DebugLogger = (message: string, ...args: unknown[]) => void;
+/** No-op logger used when debug is disabled */
+declare const noopDebugLogger: DebugLogger;
+/**
+ * Create a debug logger for the given namespace.
+ *
+ * @param namespace - e.g. "stoma:gateway", "stoma-analytics:processor"
+ * @param enabled - true = all namespaces, false/undefined = none, string = comma-separated glob patterns
+ *
+ * @example
+ * ```ts
+ * const debug = createDebugger("stoma:gateway", true);
+ * debug("route registered", { path: "/api/users", methods: ["GET"] });
+ *
+ * const debug2 = createDebugger("stoma:policy:cache", "stoma:policy:*");
+ * debug2("HIT", "GET:/api/users");
+ * ```
+ */
+declare function createDebugger(namespace: string, enabled: boolean | string | undefined): DebugLogger;
+/**
+ * Check if a namespace matches a comma-separated list of glob patterns.
+ *
+ * Supports `*` as a wildcard for any sequence of characters.
+ *
+ * @example
+ * ```ts
+ * matchNamespace("stoma:gateway", "stoma:*")                    // true
+ * matchNamespace("stoma:policy:cache", "stoma:policy:*")        // true
+ * matchNamespace("stoma:gateway", "stoma:upstream")             // false
+ * matchNamespace("stoma:gateway", "stoma:gateway,stoma:upstream") // true
+ * matchNamespace("stoma:gateway", "*")                          // true
+ * ```
+ */
+declare function matchNamespace(namespace: string, pattern: string): boolean;
+/**
+ * Create a debug factory that produces namespaced loggers.
+ * Caches loggers by namespace so repeated calls return the same function.
+ *
+ * @param enabled - The gateway/processor debug setting
+ * @returns A factory function: `(namespace) => DebugLogger`
+ */
+declare function createDebugFactory(enabled: boolean | string | undefined): (namespace: string) => DebugLogger;
+
+export { type DebugLogger, createDebugFactory, createDebugger, matchNamespace, noopDebugLogger };

package/dist/debug.js

@@ -0,0 +1,13 @@
+import {
+  createDebugFactory,
+  createDebugger,
+  matchNamespace,
+  noopDebugLogger
+} from "./chunk-GHURCBEG.js";
+export {
+  createDebugFactory,
+  createDebugger,
+  matchNamespace,
+  noopDebugLogger
+};
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { DebugLogger, createDebugFactory, createDebugger, matchNamespace, noopDebugLogger } from './debug.js';

package/dist/index.js

@@ -0,0 +1,13 @@
+import {
+  createDebugFactory,
+  createDebugger,
+  matchNamespace,
+  noopDebugLogger
+} from "./chunk-GHURCBEG.js";
+export {
+  createDebugFactory,
+  createDebugger,
+  matchNamespace,
+  noopDebugLogger
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@vivero/stoma-core",
+  "version": "0.1.0-rc.0",
+  "description": "Shared utilities for Stoma packages — debug logging, timing helpers, and common type guards.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vivero-dev/stoma.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://stoma.vivero.dev",
+  "sideEffects": false,
+  "license": "MIT",
+  "author": {
+    "name": "Jonathan Bennett"
+  },
+  "bugs": {
+    "url": "https://github.com/vivero-dev/stoma/issues"
+  },
+  "keywords": [
+    "stoma",
+    "utilities",
+    "debug",
+    "edge-runtime"
+  ],
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./debug": {
+      "types": "./src/debug.ts",
+      "default": "./src/debug.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./debug": {
+        "types": "./dist/debug.d.ts",
+        "import": "./dist/debug.js",
+        "default": "./dist/debug.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}