veryfront 0.1.74 → 0.1.76

package/esm/src/jobs/jobs-client.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Jobs client SDK for project-scoped background execution.
+ *
+ * Provides a stable public client for one-off jobs, cron jobs, job batches,
+ * and job target discovery on the Veryfront Jobs API.
+ */
+import { type RetryConfig } from "../platform/adapters/veryfront-api-client/retry-handler.js";
+import { type CronJob, type CronJobStatus, type Job, type JobBatch, type JobEventsResponse, type JobLogsResponse, type JobStatus, type JobTargetDefinition, type JobTargetDefinitionsResponse, type PaginatedCronJobsResponse, type PaginatedJobsResponse } from "./schemas.js";
+export interface VeryfrontJobsClientConfig {
+    apiUrl?: string;
+    authToken?: string;
+    projectReference?: string;
+    retry?: Partial<RetryConfig>;
+}
+export interface ProjectScopedOptions {
+    projectReference?: string;
+}
+export interface ListJobsOptions extends ProjectScopedOptions {
+    cursor?: string;
+    limit?: number;
+    status?: JobStatus;
+    cronJobId?: string;
+    environmentId?: string;
+    batchId?: string;
+}
+export interface ListJobEventsOptions extends ProjectScopedOptions {
+    cursor?: string;
+    limit?: number;
+    direction?: "forward" | "backward";
+}
+export interface CreateJobInput extends ProjectScopedOptions {
+    name: string;
+    target: string;
+    environmentId?: string;
+    batchId?: string;
+    config?: Record<string, unknown>;
+    timeoutSeconds?: number;
+    backoffLimit?: number;
+}
+export interface ListBatchJobsOptions extends ProjectScopedOptions {
+    cursor?: string;
+    limit?: number;
+    status?: JobStatus;
+}
+export interface CreateCronJobInput extends ProjectScopedOptions {
+    name: string;
+    target: string;
+    environmentId?: string;
+    schedule: string;
+    timezone?: string;
+    config?: Record<string, unknown>;
+    timeoutSeconds?: number;
+    backoffLimit?: number;
+    concurrencyPolicy?: "Allow" | "Forbid" | "Replace";
+}
+export interface ListCronJobsOptions extends ProjectScopedOptions {
+    cursor?: string;
+    limit?: number;
+    status?: CronJobStatus;
+    environmentId?: string;
+}
+export interface UpdateCronJobInput extends ProjectScopedOptions {
+    name?: string;
+    schedule?: string;
+    timezone?: string;
+    config?: Record<string, unknown>;
+    timeoutSeconds?: number;
+    backoffLimit?: number;
+    concurrencyPolicy?: "Allow" | "Forbid" | "Replace";
+    status?: "active" | "paused";
+}
+type NamespaceMethod<TArgs extends unknown[], TResult> = (...args: TArgs) => Promise<TResult>;
+export declare class VeryfrontJobsClient {
+    private readonly config;
+    private readonly retryConfig;
+    private requestToken?;
+    private requestProjectReference?;
+    readonly cron: {
+        create: NamespaceMethod<[CreateCronJobInput], CronJob>;
+        list: NamespaceMethod<[ListCronJobsOptions?], PaginatedCronJobsResponse>;
+        get: NamespaceMethod<[cronJobId: string, options?: ProjectScopedOptions], CronJob>;
+        update: NamespaceMethod<[cronJobId: string, input: UpdateCronJobInput], CronJob>;
+        delete: NamespaceMethod<[cronJobId: string, options?: ProjectScopedOptions], CronJob>;
+        trigger: NamespaceMethod<[cronJobId: string, options?: ProjectScopedOptions], Job>;
+    };
+    readonly batches: {
+        get: NamespaceMethod<[batchId: string, options?: ProjectScopedOptions], JobBatch>;
+        listJobs: NamespaceMethod<[
+            batchId: string,
+            options?: ListBatchJobsOptions
+        ], PaginatedJobsResponse>;
+    };
+    readonly targets: {
+        list: NamespaceMethod<[options?: ProjectScopedOptions], JobTargetDefinitionsResponse>;
+        get: NamespaceMethod<[target: string, options?: ProjectScopedOptions], JobTargetDefinition>;
+    };
+    constructor(config?: VeryfrontJobsClientConfig);
+    setRequestToken(token: string): void;
+    clearRequestToken(): void;
+    setProjectReference(projectReference: string): void;
+    getProjectReference(): string | undefined;
+    clearProjectReference(): void;
+    create(input: CreateJobInput): Promise<Job>;
+    list(options?: ListJobsOptions): Promise<PaginatedJobsResponse>;
+    get(jobId: string, options?: ProjectScopedOptions): Promise<Job>;
+    /**
+     * Canonical user-visible operational output for a job.
+     * Prefer this over raw logs for status, progress, and per-file activity.
+     */
+    events(jobId: string, options?: ListJobEventsOptions): Promise<JobEventsResponse>;
+    /**
+     * Raw debugging output for a job.
+     * This is secondary to `events()` for operational UX.
+     */
+    logs(jobId: string, options?: ProjectScopedOptions): Promise<JobLogsResponse>;
+    cancel(jobId: string, options?: ProjectScopedOptions): Promise<Job>;
+    private createCronJob;
+    private listCronJobs;
+    private getCronJob;
+    private updateCronJob;
+    private deleteCronJob;
+    private triggerCronJob;
+    private getBatch;
+    private listBatchJobs;
+    private listTargets;
+    private getTarget;
+    private resolveApiUrl;
+    private resolveAuthToken;
+    private resolveProjectReference;
+    private requestProjectJson;
+}
+export declare function createJobsClient(config?: VeryfrontJobsClientConfig): VeryfrontJobsClient;
+export {};
+//# sourceMappingURL=jobs-client.d.ts.map

