@griffin-app/griffin-executor 0.1.0

package/src/types.ts

@@ -0,0 +1,114 @@
+import type { ExecutionEventEmitter } from "./events/index.js";
+import type { SecretProvider } from "./secrets/index.js";
+
+export const START = "__START__" as const;
+export const END = "__END__" as const;
+
+export type JSONValue =
+  | string
+  | number
+  | boolean
+  | null
+  | { [key: string]: JSONValue }
+  | JSONValue[];
+
+/**
+ * Complete response data from an endpoint execution
+ */
+export interface NodeResponseData {
+  body: JSONValue;
+  headers: Record<string, string>;
+  status: number;
+  duration_ms: number;
+}
+
+export interface HttpRequest {
+  method: string;
+  url: string;
+  headers?: Record<string, string>;
+  body?: unknown;
+  timeout?: number;
+}
+
+export interface HttpResponse {
+  status: number;
+  statusText: string;
+  data: unknown;
+  headers?: Record<string, string>;
+}
+
+export interface HttpClientAdapter {
+  request(req: HttpRequest): Promise<HttpResponse>;
+}
+
+/**
+ * Status update payload for run tracking.
+ */
+export interface RunStatusUpdate {
+  status: "running" | "completed" | "failed";
+  completedAt?: string;
+  duration_ms?: number;
+  success?: boolean;
+  errors?: string[];
+}
+
+/**
+ * Callbacks for tracking execution status (typically for updating a run record).
+ */
+export interface StatusCallbacks {
+  /**
+   * Called when monitor execution starts (after secret resolution, before graph execution).
+   */
+  onStart?: () => Promise<void>;
+
+  /**
+   * Called when monitor execution completes (success or failure).
+   */
+  onComplete?: (update: RunStatusUpdate) => Promise<void>;
+}
+
+export interface ExecutionOptions {
+  mode: "local" | "remote";
+  timeout?: number;
+  httpClient: HttpClientAdapter;
+
+  /** Optional event emitter for execution observability */
+  eventEmitter?: ExecutionEventEmitter;
+
+  /** Unique execution ID for correlating events (generated if not provided) */
+  executionId?: string;
+
+  secretProvider: SecretProvider | null;
+
+  /** Optional callbacks for tracking execution status (e.g., updating run records) */
+  statusCallbacks?: StatusCallbacks;
+}
+
+export interface NodeResult {
+  nodeId: string;
+  success: boolean;
+  response?: JSONValue;
+  error?: string;
+  duration_ms: number;
+}
+
+export interface ExecutionResult {
+  success: boolean;
+  results: NodeResult[];
+  errors: string[];
+  totalDuration_ms: number;
+}
+
+export interface HttpRequestResult {
+  success: boolean;
+  response?: JSONValue;
+  headers?: Record<string, string>;
+  status?: number;
+  error?: string;
+  duration_ms: number;
+}
+
+export interface WaitResult {
+  success: boolean;
+  duration_ms: number;
+}

package/src/utils/dates.ts

@@ -0,0 +1,13 @@
+/**
+ * Date utility functions for consistent UTC handling.
+ *
+ * All dates should be stored and transmitted as UTC (ISO 8601 strings with Z suffix).
+ */
+
+/**
+ * Get the current time as a UTC ISO 8601 string.
+ * @returns ISO 8601 string with Z suffix (e.g., "2024-01-23T12:34:56.789Z")
+ */
+export function utcNow(): string {
+  return new Date().toISOString();
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "bundler"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: "node",
+    include: ["src/**/*.{test,spec}.ts"],
+    coverage: {
+      provider: "v8",
+      reporter: ["text", "json", "html"],
+      exclude: ["node_modules/", "dist/", "**/*.d.ts", "**/*.config.*"],
+    },
+  },
+});