@x12i/analytix-contracts 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+export type AnalyticType = "query" | "jsFunction" | "funcxFunction" | "matrix" | "dashboard" | "report" | "trend" | "composite";
+export type AnalyticStatus = "draft" | "active" | "deprecated" | "archived";
+export type AnalytixRunResult<T = unknown> = {
+    analyticId: string;
+    analyticType: AnalyticType;
+    version: number;
+    status: AnalyticStatus;
+    data: T;
+    meta: {
+        cache: {
+            hit: boolean;
+            key: string;
+            ageMs?: number;
+            reason?: "miss" | "fresh" | "probe-clean" | "manual-warm" | "bypassed";
+        };
+        probes: Array<{
+            profileId: string;
+            ran: boolean;
+            changed?: boolean;
+            durationMs?: number;
+        }>;
+        tier?: {
+            tierId: string;
+            level: number;
+            usedMaterializedInputs: string[];
+        };
+        execution: {
+            durationMs: number;
+            startedAt: string;
+            finishedAt: string;
+            traceId: string;
+        };
+        funcx?: {
+            funcxFunctionId: string;
+            model: string;
+            usage?: {
+                inputTokens: number;
+                outputTokens: number;
+                totalTokens: number;
+            };
+            cost?: {
+                amount: number;
+                currency: string;
+                estimated: boolean;
+            };
+            valueEstimate?: {
+                amount: number;
+                currency: string;
+                basis: string;
+            };
+            retries: number;
+        };
+        warnings?: string[];
+    };
+};
+export type AnalytixErrorCode = "VALIDATION_ERROR" | "ANALYTIC_NOT_FOUND" | "ANALYTIC_NOT_ACTIVE" | "ANALYTIC_ARCHIVED" | "SOURCE_NOT_FOUND" | "QUERY_NOT_FOUND" | "FUNCTION_NOT_FOUND" | "MATRIX_NOT_FOUND" | "DASHBOARD_NOT_FOUND" | "REPORT_NOT_FOUND" | "TIER_NOT_FOUND" | "TIER_CYCLE_DETECTED" | "TIER_DEPENDENCY_MISSING" | "SANDBOX_VIOLATION" | "TIMEOUT_EXCEEDED" | "MEMORY_EXCEEDED" | "OUTPUT_SIZE_EXCEEDED" | "OUTPUT_VALIDATION_FAILED" | "FUNCX_FUNCTION_NOT_FOUND" | "FUNCX_EXECUTION_ERROR" | "FUNCX_TIMEOUT" | "FUNCX_MODEL_UNAVAILABLE" | "FUNCX_OUTPUT_VALIDATION_FAILED" | "CACHE_WRITE_FAILED" | "CACHE_KEY_COLLISION" | "MATRIX_CELL_NOT_SUPPORTED" | "DRILLDOWN_NOT_SUPPORTED" | "UNAUTHORIZED" | "FORBIDDEN" | "PLAYGROUND_ACCESS_DENIED" | "SOURCE_CONNECTION_FAILED" | "SOURCE_QUERY_TIMEOUT" | "SOURCE_ACCESS_DENIED" | "CATALOX_VALIDATION_FAILED" | "CATALOX_VERSION_CONFLICT" | "CATALOX_REFERENCE_NOT_FOUND" | "DRAFT_VALIDATION_FAILED" | "PROMOTE_CONFLICT" | "RATE_LIMITED" | "INTERNAL_ERROR";
+export type AnalytixError = {
+    error: {
+        code: AnalytixErrorCode;
+        message: string;
+        httpStatus: number;
+        details?: Record<string, unknown>;
+        traceId: string;
+    };
+};
+export type AnalyticRef = string;
+export declare function parseAnalyticRef(ref: AnalyticRef): {
+    id: string;
+    version?: number;
+};
+export type CataloxCommonFields = {
+    _catalogId: string;
+    id: string;
+    version: number;
+    status: AnalyticStatus;
+    title: string;
+    description?: string;
+    tags?: string[];
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy: string;
+    metadata: {
+        domainIds?: string[];
+        agentIds?: string[];
+    };
+};
+export type QueryTarget = "source" | "analytix" | "tier" | "trend" | "matrix" | "report" | "dashboard";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAnalyticRef = parseAnalyticRef;
+function parseAnalyticRef(ref) {
+    const parts = ref.split("@");
+    if (parts.length === 2) {
+        return { id: parts[0], version: parseInt(parts[1], 10) };
+    }
+    return { id: ref };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AA4GA,4CAMC;AAND,SAAgB,gBAAgB,CAAC,GAAgB;IAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@x12i/analytix-contracts",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {},
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}