@boboddy/sdk 0.0.7-alpha

package/dist/apps/api/src/problem-details.d.ts

@@ -0,0 +1,9 @@
+import type { ApiErrorResponse } from "./contracts";
+type ElysiaErrorCode = "UNKNOWN" | "VALIDATION" | "NOT_FOUND" | "PARSE" | "INTERNAL_SERVER_ERROR" | "INVALID_COOKIE_SIGNATURE" | "INVALID_FILE_TYPE" | (string & {}) | number;
+type ProblemDetailsOptions = {
+    code: ElysiaErrorCode;
+    error: unknown;
+    request: Request;
+};
+export declare function createProblemDetails({ code, error, request, }: ProblemDetailsOptions): ApiErrorResponse;
+export {};

package/dist/index.js

@@ -0,0 +1,62 @@
+// src/treaty.ts
+import { treaty } from "@elysiajs/eden";
+var TRAILING_SLASHES_PATTERN = /\/+$/u;
+var API_SUFFIX_PATTERN = /\/api$/u;
+var normalizeBoboddyBaseUrl = (baseUrl) => {
+  const trimmedBaseUrl = baseUrl.trim();
+  if (trimmedBaseUrl.length === 0) {
+    return "";
+  }
+  return trimmedBaseUrl.replace(TRAILING_SLASHES_PATTERN, "").replace(API_SUFFIX_PATTERN, "");
+};
+function createBoboddyTreaty(baseUrlOrApp) {
+  if (typeof baseUrlOrApp === "string") {
+    return treaty(normalizeBoboddyBaseUrl(baseUrlOrApp), {
+      parseDate: false
+    });
+  }
+  return treaty(baseUrlOrApp, {
+    parseDate: false
+  });
+}
+var unwrapTreatyResponse = async (promise) => {
+  const { data, error } = await promise;
+  if (error) {
+    throw error.value;
+  }
+  return data;
+};
+var createBoboddyApiClient = createBoboddyTreaty;
+// src/step-execution-plane-client.ts
+function createStepExecutionPlaneClient(baseUrlOrApp) {
+  return buildStepExecutionPlaneClient(createBoboddyTreaty(baseUrlOrApp));
+}
+var buildStepExecutionPlaneClient = (apiClient) => {
+  return {
+    claimStepExecutions: async (body, options) => await unwrapTreatyResponse(apiClient.api["step-executions"].claims.post(body, options)),
+    heartbeatStepExecution: async (stepExecutionId, body, options) => await unwrapTreatyResponse(apiClient.api["step-executions"]({
+      stepExecutionId
+    }).heartbeat.put(body, options)),
+    getStepExecution: async (stepExecutionId, options) => await unwrapTreatyResponse(apiClient.api["step-executions"]({
+      stepExecutionId
+    }).get(options)),
+    getStepExecutionWorkerContext: async (stepExecutionId, body, options) => await unwrapTreatyResponse(apiClient.api["step-executions"]({
+      stepExecutionId
+    })["worker-context"].post(body, options)),
+    completeStepExecution: async (stepExecutionId, body, options) => await unwrapTreatyResponse(apiClient.api["step-executions"]({
+      stepExecutionId
+    }).completions.post(body, options)),
+    failStepExecution: async (stepExecutionId, body, options) => await unwrapTreatyResponse(apiClient.api["step-executions"]({
+      stepExecutionId
+    }).completions.post({
+      ...body,
+      status: "failed"
+    }, options))
+  };
+};
+export {
+  unwrapTreatyResponse,
+  createStepExecutionPlaneClient,
+  createBoboddyTreaty,
+  createBoboddyApiClient
+};

package/dist/packages/sdks/js/script/build.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/packages/sdks/js/src/client.d.ts

@@ -0,0 +1,2 @@
+export * from "./treaty";
+export * from "./step-execution-plane-client";

package/dist/packages/sdks/js/src/index.d.ts

@@ -0,0 +1 @@
+export * from "./client";

package/dist/packages/sdks/js/src/step-execution-plane-client.d.ts

