@nexussdk/contracts 0.0.1 → 0.0.4

package/README.md

@@ -0,0 +1,32 @@
+# @nexussdk/contracts
+
+Single Source of Truth (SSOT) data contracts and TypeScript interfaces for the **Nexus Platform** ecosystem.
+
+[![npm version](https://img.shields.io/npm/v/@nexussdk/contracts.svg)](https://www.npmjs.com/package/@nexussdk/contracts)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Installation
+
+```bash
+npm install @nexussdk/contracts
+# or
+pnpm add @nexussdk/contracts
+```
+
+---
+
+## Exports
+
+- `@nexussdk/contracts`: Root unified types
+- `@nexussdk/contracts/flags`: Feature flag, evaluation rule, and rollout segment definitions
+- `@nexussdk/contracts/tracker`: Telemetry event, breadcrumb, and exception payload interfaces
+- `@nexussdk/contracts/auth`: Client key and environment metadata definitions
+- `@nexussdk/contracts/rfc7807`: Problem Details standard error structures
+
+---
+
+## License
+
+MIT © [Nexus Platform](https://github.com/Huynhdung295/NexusSDK)

package/dist/auth.cjs

@@ -1,4 +1 @@
-'use strict';
-
-//# sourceMappingURL=auth.cjs.map
-//# sourceMappingURL=auth.cjs.map
+'use strict';

package/dist/auth.mjs

@@ -1,3 +0,0 @@
-
-//# sourceMappingURL=auth.mjs.map
-//# sourceMappingURL=auth.mjs.map

package/dist/flags.cjs

@@ -1,4 +1 @@
-'use strict';
-
-//# sourceMappingURL=flags.cjs.map
-//# sourceMappingURL=flags.cjs.map
+'use strict';

package/dist/flags.mjs

@@ -1,3 +0,0 @@
-
-//# sourceMappingURL=flags.mjs.map
-//# sourceMappingURL=flags.mjs.map

package/dist/index.cjs

@@ -1,8 +1,2 @@
-'use strict';
-
-// src/rfc7807.ts
-var NEXUS_ERROR_BASE = "https://nexus.dev/errors";
-
-exports.NEXUS_ERROR_BASE = NEXUS_ERROR_BASE;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map
+'use strict';var t="https://nexus.dev/errors";
+exports.NEXUS_ERROR_BASE=t;

package/dist/index.d.mts

@@ -1,4 +1,4 @@
 export { Account, AccountStatus, ApiKey, ApiKeyType, Environment, GeneratedApiKeyResponse, LoginDto, PlanTier, Project, RegisterAccountDto, SessionPayload } from './auth.mjs';
 export { BatchFlagEvaluation, CreateFlagDto, FeatureFlag, FlagEvaluationResult, FlagStreamEvent, FlagVariants, RuleOperator, TargetingRule, UpdateFlagDto, UserContext, VariantValue } from './flags.mjs';
-export { Breadcrumb, BreadcrumbCategory, DeviceContext, ErrorEventEntity, ErrorEventPayload, ErrorGroupSummary, SeverityLevel, StackFrame } from './tracker.mjs';
+export { Breadcrumb, BreadcrumbCategory, DevServerEventEnvelope, DeviceContext, ErrorEventEntity, ErrorEventPayload, ErrorGroupSummary, NexusErrorInfo, PerformanceVitalEntry, PerformanceVitalsOptions, SamplingConfig, SeverityLevel, StackFrame, TransportPlugin, VitalMetricName } from './tracker.mjs';
 export { NEXUS_ERROR_BASE, ProblemDetails } from './rfc7807.mjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { Account, AccountStatus, ApiKey, ApiKeyType, Environment, GeneratedApiKeyResponse, LoginDto, PlanTier, Project, RegisterAccountDto, SessionPayload } from './auth.js';
 export { BatchFlagEvaluation, CreateFlagDto, FeatureFlag, FlagEvaluationResult, FlagStreamEvent, FlagVariants, RuleOperator, TargetingRule, UpdateFlagDto, UserContext, VariantValue } from './flags.js';
-export { Breadcrumb, BreadcrumbCategory, DeviceContext, ErrorEventEntity, ErrorEventPayload, ErrorGroupSummary, SeverityLevel, StackFrame } from './tracker.js';
+export { Breadcrumb, BreadcrumbCategory, DevServerEventEnvelope, DeviceContext, ErrorEventEntity, ErrorEventPayload, ErrorGroupSummary, NexusErrorInfo, PerformanceVitalEntry, PerformanceVitalsOptions, SamplingConfig, SeverityLevel, StackFrame, TransportPlugin, VitalMetricName } from './tracker.js';
 export { NEXUS_ERROR_BASE, ProblemDetails } from './rfc7807.js';

package/dist/index.mjs

@@ -1,6 +1,2 @@
-// src/rfc7807.ts
-var NEXUS_ERROR_BASE = "https://nexus.dev/errors";
-
-export { NEXUS_ERROR_BASE };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+var t="https://nexus.dev/errors";
+export{t as NEXUS_ERROR_BASE};

package/dist/rfc7807.cjs

@@ -1,8 +1,2 @@
-'use strict';
-
-// src/rfc7807.ts
-var NEXUS_ERROR_BASE = "https://nexus.dev/errors";
-
-exports.NEXUS_ERROR_BASE = NEXUS_ERROR_BASE;
-//# sourceMappingURL=rfc7807.cjs.map
-//# sourceMappingURL=rfc7807.cjs.map
+'use strict';var t="https://nexus.dev/errors";
+exports.NEXUS_ERROR_BASE=t;

package/dist/rfc7807.mjs

@@ -1,6 +1,2 @@
-// src/rfc7807.ts
-var NEXUS_ERROR_BASE = "https://nexus.dev/errors";
-
-export { NEXUS_ERROR_BASE };
-//# sourceMappingURL=rfc7807.mjs.map
-//# sourceMappingURL=rfc7807.mjs.map
+var t="https://nexus.dev/errors";
+export{t as NEXUS_ERROR_BASE};

package/dist/tracker.cjs

@@ -1,4 +1 @@
-'use strict';
-
-//# sourceMappingURL=tracker.cjs.map
-//# sourceMappingURL=tracker.cjs.map
+'use strict';

package/dist/tracker.d.mts

@@ -194,4 +194,147 @@ interface ErrorGroupSummary {
     lastSeenAt: string;
 }
 
-export { type Breadcrumb, type BreadcrumbCategory, type DeviceContext, type ErrorEventEntity, type ErrorEventPayload, type ErrorGroupSummary, type SeverityLevel, type StackFrame, UserContext };
+/**
+ * Normalized error information passed to NexusGuard fallback render function.
+ * Framework-agnostic — used by React, Vue, and Vanilla integrations.
+ *
+ * @example
+ * // React render prop
+ * <NexusGuard fallback={({ error, errorId, reset }) => (
+ *   <div>Error #{errorId}: {error.message} <button onClick={reset}>Retry</button></div>
+ * )}>
+ *   <App />
+ * </NexusGuard>
+ */
+interface NexusErrorInfo {
+    /** The original Error object that triggered the boundary. */
+    error: Error;
+    /**
+     * Deterministic fingerprint ID for this error class.
+     * Can be shown to users as a support reference code.
+     */
+    errorId: string;
+    /** Resets the error boundary back to normal rendering state. */
+    reset: () => void;
+    /** Component stack trace (React/Vue only — undefined in Vanilla). */
+    componentStack?: string;
+}
+/**
+ * Custom transport plugin for SDK error event delivery.
+ * Allows complete replacement of the default fetch-based ingestion transport.
+ *
+ * @example
+ * // Custom Sentry forwarding transport
+ * const sentryTransport: TransportPlugin = async (event) => {
+ *   Sentry.captureException(new Error(event.errorMessage));
+ * };
+ *
+ * Nexus.init({ transport: sentryTransport });
+ */
+type TransportPlugin = 'fetch' | 'console' | 'localStorage' | ((event: ErrorEventPayload) => void | Promise<void>);
+/**
+ * Client-side event sampling and rate limiting configuration.
+ *
+ * @example
+ * Nexus.init({
+ *   sampling: {
+ *     rate: 0.5,           // Capture 50% of errors
+ *     dedupeWindow: 5000,  // 5s dedup window
+ *     maxPerSession: 25,   // Max 25 unique errors per session
+ *   }
+ * });
+ */
+interface SamplingConfig {
+    /**
+     * Fraction of errors to capture and transmit. Range: 0.0 (none) to 1.0 (all).
+     * @default 1.0
+     */
+    rate?: number;
+    /**
+     * Milliseconds sliding window for client-side deduplication.
+     * Duplicate errors within this window are counted but not retransmitted.
+     * @default 10000
+     */
+    dedupeWindow?: number;
+    /**
+     * Maximum number of unique error fingerprints captured per browser session.
+     * Prevents event storms in crash-loop scenarios.
+     * @default 100
+     */
+    maxPerSession?: number;
+}
+/**
+ * Web Vitals metric names measured by the Performance observer.
+ */
+type VitalMetricName = 'LCP' | 'CLS' | 'FID' | 'TTFB' | 'INP' | 'FCP';
+/**
+ * Captured Web Vitals performance metric entry.
+ *
+ * @example
+ * const entry: PerformanceVitalEntry = {
+ *   name: 'LCP',
+ *   value: 1200,
+ *   rating: 'good',
+ *   delta: 1200,
+ *   navigationType: 'navigate',
+ * };
+ */
+interface PerformanceVitalEntry {
+    /** Metric name. */
+    name: VitalMetricName;
+    /** Metric value in milliseconds (or unitless score for CLS). */
+    value: number;
+    /** Quality rating based on Core Web Vitals thresholds. */
+    rating: 'good' | 'needs-improvement' | 'poor';
+    /** Delta from previous measurement in the same session. */
+    delta: number;
+    /** Navigation type that initiated the metric measurement. */
+    navigationType: 'navigate' | 'reload' | 'back-forward' | 'prerender' | string;
+}
+/**
+ * Configuration for the Web Vitals performance observer.
+ *
+ * @example
+ * attachWebVitals(tracker, {
+ *   captureAsEvents: true,
+ *   poorRatingOnly: true,
+ * });
+ */
+interface PerformanceVitalsOptions {
+    /**
+     * When true, captures poor/needs-improvement vitals as full error events.
+     * When false, captures all vitals as breadcrumbs only.
+     * @default false
+     */
+    captureAsEvents?: boolean;
+    /**
+     * When true, only captures metrics rated 'poor' or 'needs-improvement'.
+     * @default false
+     */
+    poorRatingOnly?: boolean;
+    /**
+     * Subset of vital names to observe. Defaults to all supported vitals.
+     * @default ['LCP', 'CLS', 'FID', 'TTFB', 'INP', 'FCP']
+     */
+    vitals?: VitalMetricName[];
+    /**
+     * Long task duration threshold in milliseconds. Tasks exceeding this
+     * are recorded as breadcrumbs with category 'performance'.
+     * @default 50
+     */
+    longTaskThresholdMs?: number;
+}
+/**
+ * Event envelope used by the nexus-dev local ingestion server.
+ * Wraps ErrorEventPayload with server-assigned metadata.
+ */
+interface DevServerEventEnvelope {
+    /** Monotonically increasing server-assigned event ID. */
+    id: number;
+    /** ISO timestamp when the dev server received the event. */
+    receivedAt: string;
+    /** The captured error event payload. */
+    payload: ErrorEventPayload;
+}
+
+export { type Breadcrumb, type BreadcrumbCategory, type DevServerEventEnvelope, type DeviceContext, type ErrorEventEntity, type ErrorEventPayload, type ErrorGroupSummary, type NexusErrorInfo, type PerformanceVitalEntry, type PerformanceVitalsOptions, type SamplingConfig, type SeverityLevel, type StackFrame, type TransportPlugin, UserContext, type VitalMetricName };

package/dist/tracker.d.ts

@@ -194,4 +194,147 @@ interface ErrorGroupSummary {
     lastSeenAt: string;
 }
 
-export { type Breadcrumb, type BreadcrumbCategory, type DeviceContext, type ErrorEventEntity, type ErrorEventPayload, type ErrorGroupSummary, type SeverityLevel, type StackFrame, UserContext };
+/**
+ * Normalized error information passed to NexusGuard fallback render function.
+ * Framework-agnostic — used by React, Vue, and Vanilla integrations.
+ *
+ * @example
+ * // React render prop
+ * <NexusGuard fallback={({ error, errorId, reset }) => (
+ *   <div>Error #{errorId}: {error.message} <button onClick={reset}>Retry</button></div>
+ * )}>
+ *   <App />
+ * </NexusGuard>
+ */
+interface NexusErrorInfo {
+    /** The original Error object that triggered the boundary. */
+    error: Error;
+    /**
+     * Deterministic fingerprint ID for this error class.
+     * Can be shown to users as a support reference code.
+     */
+    errorId: string;
+    /** Resets the error boundary back to normal rendering state. */
+    reset: () => void;
+    /** Component stack trace (React/Vue only — undefined in Vanilla). */
+    componentStack?: string;
+}
+/**
+ * Custom transport plugin for SDK error event delivery.
+ * Allows complete replacement of the default fetch-based ingestion transport.
+ *
+ * @example
+ * // Custom Sentry forwarding transport
+ * const sentryTransport: TransportPlugin = async (event) => {
+ *   Sentry.captureException(new Error(event.errorMessage));
+ * };
+ *
+ * Nexus.init({ transport: sentryTransport });
+ */
+type TransportPlugin = 'fetch' | 'console' | 'localStorage' | ((event: ErrorEventPayload) => void | Promise<void>);
+/**
+ * Client-side event sampling and rate limiting configuration.
+ *
+ * @example
+ * Nexus.init({
+ *   sampling: {
+ *     rate: 0.5,           // Capture 50% of errors
+ *     dedupeWindow: 5000,  // 5s dedup window
+ *     maxPerSession: 25,   // Max 25 unique errors per session
+ *   }
+ * });
+ */
+interface SamplingConfig {
+    /**
+     * Fraction of errors to capture and transmit. Range: 0.0 (none) to 1.0 (all).
+     * @default 1.0
+     */
+    rate?: number;
+    /**
+     * Milliseconds sliding window for client-side deduplication.
+     * Duplicate errors within this window are counted but not retransmitted.
+     * @default 10000
+     */
+    dedupeWindow?: number;
+    /**
+     * Maximum number of unique error fingerprints captured per browser session.
+     * Prevents event storms in crash-loop scenarios.
+     * @default 100
+     */
+    maxPerSession?: number;
+}
+/**
+ * Web Vitals metric names measured by the Performance observer.
+ */
+type VitalMetricName = 'LCP' | 'CLS' | 'FID' | 'TTFB' | 'INP' | 'FCP';
+/**
+ * Captured Web Vitals performance metric entry.
+ *
+ * @example
+ * const entry: PerformanceVitalEntry = {
+ *   name: 'LCP',
+ *   value: 1200,
+ *   rating: 'good',
+ *   delta: 1200,
+ *   navigationType: 'navigate',
+ * };
+ */
+interface PerformanceVitalEntry {
+    /** Metric name. */
+    name: VitalMetricName;
+    /** Metric value in milliseconds (or unitless score for CLS). */
+    value: number;
+    /** Quality rating based on Core Web Vitals thresholds. */
+    rating: 'good' | 'needs-improvement' | 'poor';
+    /** Delta from previous measurement in the same session. */
+    delta: number;
+    /** Navigation type that initiated the metric measurement. */
+    navigationType: 'navigate' | 'reload' | 'back-forward' | 'prerender' | string;
+}
+/**
+ * Configuration for the Web Vitals performance observer.
+ *
+ * @example
+ * attachWebVitals(tracker, {
+ *   captureAsEvents: true,
+ *   poorRatingOnly: true,
+ * });
+ */
+interface PerformanceVitalsOptions {
+    /**
+     * When true, captures poor/needs-improvement vitals as full error events.
+     * When false, captures all vitals as breadcrumbs only.
+     * @default false
+     */
+    captureAsEvents?: boolean;
+    /**
+     * When true, only captures metrics rated 'poor' or 'needs-improvement'.
+     * @default false
+     */
+    poorRatingOnly?: boolean;
+    /**
+     * Subset of vital names to observe. Defaults to all supported vitals.
+     * @default ['LCP', 'CLS', 'FID', 'TTFB', 'INP', 'FCP']
+     */
+    vitals?: VitalMetricName[];
+    /**
+     * Long task duration threshold in milliseconds. Tasks exceeding this
+     * are recorded as breadcrumbs with category 'performance'.
+     * @default 50
+     */
+    longTaskThresholdMs?: number;
+}
+/**
+ * Event envelope used by the nexus-dev local ingestion server.
+ * Wraps ErrorEventPayload with server-assigned metadata.
+ */
+interface DevServerEventEnvelope {
+    /** Monotonically increasing server-assigned event ID. */
+    id: number;
+    /** ISO timestamp when the dev server received the event. */
+    receivedAt: string;
+    /** The captured error event payload. */
+    payload: ErrorEventPayload;
+}
+
+export { type Breadcrumb, type BreadcrumbCategory, type DevServerEventEnvelope, type DeviceContext, type ErrorEventEntity, type ErrorEventPayload, type ErrorGroupSummary, type NexusErrorInfo, type PerformanceVitalEntry, type PerformanceVitalsOptions, type SamplingConfig, type SeverityLevel, type StackFrame, type TransportPlugin, UserContext, type VitalMetricName };

package/dist/tracker.mjs

@@ -1,3 +0,0 @@
-
-//# sourceMappingURL=tracker.mjs.map
-//# sourceMappingURL=tracker.mjs.map

package/package.json

@@ -1,11 +1,39 @@
 {
   "name": "@nexussdk/contracts",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "private": false,
   "publishConfig": {
     "access": "public"
   },
   "description": "Single Source of Truth (SSOT) data contracts for the Nexus Platform ecosystem",
+  "license": "MIT",
+  "author": "Nexus",
+  "contributors": [
+    {
+      "name": "Hồ Huỳnh Dũng",
+      "email": "hohuynhdung@gmail.com",
+      "url": "https://github.com/Huynhdung295"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Huynhdung295/NexusSDK.git",
+    "directory": "packages/contracts"
+  },
+  "homepage": "https://github.com/Huynhdung295/NexusSDK#readme",
+  "keywords": [
+    "nexus",
+    "nexussdk",
+    "contracts",
+    "typescript",
+    "feature-flags",
+    "telemetry",
+    "rfc7807"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",

package/.turbo/turbo-build.log

@@ -1,52 +0,0 @@
-
-> @nexussdk/contracts@0.0.1 build /home/runner/work/NexusSDK/NexusSDK/packages/contracts
-> tsup
-
-CLI Building entry: src/auth.ts, src/flags.ts, src/index.ts, src/rfc7807.ts, src/tracker.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/NexusSDK/NexusSDK/packages/contracts/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-CJS Build start
-Generated an empty chunk: "auth".
-Generated an empty chunk: "flags".
-Generated an empty chunk: "tracker".
-Generated an empty chunk: "auth".
-Generated an empty chunk: "flags".
-Generated an empty chunk: "tracker".
-CJS dist/auth.cjs        82.00 B
-CJS dist/flags.cjs       84.00 B
-CJS dist/index.cjs       199.00 B
-CJS dist/rfc7807.cjs     203.00 B
-CJS dist/tracker.cjs     88.00 B
-CJS dist/auth.cjs.map    69.00 B
-CJS dist/flags.cjs.map   70.00 B
-CJS dist/index.cjs.map   2.58 KB
-CJS dist/rfc7807.cjs.map 2.58 KB
-CJS dist/tracker.cjs.map 72.00 B
-CJS ⚡️ Build success in 111ms
-ESM dist/auth.mjs        68.00 B
-ESM dist/flags.mjs       70.00 B
-ESM dist/index.mjs       168.00 B
-ESM dist/rfc7807.mjs     172.00 B
-ESM dist/tracker.mjs     74.00 B
-ESM dist/auth.mjs.map    69.00 B
-ESM dist/flags.mjs.map   70.00 B
-ESM dist/index.mjs.map   2.57 KB
-ESM dist/rfc7807.mjs.map 2.58 KB
-ESM dist/tracker.mjs.map 72.00 B
-ESM ⚡️ Build success in 113ms
-DTS Build start
-DTS ⚡️ Build success in 1002ms
-DTS dist/index.d.mts   607.00 B
-DTS dist/rfc7807.d.mts 2.49 KB
-DTS dist/tracker.d.mts 6.48 KB
-DTS dist/flags.d.mts   7.17 KB
-DTS dist/auth.d.mts    6.21 KB
-DTS dist/index.d.ts    603.00 B
-DTS dist/rfc7807.d.ts  2.49 KB
-DTS dist/tracker.d.ts  6.48 KB
-DTS dist/flags.d.ts    7.17 KB
-DTS dist/auth.d.ts     6.21 KB

package/dist/auth.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"auth.cjs"}

package/dist/auth.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"auth.mjs"}

package/dist/flags.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"flags.cjs"}

package/dist/flags.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"flags.mjs"}

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rfc7807.ts"],"names":[],"mappings":";;;AA2EO,IAAM,gBAAA,GAAmB","file":"index.cjs","sourcesContent":["/**\n * @fileoverview Problem Details for HTTP APIs Specification (RFC 7807).\n * Standardized error format across Go-Gin and NestJS error responses.\n * @see {@link https://www.rfc-editor.org/rfc/rfc7807}\n * @module @nexus/contracts/rfc7807\n */\n\n/**\n * RFC 7807 Compliant Error Schema.\n * Ensures consistent machine-readable error diagnostics across all Nexus services.\n *\n * @example\n * const problem: ProblemDetails = {\n *   type: 'https://nexus.dev/errors/quota-exceeded',\n *   title: 'Monthly Quota Exceeded',\n *   status: 429,\n *   detail: \"API Key 'pk_live_...' has exhausted its limit of 50,000 monthly events.\",\n *   instance: '/api/v1/telemetry/errors',\n *   timestamp: '2024-06-01T12:00:00Z',\n * };\n */\nexport interface ProblemDetails {\n  /**\n   * URI reference identifying the problem type.\n   * Should be a stable, documented URI that clients can bookmark.\n   * @example 'https://nexus.dev/errors/rate-limit-exceeded'\n   */\n  type: string;\n  /**\n   * Short, human-readable summary of problem type.\n   * Must be invariant across occurrences of the same problem type.\n   * @example 'Too Many Requests'\n   */\n  title: string;\n  /**\n   * HTTP status code generated by origin server.\n   * @example 429\n   */\n  status: number;\n  /**\n   * Human-readable explanation specific to this occurrence of the problem.\n   * May differ across occurrences of the same problem type.\n   * @example \"API Key 'pk_live_a1b2...' has exhausted its monthly event limit.\"\n   */\n  detail: string;\n  /**\n   * URI reference identifying specific occurrence of problem.\n   * Typically the request path that triggered the error.\n   * @example '/api/v1/telemetry/errors'\n   */\n  instance?: string;\n  /**\n   * Additional diagnostic error parameters for validation failures.\n   * @example [{ name: 'email', reason: 'Must be a valid email address.' }]\n   */\n  invalidParams?: Array<{\n    /** Field name that caused the validation error. */\n    name: string;\n    /** Human-readable reason for the validation failure. */\n    reason: string;\n  }>;\n  /**\n   * ISO 8601 timestamp when error was produced.\n   * @example '2024-06-01T12:00:00.000Z'\n   */\n  timestamp?: string;\n}\n\n/**\n * Standard Nexus error type URI prefix.\n * All RFC 7807 type values should use this base to ensure namespacing consistency.\n *\n * @example\n * const type = `${NEXUS_ERROR_BASE}/rate-limit-exceeded`;\n */\nexport const NEXUS_ERROR_BASE = 'https://nexus.dev/errors' as const;\n"]}

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rfc7807.ts"],"names":[],"mappings":";AA2EO,IAAM,gBAAA,GAAmB","file":"index.mjs","sourcesContent":["/**\n * @fileoverview Problem Details for HTTP APIs Specification (RFC 7807).\n * Standardized error format across Go-Gin and NestJS error responses.\n * @see {@link https://www.rfc-editor.org/rfc/rfc7807}\n * @module @nexus/contracts/rfc7807\n */\n\n/**\n * RFC 7807 Compliant Error Schema.\n * Ensures consistent machine-readable error diagnostics across all Nexus services.\n *\n * @example\n * const problem: ProblemDetails = {\n *   type: 'https://nexus.dev/errors/quota-exceeded',\n *   title: 'Monthly Quota Exceeded',\n *   status: 429,\n *   detail: \"API Key 'pk_live_...' has exhausted its limit of 50,000 monthly events.\",\n *   instance: '/api/v1/telemetry/errors',\n *   timestamp: '2024-06-01T12:00:00Z',\n * };\n */\nexport interface ProblemDetails {\n  /**\n   * URI reference identifying the problem type.\n   * Should be a stable, documented URI that clients can bookmark.\n   * @example 'https://nexus.dev/errors/rate-limit-exceeded'\n   */\n  type: string;\n  /**\n   * Short, human-readable summary of problem type.\n   * Must be invariant across occurrences of the same problem type.\n   * @example 'Too Many Requests'\n   */\n  title: string;\n  /**\n   * HTTP status code generated by origin server.\n   * @example 429\n   */\n  status: number;\n  /**\n   * Human-readable explanation specific to this occurrence of the problem.\n   * May differ across occurrences of the same problem type.\n   * @example \"API Key 'pk_live_a1b2...' has exhausted its monthly event limit.\"\n   */\n  detail: string;\n  /**\n   * URI reference identifying specific occurrence of problem.\n   * Typically the request path that triggered the error.\n   * @example '/api/v1/telemetry/errors'\n   */\n  instance?: string;\n  /**\n   * Additional diagnostic error parameters for validation failures.\n   * @example [{ name: 'email', reason: 'Must be a valid email address.' }]\n   */\n  invalidParams?: Array<{\n    /** Field name that caused the validation error. */\n    name: string;\n    /** Human-readable reason for the validation failure. */\n    reason: string;\n  }>;\n  /**\n   * ISO 8601 timestamp when error was produced.\n   * @example '2024-06-01T12:00:00.000Z'\n   */\n  timestamp?: string;\n}\n\n/**\n * Standard Nexus error type URI prefix.\n * All RFC 7807 type values should use this base to ensure namespacing consistency.\n *\n * @example\n * const type = `${NEXUS_ERROR_BASE}/rate-limit-exceeded`;\n */\nexport const NEXUS_ERROR_BASE = 'https://nexus.dev/errors' as const;\n"]}

package/dist/rfc7807.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rfc7807.ts"],"names":[],"mappings":";;;AA2EO,IAAM,gBAAA,GAAmB","file":"rfc7807.cjs","sourcesContent":["/**\n * @fileoverview Problem Details for HTTP APIs Specification (RFC 7807).\n * Standardized error format across Go-Gin and NestJS error responses.\n * @see {@link https://www.rfc-editor.org/rfc/rfc7807}\n * @module @nexus/contracts/rfc7807\n */\n\n/**\n * RFC 7807 Compliant Error Schema.\n * Ensures consistent machine-readable error diagnostics across all Nexus services.\n *\n * @example\n * const problem: ProblemDetails = {\n *   type: 'https://nexus.dev/errors/quota-exceeded',\n *   title: 'Monthly Quota Exceeded',\n *   status: 429,\n *   detail: \"API Key 'pk_live_...' has exhausted its limit of 50,000 monthly events.\",\n *   instance: '/api/v1/telemetry/errors',\n *   timestamp: '2024-06-01T12:00:00Z',\n * };\n */\nexport interface ProblemDetails {\n  /**\n   * URI reference identifying the problem type.\n   * Should be a stable, documented URI that clients can bookmark.\n   * @example 'https://nexus.dev/errors/rate-limit-exceeded'\n   */\n  type: string;\n  /**\n   * Short, human-readable summary of problem type.\n   * Must be invariant across occurrences of the same problem type.\n   * @example 'Too Many Requests'\n   */\n  title: string;\n  /**\n   * HTTP status code generated by origin server.\n   * @example 429\n   */\n  status: number;\n  /**\n   * Human-readable explanation specific to this occurrence of the problem.\n   * May differ across occurrences of the same problem type.\n   * @example \"API Key 'pk_live_a1b2...' has exhausted its monthly event limit.\"\n   */\n  detail: string;\n  /**\n   * URI reference identifying specific occurrence of problem.\n   * Typically the request path that triggered the error.\n   * @example '/api/v1/telemetry/errors'\n   */\n  instance?: string;\n  /**\n   * Additional diagnostic error parameters for validation failures.\n   * @example [{ name: 'email', reason: 'Must be a valid email address.' }]\n   */\n  invalidParams?: Array<{\n    /** Field name that caused the validation error. */\n    name: string;\n    /** Human-readable reason for the validation failure. */\n    reason: string;\n  }>;\n  /**\n   * ISO 8601 timestamp when error was produced.\n   * @example '2024-06-01T12:00:00.000Z'\n   */\n  timestamp?: string;\n}\n\n/**\n * Standard Nexus error type URI prefix.\n * All RFC 7807 type values should use this base to ensure namespacing consistency.\n *\n * @example\n * const type = `${NEXUS_ERROR_BASE}/rate-limit-exceeded`;\n */\nexport const NEXUS_ERROR_BASE = 'https://nexus.dev/errors' as const;\n"]}

package/dist/rfc7807.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rfc7807.ts"],"names":[],"mappings":";AA2EO,IAAM,gBAAA,GAAmB","file":"rfc7807.mjs","sourcesContent":["/**\n * @fileoverview Problem Details for HTTP APIs Specification (RFC 7807).\n * Standardized error format across Go-Gin and NestJS error responses.\n * @see {@link https://www.rfc-editor.org/rfc/rfc7807}\n * @module @nexus/contracts/rfc7807\n */\n\n/**\n * RFC 7807 Compliant Error Schema.\n * Ensures consistent machine-readable error diagnostics across all Nexus services.\n *\n * @example\n * const problem: ProblemDetails = {\n *   type: 'https://nexus.dev/errors/quota-exceeded',\n *   title: 'Monthly Quota Exceeded',\n *   status: 429,\n *   detail: \"API Key 'pk_live_...' has exhausted its limit of 50,000 monthly events.\",\n *   instance: '/api/v1/telemetry/errors',\n *   timestamp: '2024-06-01T12:00:00Z',\n * };\n */\nexport interface ProblemDetails {\n  /**\n   * URI reference identifying the problem type.\n   * Should be a stable, documented URI that clients can bookmark.\n   * @example 'https://nexus.dev/errors/rate-limit-exceeded'\n   */\n  type: string;\n  /**\n   * Short, human-readable summary of problem type.\n   * Must be invariant across occurrences of the same problem type.\n   * @example 'Too Many Requests'\n   */\n  title: string;\n  /**\n   * HTTP status code generated by origin server.\n   * @example 429\n   */\n  status: number;\n  /**\n   * Human-readable explanation specific to this occurrence of the problem.\n   * May differ across occurrences of the same problem type.\n   * @example \"API Key 'pk_live_a1b2...' has exhausted its monthly event limit.\"\n   */\n  detail: string;\n  /**\n   * URI reference identifying specific occurrence of problem.\n   * Typically the request path that triggered the error.\n   * @example '/api/v1/telemetry/errors'\n   */\n  instance?: string;\n  /**\n   * Additional diagnostic error parameters for validation failures.\n   * @example [{ name: 'email', reason: 'Must be a valid email address.' }]\n   */\n  invalidParams?: Array<{\n    /** Field name that caused the validation error. */\n    name: string;\n    /** Human-readable reason for the validation failure. */\n    reason: string;\n  }>;\n  /**\n   * ISO 8601 timestamp when error was produced.\n   * @example '2024-06-01T12:00:00.000Z'\n   */\n  timestamp?: string;\n}\n\n/**\n * Standard Nexus error type URI prefix.\n * All RFC 7807 type values should use this base to ensure namespacing consistency.\n *\n * @example\n * const type = `${NEXUS_ERROR_BASE}/rate-limit-exceeded`;\n */\nexport const NEXUS_ERROR_BASE = 'https://nexus.dev/errors' as const;\n"]}

package/dist/tracker.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"tracker.cjs"}

package/dist/tracker.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"tracker.mjs"}