@superblocksteam/telemetry 2.0.83-next.1

package/dist-esm/types/policy.js

@@ -0,0 +1,122 @@
+/**
+ * Telemetry Policy Types
+ *
+ * NOTE: In the hybrid tier architecture, the OTEL Collector handles
+ * sanitization, hashing, and routing. The SDK just emits full-fidelity data.
+ * See obs/otel-collector/config-tiered.yaml for Collector configuration.
+ */
+import { DeploymentTypeEnum } from "@superblocksteam/shared";
+// Re-export DeploymentTypeEnum as DeploymentType for backwards compatibility
+export { DeploymentTypeEnum as DeploymentType };
+/**
+ * Telemetry tier definitions.
+ *
+ * Tier 1 (Local): Full fidelity data for debugging. Stored in customer LGTM.
+ * Tier 2 (Operational): Sanitized metrics/traces for ops. Exported to Superblocks.
+ * Tier 3 (Analytics): AI experience telemetry. Exported with content controls.
+ *
+ * In the hybrid architecture:
+ * - SDK emits all data to the Collector
+ * - Collector transforms and routes to appropriate tier pipelines
+ * - Tier tagging, hashing, and filtering happen at Collector level
+ */
+export var TelemetryTier;
+(function (TelemetryTier) {
+    /** Full fidelity debugging data - prompts, code, tool IO, stack traces */
+    TelemetryTier["TIER_1_LOCAL"] = "tier_1_local";
+    /** Sanitized operational metrics and traces for dashboards/billing */
+    TelemetryTier["TIER_2_OPERATIONAL"] = "tier_2_operational";
+    /** AI experience telemetry - prompts, responses, quality signals (no tool outputs) */
+    TelemetryTier["TIER_3_AI_EXPERIENCE"] = "tier_3_ai_experience";
+})(TelemetryTier || (TelemetryTier = {}));
+export var EnforcementMode;
+(function (EnforcementMode) {
+    /** Log violations but allow */
+    EnforcementMode["AUDIT"] = "audit";
+    /** Block violations */
+    EnforcementMode["ENFORCE"] = "enforce";
+})(EnforcementMode || (EnforcementMode = {}));
+// ============================================================================
+// Default Policies
+// ============================================================================
+/** Default Tier 3 content policy (enabled with all guardrails) */
+export const TIER3_CONTENT_POLICY_DEFAULT = {
+    contentExportEnabled: true,
+    secretRedactionEnabled: true,
+    toolOutputFilteringEnabled: true,
+    maxPromptBytes: 32768,
+    maxResponseBytes: 65536,
+};
+/** Tier 3 content policy: disabled (kill switch) */
+export const TIER3_CONTENT_POLICY_DISABLED = {
+    contentExportEnabled: false,
+    secretRedactionEnabled: true,
+    toolOutputFilteringEnabled: true,
+    maxPromptBytes: 32768,
+    maxResponseBytes: 65536,
+};
+/**
+ * Cloud deployment: all tiers enabled and exported.
+ */
+export const CLOUD_DEFAULT_POLICY = {
+    deploymentType: DeploymentTypeEnum.CLOUD,
+    tiers: {
+        [TelemetryTier.TIER_1_LOCAL]: {
+            enabled: true,
+            exportEnabled: true,
+            sampleRate: 1.0,
+        },
+        [TelemetryTier.TIER_2_OPERATIONAL]: {
+            enabled: true,
+            exportEnabled: true,
+            sampleRate: 1.0,
+        },
+        [TelemetryTier.TIER_3_AI_EXPERIENCE]: {
+            enabled: true,
+            exportEnabled: true,
+            sampleRate: 1.0,
+        },
+    },
+    tier3Content: TIER3_CONTENT_POLICY_DEFAULT,
+    enforcementMode: EnforcementMode.ENFORCE,
+};
+/**
+ * Cloud-Prem deployment: Tier 1 local only, Tier 2/3 exported.
+ * Hashing/sanitization handled by OTEL Collector.
+ */
+export const CLOUD_PREM_DEFAULT_POLICY = {
+    deploymentType: DeploymentTypeEnum.CLOUD_PREM,
+    tiers: {
+        [TelemetryTier.TIER_1_LOCAL]: {
+            enabled: true,
+            exportEnabled: false,
+            sampleRate: 1.0,
+        },
+        [TelemetryTier.TIER_2_OPERATIONAL]: {
+            enabled: true,
+            exportEnabled: true,
+            sampleRate: 1.0,
+        },
+        [TelemetryTier.TIER_3_AI_EXPERIENCE]: {
+            enabled: true,
+            exportEnabled: true,
+            sampleRate: 1.0,
+        },
+    },
+    tier3Content: TIER3_CONTENT_POLICY_DEFAULT,
+    enforcementMode: EnforcementMode.ENFORCE,
+};
+/**
+ * Get the default policy for a deployment type.
+ */
+export function getDefaultPolicy(deploymentType) {
+    switch (deploymentType) {
+        case DeploymentTypeEnum.CLOUD:
+            return CLOUD_DEFAULT_POLICY;
+        case DeploymentTypeEnum.CLOUD_PREM:
+            return CLOUD_PREM_DEFAULT_POLICY;
+        default:
+            return CLOUD_DEFAULT_POLICY;
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist-esm/types/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/types/policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,6EAA6E;AAC7E,OAAO,EAAE,kBAAkB,IAAI,cAAc,EAAE,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,aASX;AATD,WAAY,aAAa;IACvB,0EAA0E;IAC1E,8CAA6B,CAAA;IAE7B,sEAAsE;IACtE,0DAAyC,CAAA;IAEzC,sFAAsF;IACtF,8DAA6C,CAAA;AAC/C,CAAC,EATW,aAAa,KAAb,aAAa,QASxB;AAED,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,+BAA+B;IAC/B,kCAAe,CAAA;IACf,uBAAuB;IACvB,sCAAmB,CAAA;AACrB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAgDD,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,kEAAkE;AAClE,MAAM,CAAC,MAAM,4BAA4B,GAAuB;IAC9D,oBAAoB,EAAE,IAAI;IAC1B,sBAAsB,EAAE,IAAI;IAC5B,0BAA0B,EAAE,IAAI;IAChC,cAAc,EAAE,KAAK;IACrB,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,6BAA6B,GAAuB;IAC/D,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,IAAI;IAC5B,0BAA0B,EAAE,IAAI;IAChC,cAAc,EAAE,KAAK;IACrB,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAoB;IACnD,cAAc,EAAE,kBAAkB,CAAC,KAAK;IACxC,KAAK,EAAE;QACL,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE;YAC5B,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,GAAG;SAChB;QACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;YAClC,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,GAAG;SAChB;QACD,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE;YACpC,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,GAAG;SAChB;KACF;IACD,YAAY,EAAE,4BAA4B;IAC1C,eAAe,EAAE,eAAe,CAAC,OAAO;CACzC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,cAAc,EAAE,kBAAkB,CAAC,UAAU;IAC7C,KAAK,EAAE;QACL,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE;YAC5B,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,KAAK;YACpB,UAAU,EAAE,GAAG;SAChB;QACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;YAClC,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,GAAG;SAChB;QACD,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE;YACpC,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,UAAU,EAAE,GAAG;SAChB;KACF;IACD,YAAY,EAAE,4BAA4B;IAC1C,eAAe,EAAE,eAAe,CAAC,OAAO;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,cAAkC;IAElC,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,kBAAkB,CAAC,KAAK;YAC3B,OAAO,oBAAoB,CAAC;QAC9B,KAAK,kBAAkB,CAAC,UAAU;YAChC,OAAO,yBAAyB,CAAC;QACnC;YACE,OAAO,oBAAoB,CAAC;IAChC,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@superblocksteam/telemetry",
+  "version": "2.0.83-next.1",
+  "description": "Superblocks Telemetry - Canonical OTEL bootstrap with tier-aware policy enforcement",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/superblocksteam/superblocks.git"
+  },
+  "license": "Superblocks Community Software License",
+  "engines": {
+    "node": ">=24"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist-esm/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist-esm/index.js",
+      "require": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist-esm/node/index.js",
+      "require": "./dist/node/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "import": "./dist-esm/browser/index.js",
+      "require": "./dist/browser/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist-esm/testing/index.js",
+      "require": "./dist/testing/index.js"
+    },
+    "./lint": {
+      "types": "./dist/lint/index.d.ts",
+      "import": "./dist-esm/lint/index.js",
+      "require": "./dist/lint/index.js"
+    }
+  },
+  "files": [
+    "LICENSE.txt",
+    "dist",
+    "dist-esm",
+    "README.md"
+  ],
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": "^0.203.0",
+    "@opentelemetry/context-async-hooks": "^2.0.1",
+    "@opentelemetry/core": "^2.0.1",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.203.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.203.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.203.0",
+    "@opentelemetry/resources": "^2.0.1",
+    "@opentelemetry/sdk-logs": "^0.203.0",
+    "@opentelemetry/sdk-metrics": "^2.0.1",
+    "@opentelemetry/sdk-node": "^0.203.0",
+    "@opentelemetry/sdk-trace-base": "^2.0.1",
+    "@opentelemetry/sdk-trace-node": "^2.0.1",
+    "@opentelemetry/sdk-trace-web": "^2.0.1",
+    "@opentelemetry/semantic-conventions": "^1.28.0"
+  },
+  "peerDependencies": {
+    "@superblocksteam/shared": "0.9563.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24",
+    "chokidar-cli": "^3.0.0",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-config-turbo": "^2.6.1",
+    "eslint-plugin-prettier": "^5.5.4",
+    "globals": "^16.5.0",
+    "premove": "^4.0.0",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^2.0.0",
+    "@superblocksteam/shared": "0.9563.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc --build && tsc --build tsconfig.browser.json",
+    "check": "npm run typecheck && npm run lint",
+    "clean": "premove ./dist ./dist-esm *tsbuildinfo",
+    "dev": "chokidar \"**/*.ts\" -c \"npm run build\"",
+    "lint": "eslint --max-warnings 0 --concurrency=2",
+    "lint:fix": "eslint --fix --concurrency=2",
+    "lint:precommit": "eslint --fix --concurrency=2",
+    "publish-package": "pnpm publish",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}