@voyantjs/workflows-react 0.66.6 → 0.69.0

package/dist/workflow-schedules-client.d.ts

@@ -0,0 +1,58 @@
+export interface WorkflowScheduleDecl {
+    cron?: string;
+    every?: string | number;
+    at?: string;
+    timezone?: string;
+    enabled?: boolean;
+    overlap?: "skip" | "queue" | "allow";
+    environments?: ("production" | "preview" | "development")[];
+    name?: string;
+    input?: unknown;
+}
+export interface WorkflowScheduleSummary {
+    workflowId: string;
+    scheduleId: string;
+    schedule: WorkflowScheduleDecl;
+    /** Epoch millis of the next computed fire, or null when undecidable. */
+    nextRunAt: number | null;
+    enabled: boolean;
+    disabledReason?: "registration_disabled" | "env_filtered";
+}
+export interface ListWorkflowSchedulesResponse {
+    environment: string;
+    versionId: string;
+    schedulesEnabledByEnv?: boolean;
+    data: WorkflowScheduleSummary[];
+}
+export interface WorkflowSchedulesApi {
+    listSchedules(environment: string): Promise<ListWorkflowSchedulesResponse>;
+}
+export type WorkflowSchedulesFetcher = (input: string, init?: RequestInit) => Promise<Response>;
+export interface WorkflowSchedulesApiClientOptions {
+    /** Base URL for the orchestrator. Defaults to the current origin. */
+    apiBase?: string;
+    baseUrl?: string;
+    fetcher?: WorkflowSchedulesFetcher;
+    credentials?: RequestCredentials;
+    headers?: HeadersInit;
+}
+export interface WorkflowSchedulesClientOptions {
+    baseUrl: string;
+    fetcher: WorkflowSchedulesFetcher;
+    credentials?: RequestCredentials;
+    headers?: HeadersInit;
+}
+export declare class WorkflowSchedulesApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export declare const defaultWorkflowSchedulesFetcher: WorkflowSchedulesFetcher;
+export declare const workflowSchedulesQueryKeys: {
+    readonly all: readonly ["voyant", "workflow-schedules"];
+    readonly list: (environment: string) => readonly ["voyant", "workflow-schedules", "list", string];
+};
+export declare function createWorkflowSchedulesClientOptions(client?: Partial<WorkflowSchedulesClientOptions>): WorkflowSchedulesClientOptions;
+export declare function createWorkflowSchedulesApiClient(options?: WorkflowSchedulesApiClientOptions): WorkflowSchedulesApi;
+export declare function listWorkflowSchedules(environment: string, client?: WorkflowSchedulesClientOptions): Promise<ListWorkflowSchedulesResponse>;
+//# sourceMappingURL=workflow-schedules-client.d.ts.map

package/dist/workflow-schedules-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-schedules-client.d.ts","sourceRoot":"","sources":["../src/workflow-schedules-client.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;IACpC,YAAY,CAAC,EAAE,CAAC,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC,EAAE,CAAA;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,CAAC,EAAE,uBAAuB,GAAG,cAAc,CAAA;CAC1D;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,IAAI,EAAE,uBAAuB,EAAE,CAAA;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAA;CAC3E;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE/F,MAAM,WAAW,iCAAiC;IAChD,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,wBAAwB,CAAA;IACjC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AAED,eAAO,MAAM,+BAA+B,EAAE,wBAC1B,CAAA;AAEpB,eAAO,MAAM,0BAA0B;;iCAEjB,MAAM;CAClB,CAAA;AAEV,wBAAgB,oCAAoC,CAClD,MAAM,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAC/C,8BAA8B,CAOhC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,oBAAoB,CAWtB;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,8BAAuE,GAC9E,OAAO,CAAC,6BAA6B,CAAC,CAYxC"}

package/dist/workflow-schedules-client.js

