@hawk.so/types 0.6.4 → 0.7.0

package/build/index.d.ts

@@ -1,3 +1,4 @@
+export * from './src/ai/stream';
 export * from './src/auth/tokensPair';
 export * from './src/base/businessOperation/businessOperation';
 export * from './src/billing/planProlongrationPayload';
@@ -7,6 +8,7 @@ export * from './src/base/event/breadcrumb';
 export * from './src/base/event/event';
 export * from './src/base/event/sourceCodeLine';
 export * from './src/base/event/taskManagerItem';
+export * from './src/base/event/trace';
 export * from './src/base/event/addons';
 export * from './src/base/integrations/integrationToken';
 export * from './src/base/project/ProjectTaskManager';

package/build/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src/ai/stream"), exports);
 __exportStar(require("./src/auth/tokensPair"), exports);
 __exportStar(require("./src/base/businessOperation/businessOperation"), exports);
 __exportStar(require("./src/billing/planProlongrationPayload"), exports);
@@ -23,6 +24,7 @@ __exportStar(require("./src/base/event/breadcrumb"), exports);
 __exportStar(require("./src/base/event/event"), exports);
 __exportStar(require("./src/base/event/sourceCodeLine"), exports);
 __exportStar(require("./src/base/event/taskManagerItem"), exports);
+__exportStar(require("./src/base/event/trace"), exports);
 __exportStar(require("./src/base/event/addons"), exports);
 __exportStar(require("./src/base/integrations/integrationToken"), exports);
 __exportStar(require("./src/base/project/ProjectTaskManager"), exports);

package/build/src/ai/stream.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Stream part that carries generated text.
+ */
+export type AiStreamTextDeltaPart = {
+    /**
+     * Discriminant of a text-carrying part.
+     */
+    type: 'text-delta';
+    /**
+     * Text generated for this part.
+     */
+    delta: string;
+};
+/**
+ * Stream part that carries a generation failure.
+ */
+export type AiStreamErrorPart = {
+    /**
+     * Discriminant of a failure-carrying part.
+     */
+    type: 'error';
+    /**
+     * Description of the failure.
+     */
+    errorText: string;
+};
+/**
+ * Discriminated union of parts an AI stream consists of.
+ */
+export type AiStreamPart = AiStreamTextDeltaPart | AiStreamErrorPart;
+/**
+ * Asynchronous sequence of parts forming an AI-generated answer.
+ */
+export type AiStream = AsyncIterable<AiStreamPart>;

package/build/src/ai/stream.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/base/event/event.d.ts

@@ -3,6 +3,7 @@ import type { AffectedUser } from './affectedUser.ts';
 import type { EventAddons } from './addons/index.ts';
 import type { Json } from '../../utils/index.ts';
 import type { Breadcrumb } from './breadcrumb.ts';
+import type { EventTrace } from './trace.ts';
 /**
  * Information about event (Payload of the event)
  * That object will be sent as 'payload' from the Collector to the workers
@@ -45,6 +46,10 @@ export interface EventData<Addons extends EventAddons> {
      * Catcher version
      */
     catcherVersion?: string;
+    /**
+     * Distributed trace metadata for linking related events within the same execution chain.
+     */
+    trace?: EventTrace;
 }
 /**
  * Event data with decoded unsafe fields

package/build/src/base/event/trace.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Distributed trace metadata attached to error and performance events.
+ */
+export interface EventTrace {
+    /**
+     * Shared identifier for events from the same execution chain.
+     */
+    id: string;
+}

package/build/src/base/event/trace.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/base/event/traceContext.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Trace metadata attached to error events for linking related frontend/backend occurrences.
+ */
+export interface TraceContext {
+    /**
+     * Shared identifier for events from the same execution chain.
+     */
+    traceId: string;
+}

package/build/src/base/event/traceContext.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/index.ts

@@ -1,3 +1,5 @@
+export * from './src/ai/stream';
+
 export * from './src/auth/tokensPair';
 
 export * from './src/base/businessOperation/businessOperation';
@@ -10,6 +12,7 @@ export * from './src/base/event/breadcrumb';
 export * from './src/base/event/event';
 export * from './src/base/event/sourceCodeLine';
 export * from './src/base/event/taskManagerItem';
+export * from './src/base/event/trace';
 export * from './src/base/event/addons';
 
 export * from './src/base/integrations/integrationToken';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawk.so/types",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "TypeScript definitions for Hawk",
   "types": "build/index.d.ts",
   "main": "build/index.js",

package/src/ai/stream.ts

@@ -0,0 +1,39 @@
+/**
+ * Stream part that carries generated text.
+ */
+export type AiStreamTextDeltaPart = {
+  /**
+   * Discriminant of a text-carrying part.
+   */
+  type: 'text-delta';
+
+  /**
+   * Text generated for this part.
+   */
+  delta: string;
+};
+
+/**
+ * Stream part that carries a generation failure.
+ */
+export type AiStreamErrorPart = {
+  /**
+   * Discriminant of a failure-carrying part.
+   */
+  type: 'error';
+
+  /**
+   * Description of the failure.
+   */
+  errorText: string;
+};
+
+/**
+ * Discriminated union of parts an AI stream consists of.
+ */
+export type AiStreamPart = AiStreamTextDeltaPart | AiStreamErrorPart;
+
+/**
+ * Asynchronous sequence of parts forming an AI-generated answer.
+ */
+export type AiStream = AsyncIterable<AiStreamPart>;

package/src/base/event/event.ts

@@ -3,6 +3,7 @@ import type { AffectedUser } from './affectedUser.ts';
 import type { EventAddons } from './addons/index.ts';
 import type { Json } from '../../utils/index.ts';
 import type { Breadcrumb } from './breadcrumb.ts';
+import type { EventTrace } from './trace.ts';
 
 /**
  * Information about event (Payload of the event)
@@ -54,6 +55,11 @@ export interface EventData<Addons extends EventAddons> {
    * Catcher version
    */
   catcherVersion?: string;
+
+  /**
+   * Distributed trace metadata for linking related events within the same execution chain.
+   */
+  trace?: EventTrace;
 }
 
 /**

package/src/base/event/trace.ts

@@ -0,0 +1,9 @@
+/**
+ * Distributed trace metadata attached to error and performance events.
+ */
+export interface EventTrace {
+  /**
+   * Shared identifier for events from the same execution chain.
+   */
+  id: string;
+}

package/tsconfig.json

@@ -2,7 +2,7 @@
   "compilerOptions": {
     /* Basic Options */
     // "incremental": true,                   /* Enable incremental compilation */
-    "target": "es6",                          /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', or 'ESNEXT'. */
+    "target": "es2018",                       /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', 'ES2021', 'ES2022', 'ES2023', 'ES2024', or 'ESNEXT'. */
     "module": "commonjs",                     /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */
     // "lib": [],                             /* Specify library files to be included in the compilation. */
     // "allowJs": true,                       /* Allow javascript files to be compiled. */