@molecule/api-error-tracking-console 1.0.0

package/LICENSE

@@ -0,0 +1,115 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including the
+      original version of the Work and any modifications or additions
+      to that Work, that is intentionally submitted to the Licensor for
+      inclusion in the Work by the copyright owner or by an individual or
+      Legal Entity authorized to submit on behalf of the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event and under no legal theory shall
+      any Contributor be liable to You for damages.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2026 Molecule Dev, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/browser-guard.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-guard.d.ts.map

package/dist/browser-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-guard.d.ts","sourceRoot":"","sources":["../src/browser-guard.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,CAAA"}

package/dist/browser-guard.js

@@ -0,0 +1,19 @@
+/**
+ * Browser guard — `@molecule/api-error-tracking-console` is SERVER-ONLY.
+ *
+ * Generated by scripts/gen-browser-guards.mjs (workspace root) — edit THAT, not this.
+ * Evaluating a server package in a browser bundle is always an import-graph mistake
+ * (node APIs, secrets); without this guard it surfaces as a cryptic downstream crash
+ * ("Buffer is not defined") far from the culprit. Throwing here names the package and
+ * the fix at the exact moment the client bundle evaluates it. jsdom tests and SSR are
+ * unaffected: the throw requires browser globals AND the absence of a node runtime.
+ */
+const g = globalThis;
+if (g.window !== undefined && g.document !== undefined && !g.process?.versions?.node) {
+    throw new Error('@molecule/api-error-tracking-console is SERVER-ONLY: it was bundled into browser/client code. Import it only ' +
+        'from server code (a server route/function or your API), or dynamic-import it inside ' +
+        'the server handler — never from components or shared client modules, and never ' +
+        'polyfill Buffer/process to silence this.');
+}
+export {};
+//# sourceMappingURL=browser-guard.js.map

package/dist/browser-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-guard.js","sourceRoot":"","sources":["../src/browser-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,GAAG,UAIT,CAAA;AACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACrF,MAAM,IAAI,KAAK,CACb,+GAA+G;QAC7G,sFAAsF;QACtF,iFAAiF;QACjF,0CAA0C,CAC7C,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Console (logger-based) error tracking provider for molecule.dev.
+ *
+ * Zero-credential development default: captures are written as structured
+ * log lines through the bonded logger instead of being sent to a remote
+ * service. Swap in a remote bond (e.g. `@molecule/api-error-tracking-sentry`)
+ * for production without changing any consumer code.
+ *
+ * @module
+ * @example
+ * ```typescript
+ * import { setProvider, captureException } from '@molecule/api-error-tracking'
+ * import { provider } from '@molecule/api-error-tracking-console'
+ *
+ * // Bond at startup (e.g. in setupBonds()) — no credentials needed
+ * setProvider(provider)
+ *
+ * // Logs a structured "error-tracking: exception captured" line
+ * captureException(new Error('boom'), { tags: { source: 'worker' } })
+ * ```
+ * @remarks
+ * - Requires no configuration or credentials — safe in every environment.
+ * - Each capture gets a generated event id (returned and logged), mirroring
+ *   remote providers so consumer code behaves identically in development.
+ * - `setUser()` scopes subsequent captures like a remote provider's user
+ *   scope; `flush()` trivially resolves `true` (nothing is buffered).
+ */
+export * from './browser-guard.js';
+export * from './provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+/**
+ * Console (logger-based) error tracking provider for molecule.dev.
+ *
+ * Zero-credential development default: captures are written as structured
+ * log lines through the bonded logger instead of being sent to a remote
+ * service. Swap in a remote bond (e.g. `@molecule/api-error-tracking-sentry`)
+ * for production without changing any consumer code.
+ *
+ * @module
+ * @example
+ * ```typescript
+ * import { setProvider, captureException } from '@molecule/api-error-tracking'
+ * import { provider } from '@molecule/api-error-tracking-console'
+ *
+ * // Bond at startup (e.g. in setupBonds()) — no credentials needed
+ * setProvider(provider)
+ *
+ * // Logs a structured "error-tracking: exception captured" line
+ * captureException(new Error('boom'), { tags: { source: 'worker' } })
+ * ```
+ * @remarks
+ * - Requires no configuration or credentials — safe in every environment.
+ * - Each capture gets a generated event id (returned and logged), mirroring
+ *   remote providers so consumer code behaves identically in development.
+ * - `setUser()` scopes subsequent captures like a remote provider's user
+ *   scope; `flush()` trivially resolves `true` (nothing is buffered).
+ */
+export * from './browser-guard.js';
+export * from './provider.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Console (logger-based) error tracking provider implementation.
+ *
+ * Zero-credential development default: every capture is written as a
+ * structured log line through the bonded logger (`getLogger()` from
+ * `@molecule/api-bond`, console fallback). Nothing leaves the process, so
+ * there is nothing to configure and nothing to flush.
+ *
+ * @module
+ */
+import type { ErrorTrackingProvider } from '@molecule/api-error-tracking';
+/**
+ * Console error tracking provider. Logs structured captures through the
+ * bonded logger and reports a generated event id, mirroring the remote
+ * providers' behavior so app code works identically in development.
+ */
+export declare const provider: ErrorTrackingProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAGV,qBAAqB,EAEtB,MAAM,8BAA8B,CAAA;AAiCrC;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,qBAmCtB,CAAA"}