@@ -0,0 +1,91 @@
+// Client for the orchestrator's `/api/schedules/:env` aggregate view.
+// Mirrors `workflow-runs-client.ts` so the workflow-schedules UI can be
+// pointed at any worker that exposes `@voyantjs/workflows-orchestrator-cloudflare`'s
+// schedules handler.
+export class WorkflowSchedulesApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "WorkflowSchedulesApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+export const defaultWorkflowSchedulesFetcher = (input, init) => fetch(input, init);
+export const workflowSchedulesQueryKeys = {
+    all: ["voyant", "workflow-schedules"],
+    list: (environment) => [...workflowSchedulesQueryKeys.all, "list", environment],
+};
+export function createWorkflowSchedulesClientOptions(client) {
+    return {
+        baseUrl: client?.baseUrl ?? "",
+        fetcher: client?.fetcher ?? defaultWorkflowSchedulesFetcher,
+        credentials: client?.credentials,
+        headers: client?.headers,
+    };
+}
+export function createWorkflowSchedulesApiClient(options = {}) {
+    const client = createWorkflowSchedulesClientOptions({
+        baseUrl: options.baseUrl ?? options.apiBase ?? "",
+        fetcher: options.fetcher,
+        credentials: options.credentials ?? "include",
+        headers: options.headers,
+    });
+    return {
+        listSchedules: (environment) => listWorkflowSchedules(environment, client),
+    };
+}
+export async function listWorkflowSchedules(environment, client = createWorkflowSchedulesClientOptions()) {
+    const path = `/api/schedules/${encodeURIComponent(environment)}`;
+    const response = await request(path, { method: "GET" }, client);
+    const body = await safeJson(response);
+    if (!response.ok) {
+        throw new WorkflowSchedulesApiError(extractErrorMessage(response.status, response.statusText, body), response.status, body);
+    }
+    return body;
+}
+async function request(path, init, client) {
+    const headers = new Headers(client.headers);
+    for (const [key, value] of new Headers(init.headers).entries()) {
+        headers.set(key, value);
+    }
+    const requestInit = { ...init, headers };
+    if (client.credentials !== undefined) {
+        requestInit.credentials = client.credentials;
+    }
+    return client.fetcher(joinUrl(client.baseUrl, path), requestInit);
+}
+async function safeJson(response) {
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function extractErrorMessage(status, statusText, body) {
+    if (typeof body === "object" && body !== null) {
+        if ("error" in body && typeof body.error === "string")
+            return body.error;
+        if ("message" in body && typeof body.message === "string")
+            return body.message;
+    }
+    return `Workflow schedules API error: ${status} ${statusText}`;
+}
+function joinUrl(baseUrl, path) {
+    const resolved = resolveBaseUrl(baseUrl);
+    const trimmedBase = resolved.endsWith("/") ? resolved.slice(0, -1) : resolved;
+    const trimmedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${trimmedBase}${trimmedPath}`;
+}
+function resolveBaseUrl(baseUrl) {
+    if (baseUrl.trim())
+        return baseUrl;
+    if (typeof window !== "undefined")
+        return window.location.origin;
+    return "http://localhost:8787";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/workflows-react",
-  "version": "0.66.6",
+  "version": "0.69.0",
   "description": "React hooks for Voyant Workflows — trigger, subscribe, and stream runs.",
   "license": "Apache-2.0",
   "repository": {
@@ -25,6 +25,11 @@
       "types": "./dist/workflow-runs-client.d.ts",
       "import": "./dist/workflow-runs-client.js",
       "default": "./dist/workflow-runs-client.js"
+    },
+    "./workflow-schedules-client": {
+      "types": "./dist/workflow-schedules-client.d.ts",
+      "import": "./dist/workflow-schedules-client.js",
+      "default": "./dist/workflow-schedules-client.js"
     }
   },
   "main": "./dist/index.js",
@@ -37,8 +42,8 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@voyantjs/react": "0.66.6",
-    "@voyantjs/workflows": "0.66.6"
+    "@voyantjs/react": "0.69.0",
+    "@voyantjs/workflows": "0.69.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
@@ -53,7 +58,7 @@
     "react-dom": "^19.2.4",
     "typescript": "^5.9.2",
     "vitest": "^4.1.2",
-    "@voyantjs/react": "0.66.6",
+    "@voyantjs/react": "0.69.0",
     "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "publishConfig": {

package/src/workflow-schedules-client.ts

@@ -0,0 +1,165 @@
+// Client for the orchestrator's `/api/schedules/:env` aggregate view.
+// Mirrors `workflow-runs-client.ts` so the workflow-schedules UI can be
+// pointed at any worker that exposes `@voyantjs/workflows-orchestrator-cloudflare`'s
+// schedules handler.
+
+export interface WorkflowScheduleDecl {
+  cron?: string
+  every?: string | number
+  at?: string
+  timezone?: string
+  enabled?: boolean
+  overlap?: "skip" | "queue" | "allow"
+  environments?: ("production" | "preview" | "development")[]
+  name?: string
+  input?: unknown
+}
+
+export interface WorkflowScheduleSummary {
+  workflowId: string
+  scheduleId: string
+  schedule: WorkflowScheduleDecl
+  /** Epoch millis of the next computed fire, or null when undecidable. */
+  nextRunAt: number | null
+  enabled: boolean
+  disabledReason?: "registration_disabled" | "env_filtered"
+}
+
+export interface ListWorkflowSchedulesResponse {
+  environment: string
+  versionId: string
+  schedulesEnabledByEnv?: boolean
+  data: WorkflowScheduleSummary[]
+}
+
+export interface WorkflowSchedulesApi {
+  listSchedules(environment: string): Promise<ListWorkflowSchedulesResponse>
+}
+
+export type WorkflowSchedulesFetcher = (input: string, init?: RequestInit) => Promise<Response>
+
+export interface WorkflowSchedulesApiClientOptions {
+  /** Base URL for the orchestrator. Defaults to the current origin. */
+  apiBase?: string
+  baseUrl?: string
+  fetcher?: WorkflowSchedulesFetcher
+  credentials?: RequestCredentials
+  headers?: HeadersInit
+}
+
+export interface WorkflowSchedulesClientOptions {
+  baseUrl: string
+  fetcher: WorkflowSchedulesFetcher
+  credentials?: RequestCredentials
+  headers?: HeadersInit
+}
+
+export class WorkflowSchedulesApiError extends Error {
+  readonly status: number
+  readonly body: unknown
+
+  constructor(message: string, status: number, body: unknown) {
+    super(message)
+    this.name = "WorkflowSchedulesApiError"
+    this.status = status
+    this.body = body
+  }
+}
+
+export const defaultWorkflowSchedulesFetcher: WorkflowSchedulesFetcher = (input, init) =>
+  fetch(input, init)
+
+export const workflowSchedulesQueryKeys = {
+  all: ["voyant", "workflow-schedules"] as const,
+  list: (environment: string) => [...workflowSchedulesQueryKeys.all, "list", environment] as const,
+} as const
+
+export function createWorkflowSchedulesClientOptions(
+  client?: Partial<WorkflowSchedulesClientOptions>,
+): WorkflowSchedulesClientOptions {
+  return {
+    baseUrl: client?.baseUrl ?? "",
+    fetcher: client?.fetcher ?? defaultWorkflowSchedulesFetcher,
+    credentials: client?.credentials,
+    headers: client?.headers,
+  }
+}
+
+export function createWorkflowSchedulesApiClient(
+  options: WorkflowSchedulesApiClientOptions = {},
+): WorkflowSchedulesApi {
+  const client = createWorkflowSchedulesClientOptions({
+    baseUrl: options.baseUrl ?? options.apiBase ?? "",
+    fetcher: options.fetcher,
+    credentials: options.credentials ?? "include",
+    headers: options.headers,
+  })
+
+  return {
+    listSchedules: (environment) => listWorkflowSchedules(environment, client),
+  }
+}
+
+export async function listWorkflowSchedules(
+  environment: string,
+  client: WorkflowSchedulesClientOptions = createWorkflowSchedulesClientOptions(),
+): Promise<ListWorkflowSchedulesResponse> {
+  const path = `/api/schedules/${encodeURIComponent(environment)}`
+  const response = await request(path, { method: "GET" }, client)
+  const body = await safeJson(response)
+  if (!response.ok) {
+    throw new WorkflowSchedulesApiError(
+      extractErrorMessage(response.status, response.statusText, body),
+      response.status,
+      body,
+    )
+  }
+  return body as ListWorkflowSchedulesResponse
+}
+
+async function request(
+  path: string,
+  init: RequestInit,
+  client: WorkflowSchedulesClientOptions,
+): Promise<Response> {
+  const headers = new Headers(client.headers)
+  for (const [key, value] of new Headers(init.headers).entries()) {
+    headers.set(key, value)
+  }
+  const requestInit: RequestInit = { ...init, headers }
+  if (client.credentials !== undefined) {
+    requestInit.credentials = client.credentials
+  }
+  return client.fetcher(joinUrl(client.baseUrl, path), requestInit)
+}
+
+async function safeJson(response: Response): Promise<unknown> {
+  const text = await response.text()
+  if (!text) return undefined
+  try {
+    return JSON.parse(text)
+  } catch {
+    return text
+  }
+}
+
+function extractErrorMessage(status: number, statusText: string, body: unknown): string {
+  if (typeof body === "object" && body !== null) {
+    if ("error" in body && typeof body.error === "string") return body.error
+    if ("message" in body && typeof body.message === "string") return body.message
+  }
+  return `Workflow schedules API error: ${status} ${statusText}`
+}
+
+function joinUrl(baseUrl: string, path: string): string {
+  const resolved = resolveBaseUrl(baseUrl)
+  const trimmedBase = resolved.endsWith("/") ? resolved.slice(0, -1) : resolved
+  const trimmedPath = path.startsWith("/") ? path : `/${path}`
+  return `${trimmedBase}${trimmedPath}`
+}
+
+function resolveBaseUrl(baseUrl: string): string {
+  if (baseUrl.trim()) return baseUrl
+  if (typeof window !== "undefined") return window.location.origin
+  return "http://localhost:8787"
+}