@@ -0,0 +1,369 @@
+import type { App } from "@boboddy/api/app";
+import { createBoboddyTreaty } from "./treaty";
+type JsonValue = string | number | boolean | null | {
+    [key: string]: JsonValue;
+} | JsonValue[];
+type RequestOptions = {
+    headers?: Record<string, unknown> | undefined;
+};
+export declare function createStepExecutionPlaneClient(baseUrlOrApp: string | App): ReturnType<typeof buildStepExecutionPlaneClient>;
+declare const buildStepExecutionPlaneClient: (apiClient: ReturnType<typeof createBoboddyTreaty>) => {
+    claimStepExecutions: (body: {
+        projectId: string;
+        workerId: string;
+        batchSize: number;
+        leaseDurationSeconds: number;
+    }, options?: RequestOptions) => Promise<{
+        stepExecution: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            projectId: string & {
+                readonly __brand: "uuidv7";
+            };
+            stepDefinitionId: string & {
+                readonly __brand: "uuidv7";
+            };
+            stepDefinitionVersion: number;
+            status: "queued" | "running" | "succeeded" | "failed" | "cancelled" | "skipped" | "timeout" | "abandoned";
+            inputJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            claimedBy: string | null;
+            claimedAt: string | null;
+            lastHeartbeatAt: string | null;
+            leaseExpiresAt: string | null;
+            executionTimeoutSeconds: number | null;
+            executionDeadlineAt: string | null;
+            startedAt: string | null;
+            completedAt: string | null;
+            results: {
+                id: string & {
+                    readonly __brand: "uuidv7";
+                };
+                stepExecutionId: string & {
+                    readonly __brand: "uuidv7";
+                };
+                attempt: number;
+                status: "succeeded" | "failed";
+                resultJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+                errorJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+                signals: {
+                    id: string & {
+                        readonly __brand: "uuidv7";
+                    };
+                    stepExecutionResultId: string & {
+                        readonly __brand: "uuidv7";
+                    };
+                    key: string;
+                    type: "string" | "number" | "boolean" | "object" | "array";
+                    source: "extracted" | "computed";
+                    valueJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+                    sourcePath: string | null;
+                    computedFromSignalKeys: string[] | null;
+                    createdAt: string;
+                }[];
+                createdAt: string;
+            }[];
+            createdAt: string;
+            updatedAt: string;
+        };
+        claimToken: string;
+    }[]>;
+    heartbeatStepExecution: (stepExecutionId: string, body: {
+        claimToken: string;
+        leaseDurationSeconds: number;
+    }, options?: RequestOptions) => Promise<{
+        id: string & {
+            readonly __brand: "uuidv7";
+        };
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionVersion: number;
+        status: "queued" | "running" | "succeeded" | "failed" | "cancelled" | "skipped" | "timeout" | "abandoned";
+        inputJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+        claimedBy: string | null;
+        claimedAt: string | null;
+        lastHeartbeatAt: string | null;
+        leaseExpiresAt: string | null;
+        executionTimeoutSeconds: number | null;
+        executionDeadlineAt: string | null;
+        startedAt: string | null;
+        completedAt: string | null;
+        results: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            stepExecutionId: string & {
+                readonly __brand: "uuidv7";
+            };
+            attempt: number;
+            status: "succeeded" | "failed";
+            resultJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            errorJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            signals: {
+                id: string & {
+                    readonly __brand: "uuidv7";
+                };
+                stepExecutionResultId: string & {
+                    readonly __brand: "uuidv7";
+                };
+                key: string;
+                type: "string" | "number" | "boolean" | "object" | "array";
+                source: "extracted" | "computed";
+                valueJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+                sourcePath: string | null;
+                computedFromSignalKeys: string[] | null;
+                createdAt: string;
+            }[];
+            createdAt: string;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    getStepExecution: (stepExecutionId: string, options?: RequestOptions) => Promise<{
+        id: string & {
+            readonly __brand: "uuidv7";
+        };
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionVersion: number;
+        status: "queued" | "running" | "succeeded" | "failed" | "cancelled" | "skipped" | "timeout" | "abandoned";
+        inputJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+        claimedBy: string | null;
+        claimedAt: string | null;
+        lastHeartbeatAt: string | null;
+        leaseExpiresAt: string | null;
+        executionTimeoutSeconds: number | null;
+        executionDeadlineAt: string | null;
+        startedAt: string | null;
+        completedAt: string | null;
+        results: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            stepExecutionId: string & {
+                readonly __brand: "uuidv7";
+            };
+            attempt: number;
+            status: "succeeded" | "failed";
+            resultJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            errorJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            signals: {
+                id: string & {
+                    readonly __brand: "uuidv7";
+                };
+                stepExecutionResultId: string & {
+                    readonly __brand: "uuidv7";
+                };
+                key: string;
+                type: "string" | "number" | "boolean" | "object" | "array";
+                source: "extracted" | "computed";
+                valueJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+                sourcePath: string | null;
+                computedFromSignalKeys: string[] | null;
+                createdAt: string;
+            }[];
+            createdAt: string;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    getStepExecutionWorkerContext: (stepExecutionId: string, body: {
+        claimToken: string;
+    }, options?: RequestOptions) => Promise<{
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        gitUrl: string;
+        requestedBranch: string | null;
+        projectOpencodeConfig: {
+            relativePath: string;
+            present: boolean;
+            commands: {
+                name: string;
+                description: string;
+                run: string;
+                cwd: string | null;
+            }[];
+            services: {
+                name: string;
+                description: string;
+                run: string;
+                cwd: string | null;
+                dependsOn: string[];
+                expose: {
+                    targetPort: number;
+                    protocol: "tcp" | "http";
+                };
+                healthcheck: {
+                    protocol: "tcp" | "http";
+                    path: string | null;
+                    expectedStatus: number | null;
+                };
+            }[];
+        };
+        stepExecution: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            status: "queued" | "running" | "succeeded" | "failed" | "cancelled" | "skipped" | "timeout" | "abandoned";
+            inputJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            executionTimeoutSeconds: number | null;
+        };
+        stepDefinition: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            key: string;
+            name: string;
+            prompt: string;
+            resultSchemaJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+            opencodeMcpJson: Record<string, {
+                type: "local";
+                command: string[];
+                environment?: Record<string, string> | undefined;
+                enabled?: boolean | undefined;
+                timeout?: number | undefined;
+            } | {
+                type: "remote";
+                url: string;
+                enabled?: boolean | undefined;
+                headers?: Record<string, string> | undefined;
+                oauth?: false | {
+                    clientId?: string | undefined;
+                    clientSecret?: string | undefined;
+                    scope?: string | undefined;
+                    redirectUri?: string | undefined;
+                } | undefined;
+                timeout?: number | undefined;
+            } | {
+                enabled: boolean;
+            }> | null;
+        };
+        agentPrompt: {
+            sessionTitle: string;
+            promptText: string;
+        };
+    }>;
+    completeStepExecution: (stepExecutionId: string, body: {
+        claimToken: string;
+        status: "succeeded" | "failed";
+        resultJson: JsonValue;
+        errorJson: JsonValue;
+    }, options?: RequestOptions) => Promise<{
+        id: string & {
+            readonly __brand: "uuidv7";
+        };
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionVersion: number;
+        status: "queued" | "running" | "succeeded" | "failed" | "cancelled" | "skipped" | "timeout" | "abandoned";
+        inputJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+        claimedBy: string | null;
+        claimedAt: string | null;
+        lastHeartbeatAt: string | null;
+        leaseExpiresAt: string | null;
+        executionTimeoutSeconds: number | null;
+        executionDeadlineAt: string | null;
+        startedAt: string | null;
+        completedAt: string | null;
+        results: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            stepExecutionId: string & {
+                readonly __brand: "uuidv7";
+            };
+            attempt: number;
+            status: "succeeded" | "failed";
+            resultJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            errorJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            signals: {
+                id: string & {
+                    readonly __brand: "uuidv7";
+                };
+                stepExecutionResultId: string & {
+                    readonly __brand: "uuidv7";
+                };
+                key: string;
+                type: "string" | "number" | "boolean" | "object" | "array";
+                source: "extracted" | "computed";
+                valueJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+                sourcePath: string | null;
+                computedFromSignalKeys: string[] | null;
+                createdAt: string;
+            }[];
+            createdAt: string;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    failStepExecution: (stepExecutionId: string, body: {
+        claimToken: string;
+        resultJson: JsonValue;
+        errorJson: JsonValue;
+    }, options?: RequestOptions) => Promise<{
+        id: string & {
+            readonly __brand: "uuidv7";
+        };
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionId: string & {
+            readonly __brand: "uuidv7";
+        };
+        stepDefinitionVersion: number;
+        status: "queued" | "running" | "succeeded" | "failed" | "cancelled" | "skipped" | "timeout" | "abandoned";
+        inputJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+        claimedBy: string | null;
+        claimedAt: string | null;
+        lastHeartbeatAt: string | null;
+        leaseExpiresAt: string | null;
+        executionTimeoutSeconds: number | null;
+        executionDeadlineAt: string | null;
+        startedAt: string | null;
+        completedAt: string | null;
+        results: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            stepExecutionId: string & {
+                readonly __brand: "uuidv7";
+            };
+            attempt: number;
+            status: "succeeded" | "failed";
+            resultJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            errorJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+            signals: {
+                id: string & {
+                    readonly __brand: "uuidv7";
+                };
+                stepExecutionResultId: string & {
+                    readonly __brand: "uuidv7";
+                };
+                key: string;
+                type: "string" | "number" | "boolean" | "object" | "array";
+                source: "extracted" | "computed";
+                valueJson: import("@boboddy/core/common/contracts/json").AnyJsonValue;
+                sourcePath: string | null;
+                computedFromSignalKeys: string[] | null;
+                createdAt: string;
+            }[];
+            createdAt: string;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+};
+export {};

package/dist/packages/sdks/js/src/treaty.d.ts

@@ -0,0 +1,13 @@
+import { treaty } from "@elysiajs/eden";
+import type { App } from "@boboddy/api/app";
+export declare function createBoboddyTreaty(baseUrlOrApp: string | App): ReturnType<typeof treaty<App>>;
+export type BoboddyTreaty = ReturnType<typeof createBoboddyTreaty>;
+type EdenResult<T> = {
+    data: T | null | undefined;
+    error: {
+        value: unknown;
+    } | null | undefined;
+};
+export declare const unwrapTreatyResponse: <T>(promise: Promise<EdenResult<T>>) => Promise<T>;
+export declare const createBoboddyApiClient: typeof createBoboddyTreaty;
+export {};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@boboddy/sdk",
+  "version": "0.0.7-alpha",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/client.js",
+      "types": "./dist/client.d.ts"
+    },
+    "./treaty": {
+      "import": "./dist/treaty.js",
+      "types": "./dist/treaty.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun run script/build.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@elysiajs/eden": "^1.4.9"
+  },
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.90.10",
+    "bun-types": "^1.3.12"
+  }
+}