package/esm/src/jobs/jobs-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs-client.d.ts","sourceRoot":"","sources":["../../../src/src/jobs/jobs-client.ts"],"names":[],"mappings":"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"}

package/esm/src/jobs/jobs-client.js

@@ -0,0 +1,218 @@
+/**
+ * Jobs client SDK for project-scoped background execution.
+ *
+ * Provides a stable public client for one-off jobs, cron jobs, job batches,
+ * and job target discovery on the Veryfront Jobs API.
+ */
+import { getVeryfrontCloudBootstrap } from "../platform/cloud/resolver.js";
+import { requestWithRetry, } from "../platform/adapters/veryfront-api-client/retry-handler.js";
+import { API_CLIENT_ERROR } from "../platform/adapters/veryfront-api-client/types.js";
+import { CronJobSchema, JobBatchSchema, JobEventsResponseSchema, JobLogsResponseSchema, JobSchema, JobTargetDefinitionSchema, JobTargetDefinitionsResponseSchema, PaginatedCronJobsResponseSchema, PaginatedJobsResponseSchema, } from "./schemas.js";
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_INITIAL_RETRY_DELAY_MS = 1_000;
+const DEFAULT_MAX_RETRY_DELAY_MS = 10_000;
+function toQueryParams(values) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(values)) {
+        if (value == null) {
+            continue;
+        }
+        params.set(key, String(value));
+    }
+    return params;
+}
+function withQuery(path, params) {
+    const query = params.toString();
+    return query.length > 0 ? `${path}?${query}` : path;
+}
+export class VeryfrontJobsClient {
+    config;
+    retryConfig;
+    requestToken;
+    requestProjectReference;
+    cron;
+    batches;
+    targets;
+    constructor(config = {}) {
+        this.config = config;
+        this.retryConfig = {
+            maxRetries: config.retry?.maxRetries ?? DEFAULT_MAX_RETRIES,
+            initialDelay: config.retry?.initialDelay ?? DEFAULT_INITIAL_RETRY_DELAY_MS,
+            maxDelay: config.retry?.maxDelay ?? DEFAULT_MAX_RETRY_DELAY_MS,
+        };
+        this.cron = {
+            create: (input) => this.createCronJob(input),
+            list: (options) => this.listCronJobs(options),
+            get: (cronJobId, options) => this.getCronJob(cronJobId, options),
+            update: (cronJobId, input) => this.updateCronJob(cronJobId, input),
+            delete: (cronJobId, options) => this.deleteCronJob(cronJobId, options),
+            trigger: (cronJobId, options) => this.triggerCronJob(cronJobId, options),
+        };
+        this.batches = {
+            get: (batchId, options) => this.getBatch(batchId, options),
+            listJobs: (batchId, options) => this.listBatchJobs(batchId, options),
+        };
+        this.targets = {
+            list: (options) => this.listTargets(options),
+            get: (target, options) => this.getTarget(target, options),
+        };
+    }
+    setRequestToken(token) {
+        this.requestToken = token;
+    }
+    clearRequestToken() {
+        this.requestToken = undefined;
+    }
+    setProjectReference(projectReference) {
+        this.requestProjectReference = projectReference;
+    }
+    getProjectReference() {
+        return this.requestProjectReference ?? this.config.projectReference;
+    }
+    clearProjectReference() {
+        this.requestProjectReference = undefined;
+    }
+    create(input) {
+        const { projectReference, environmentId, batchId, timeoutSeconds, backoffLimit, ...rest } = input;
+        return this.requestProjectJson(projectReference, "/jobs", JobSchema, {
+            method: "POST",
+            body: {
+                ...rest,
+                environment_id: environmentId,
+                batch_id: batchId,
+                timeout_seconds: timeoutSeconds,
+                backoff_limit: backoffLimit,
+            },
+        });
+    }
+    list(options = {}) {
+        const { projectReference, cursor, limit, status, cronJobId, environmentId, batchId } = options;
+        return this.requestProjectJson(projectReference, withQuery("/jobs", toQueryParams({
+            cursor,
+            limit,
+            status,
+            cron_job_id: cronJobId,
+            environment_id: environmentId,
+            batch_id: batchId,
+        })), PaginatedJobsResponseSchema);
+    }
+    get(jobId, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/jobs/${encodeURIComponent(jobId)}`, JobSchema);
+    }
+    /**
+     * Canonical user-visible operational output for a job.
+     * Prefer this over raw logs for status, progress, and per-file activity.
+     */
+    events(jobId, options = {}) {
+        const { projectReference, cursor, limit, direction } = options;
+        return this.requestProjectJson(projectReference, withQuery(`/jobs/${encodeURIComponent(jobId)}/events`, toQueryParams({ cursor, limit, direction })), JobEventsResponseSchema);
+    }
+    /**
+     * Raw debugging output for a job.
+     * This is secondary to `events()` for operational UX.
+     */
+    logs(jobId, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/jobs/${encodeURIComponent(jobId)}/logs`, JobLogsResponseSchema);
+    }
+    cancel(jobId, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/jobs/${encodeURIComponent(jobId)}/cancel`, JobSchema, { method: "POST" });
+    }
+    createCronJob(input) {
+        const { projectReference, environmentId, timeoutSeconds, backoffLimit, concurrencyPolicy, ...rest } = input;
+        return this.requestProjectJson(projectReference, "/cron-jobs", CronJobSchema, {
+            method: "POST",
+            body: {
+                ...rest,
+                environment_id: environmentId,
+                timeout_seconds: timeoutSeconds,
+                backoff_limit: backoffLimit,
+                concurrency_policy: concurrencyPolicy,
+            },
+        });
+    }
+    listCronJobs(options = {}) {
+        const { projectReference, cursor, limit, status, environmentId } = options;
+        return this.requestProjectJson(projectReference, withQuery("/cron-jobs", toQueryParams({
+            cursor,
+            limit,
+            status,
+            environment_id: environmentId,
+        })), PaginatedCronJobsResponseSchema);
+    }
+    getCronJob(cronJobId, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/cron-jobs/${encodeURIComponent(cronJobId)}`, CronJobSchema);
+    }
+    updateCronJob(cronJobId, input) {
+        const { projectReference, timeoutSeconds, backoffLimit, concurrencyPolicy, ...rest } = input;
+        return this.requestProjectJson(projectReference, `/cron-jobs/${encodeURIComponent(cronJobId)}`, CronJobSchema, {
+            method: "PATCH",
+            body: {
+                ...rest,
+                timeout_seconds: timeoutSeconds,
+                backoff_limit: backoffLimit,
+                concurrency_policy: concurrencyPolicy,
+            },
+        });
+    }
+    deleteCronJob(cronJobId, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/cron-jobs/${encodeURIComponent(cronJobId)}`, CronJobSchema, { method: "DELETE" });
+    }
+    triggerCronJob(cronJobId, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/cron-jobs/${encodeURIComponent(cronJobId)}/trigger`, JobSchema, { method: "POST" });
+    }
+    getBatch(batchId, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/job-batches/${encodeURIComponent(batchId)}`, JobBatchSchema);
+    }
+    listBatchJobs(batchId, options = {}) {
+        const { projectReference, cursor, limit, status } = options;
+        return this.requestProjectJson(projectReference, withQuery(`/job-batches/${encodeURIComponent(batchId)}/jobs`, toQueryParams({
+            cursor,
+            limit,
+            status,
+        })), PaginatedJobsResponseSchema);
+    }
+    listTargets(options = {}) {
+        return this.requestProjectJson(options.projectReference, "/job-targets", JobTargetDefinitionsResponseSchema);
+    }
+    getTarget(target, options = {}) {
+        return this.requestProjectJson(options.projectReference, `/job-targets/${encodeURIComponent(target)}`, JobTargetDefinitionSchema);
+    }
+    resolveApiUrl() {
+        return this.config.apiUrl ?? getVeryfrontCloudBootstrap().apiBaseUrl;
+    }
+    resolveAuthToken() {
+        const token = this.requestToken ?? this.config.authToken ??
+            getVeryfrontCloudBootstrap().apiToken;
+        if (token) {
+            return token;
+        }
+        throw API_CLIENT_ERROR.create({
+            detail: "Jobs auth not configured. Set VERYFRONT_API_TOKEN, provide request-scoped Veryfront credentials, or pass authToken explicitly.",
+            status: 401,
+        });
+    }
+    resolveProjectReference(projectReference) {
+        const resolved = projectReference ??
+            this.requestProjectReference ??
+            this.config.projectReference ??
+            getVeryfrontCloudBootstrap().projectSlug;
+        if (resolved) {
+            return resolved;
+        }
+        throw API_CLIENT_ERROR.create({
+            detail: "Jobs project reference not configured. Pass projectReference explicitly, set VERYFRONT_PROJECT_SLUG, or provide request-scoped Veryfront project context.",
+            status: 400,
+        });
+    }
+    async requestProjectJson(projectReference, path, schema, options = {}) {
+        const resolvedProjectReference = this.resolveProjectReference(projectReference);
+        const raw = await requestWithRetry(`${this.resolveApiUrl()}/projects/${encodeURIComponent(resolvedProjectReference)}${path}`, this.resolveAuthToken(), this.retryConfig, {
+            method: options.method,
+            body: options.body == null ? undefined : JSON.stringify(options.body),
+        });
+        return schema.parse(raw);
+    }
+}
+export function createJobsClient(config) {
+    return new VeryfrontJobsClient(config);
+}