package/dist/provider.js

@@ -0,0 +1,78 @@
+/**
+ * Console (logger-based) error tracking provider implementation.
+ *
+ * Zero-credential development default: every capture is written as a
+ * structured log line through the bonded logger (`getLogger()` from
+ * `@molecule/api-bond`, console fallback). Nothing leaves the process, so
+ * there is nothing to configure and nothing to flush.
+ *
+ * @module
+ */
+import { randomUUID } from 'node:crypto';
+import { getLogger } from '@molecule/api-bond';
+const logger = getLogger();
+/** Maps a normalized severity level to the logger method that renders it. */
+const levelToLogMethod = {
+    fatal: 'error',
+    error: 'error',
+    warning: 'warn',
+    info: 'info',
+    debug: 'debug',
+};
+/** The user set via `setUser()`, merged into subsequent captures (Sentry-scope parity). */
+let currentUser = null;
+/**
+ * Builds the structured log payload for a capture: the per-capture context
+ * with the scoped `setUser()` user applied when the capture has none.
+ *
+ * @param context - The capture's normalized context, if any.
+ * @returns Structured fields for the log line (empty fields omitted).
+ */
+const toLogFields = (context) => {
+    const fields = {};
+    if (context?.tags)
+        fields.tags = context.tags;
+    const user = context?.user ?? currentUser;
+    if (user)
+        fields.user = user;
+    if (context?.extra)
+        fields.extra = context.extra;
+    if (context?.request)
+        fields.request = context.request;
+    return fields;
+};
+/**
+ * Console error tracking provider. Logs structured captures through the
+ * bonded logger and reports a generated event id, mirroring the remote
+ * providers' behavior so app code works identically in development.
+ */
+export const provider = {
+    captureException(error, context) {
+        const eventId = randomUUID();
+        logger.error('error-tracking: exception captured', {
+            eventId,
+            error,
+            ...toLogFields(context),
+        });
+        return eventId;
+    },
+    captureMessage(message, level = 'info', context) {
+        const eventId = randomUUID();
+        logger[levelToLogMethod[level]]('error-tracking: message captured', {
+            eventId,
+            message,
+            level,
+            ...toLogFields(context),
+        });
+        return eventId;
+    },
+    setUser(user) {
+        currentUser = user;
+    },
+    async flush(_timeoutMs) {
+        // Captures are written synchronously to the logger — nothing is ever
+        // buffered, so a flush always trivially succeeds.
+        return true;
+    },
+};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAQ9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;AAE1B,6EAA6E;AAC7E,MAAM,gBAAgB,GAAoE;IACxF,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACf,CAAA;AAED,2FAA2F;AAC3F,IAAI,WAAW,GAA6B,IAAI,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,OAA8B,EAA2B,EAAE;IAC9E,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,IAAI,OAAO,EAAE,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IAC7C,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,WAAW,CAAA;IACzC,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;IAC5B,IAAI,OAAO,EAAE,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IAChD,IAAI,OAAO,EAAE,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IACtD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA0B;IAC7C,gBAAgB,CAAC,KAAc,EAAE,OAA8B;QAC7D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;QAC5B,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;YACjD,OAAO;YACP,KAAK;YACL,GAAG,WAAW,CAAC,OAAO,CAAC;SACxB,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,cAAc,CACZ,OAAe,EACf,QAA4B,MAAM,EAClC,OAA8B;QAE9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;QAC5B,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,kCAAkC,EAAE;YAClE,OAAO;YACP,OAAO;YACP,KAAK;YACL,GAAG,WAAW,CAAC,OAAO,CAAC;SACxB,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,OAAO,CAAC,IAA8B;QACpC,WAAW,GAAG,IAAI,CAAA;IACpB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,UAAmB;QAC7B,qEAAqE;QACrE,kDAAkD;QAClD,OAAO,IAAI,CAAA;IACb,CAAC;CACF,CAAA"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@molecule/api-error-tracking-console",
+  "version": "1.0.0",
+  "description": "Console (logger-based) error tracking provider for molecule.dev — zero-credential development default.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "error-tracking",
+    "console",
+    "logger"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "@molecule/api-bond": "^1.0.0",
+    "@molecule/api-error-tracking": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/api/bonds/error-tracking/console"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/api/bonds/error-tracking/console",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}