@cronvello/sdk 0.3.0 → 0.4.0

package/dist/{dispatch-handler-B5b9iCyH.d.cts → dispatch-handler-yHIFEnNG.d.cts}

@@ -562,4 +562,4 @@ interface DispatchHandler {
     handle(req: DispatchRequest): Promise<DispatchResponse>;
 }
 
-export { type AccountTasksQuery as A, type RegistryReconcileChange as B, type CronvelloAppConfig as C, type DispatchRequest as D, type ExecutionMode as E, type FetchLike as F, type RegistryTaskInput as G, type HttpMethod as H, type RunStatus as I, type JobCreateBody as J, type RunType as K, type SuccessCriteria as L, type MeResponse as M, type Urgency as N, type DispatchHandler as O, type PublicJob as P, type RunNowResult as R, type SyncOptions as S, Transport as T, type UsageResponse as U, type JobUpdateBody as a, type PublicTask as b, type TaskCreateBody as c, type TasksPage as d, type TaskUpdateBody as e, type RunsQuery as f, type RunsPage as g, type AccountRunsQuery as h, type PublicRun as i, type RegistryReconcileRequest as j, type RegistryReconcileResponse as k, type ResolvedJob as l, type ReconcileResult as m, type DispatchResponse as n, type CallbackStatus as o, type CronvelloHooks as p, type CronvelloJobConfig as q, type CronvelloJobConfigWithKey as r, type CronvelloJobContext as s, type CronvelloJobHandler as t, type CronvelloJobsInput as u, type CronvelloLogger as v, type CronvelloRunSource as w, type JobStatus as x, type Pagination as y, type ReconcileTaskChange as z };
+export { type AccountTasksQuery as A, type ReconcileTaskChange as B, type CronvelloAppConfig as C, type DispatchRequest as D, type ExecutionMode as E, type FetchLike as F, type RegistryReconcileChange as G, type HttpMethod as H, type RegistryTaskInput as I, type JobCreateBody as J, type RunStatus as K, type RunType as L, type MeResponse as M, type SuccessCriteria as N, type DispatchHandler as O, type PublicJob as P, type RunNowResult as R, type SyncOptions as S, Transport as T, type UsageResponse as U, type JobUpdateBody as a, type PublicTask as b, type TaskCreateBody as c, type TasksPage as d, type TaskUpdateBody as e, type RunsQuery as f, type RunsPage as g, type AccountRunsQuery as h, type PublicRun as i, type RegistryReconcileRequest as j, type RegistryReconcileResponse as k, type ResolvedJob as l, type ReconcileResult as m, type DispatchResponse as n, type Urgency as o, type CallbackStatus as p, type CronvelloHooks as q, type CronvelloJobConfig as r, type CronvelloJobConfigWithKey as s, type CronvelloJobContext as t, type CronvelloJobHandler as u, type CronvelloJobsInput as v, type CronvelloLogger as w, type CronvelloRunSource as x, type JobStatus as y, type Pagination as z };

package/dist/{dispatch-handler-B5b9iCyH.d.ts → dispatch-handler-yHIFEnNG.d.ts}

@@ -562,4 +562,4 @@ interface DispatchHandler {
     handle(req: DispatchRequest): Promise<DispatchResponse>;
 }
 
-export { type AccountTasksQuery as A, type RegistryReconcileChange as B, type CronvelloAppConfig as C, type DispatchRequest as D, type ExecutionMode as E, type FetchLike as F, type RegistryTaskInput as G, type HttpMethod as H, type RunStatus as I, type JobCreateBody as J, type RunType as K, type SuccessCriteria as L, type MeResponse as M, type Urgency as N, type DispatchHandler as O, type PublicJob as P, type RunNowResult as R, type SyncOptions as S, Transport as T, type UsageResponse as U, type JobUpdateBody as a, type PublicTask as b, type TaskCreateBody as c, type TasksPage as d, type TaskUpdateBody as e, type RunsQuery as f, type RunsPage as g, type AccountRunsQuery as h, type PublicRun as i, type RegistryReconcileRequest as j, type RegistryReconcileResponse as k, type ResolvedJob as l, type ReconcileResult as m, type DispatchResponse as n, type CallbackStatus as o, type CronvelloHooks as p, type CronvelloJobConfig as q, type CronvelloJobConfigWithKey as r, type CronvelloJobContext as s, type CronvelloJobHandler as t, type CronvelloJobsInput as u, type CronvelloLogger as v, type CronvelloRunSource as w, type JobStatus as x, type Pagination as y, type ReconcileTaskChange as z };
+export { type AccountTasksQuery as A, type ReconcileTaskChange as B, type CronvelloAppConfig as C, type DispatchRequest as D, type ExecutionMode as E, type FetchLike as F, type RegistryReconcileChange as G, type HttpMethod as H, type RegistryTaskInput as I, type JobCreateBody as J, type RunStatus as K, type RunType as L, type MeResponse as M, type SuccessCriteria as N, type DispatchHandler as O, type PublicJob as P, type RunNowResult as R, type SyncOptions as S, Transport as T, type UsageResponse as U, type JobUpdateBody as a, type PublicTask as b, type TaskCreateBody as c, type TasksPage as d, type TaskUpdateBody as e, type RunsQuery as f, type RunsPage as g, type AccountRunsQuery as h, type PublicRun as i, type RegistryReconcileRequest as j, type RegistryReconcileResponse as k, type ResolvedJob as l, type ReconcileResult as m, type DispatchResponse as n, type Urgency as o, type CallbackStatus as p, type CronvelloHooks as q, type CronvelloJobConfig as r, type CronvelloJobConfigWithKey as s, type CronvelloJobContext as t, type CronvelloJobHandler as u, type CronvelloJobsInput as v, type CronvelloLogger as w, type CronvelloRunSource as x, type JobStatus as y, type Pagination as z };

package/dist/express.d.cts

@@ -1,4 +1,4 @@
-import { O as DispatchHandler } from './dispatch-handler-B5b9iCyH.cjs';
+import { O as DispatchHandler } from './dispatch-handler-yHIFEnNG.cjs';
 
 /**
  * Express adapter. Zero dependency on `express` itself — the request/response are typed

package/dist/express.d.ts

@@ -1,4 +1,4 @@
-import { O as DispatchHandler } from './dispatch-handler-B5b9iCyH.js';
+import { O as DispatchHandler } from './dispatch-handler-yHIFEnNG.js';
 
 /**
  * Express adapter. Zero dependency on `express` itself — the request/response are typed

package/dist/index.cjs

@@ -1916,6 +1916,112 @@ function field(value, min, max, label) {
   return value;
 }
 
+// src/client/admin-client.ts
+var CronvelloAdminClient = class {
+  transport;
+  /** The resolved base URL in use. */
+  baseUrl;
+  /** Registration, status, key rotation and removal of external apps. */
+  externalApps;
+  constructor(options) {
+    if (!options || !options.serviceKey) {
+      throw new CronvelloConfigError(
+        "CronvelloAdminClient requires a `serviceKey` (Cronvello's backend-to-backend key, not an account apiKey)."
+      );
+    }
+    this.baseUrl = (options.baseUrl ?? CRONVELLO_DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.transport = new Transport({
+      baseUrl: this.baseUrl,
+      apiKey: options.serviceKey,
+      ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+      ...options.maxRetries !== void 0 ? { maxRetries: options.maxRetries } : {},
+      ...options.fetch ? { fetch: options.fetch } : {},
+      ...options.onRequest ? { onRequest: options.onRequest } : {}
+    });
+    this.externalApps = new ExternalAppsResource(this.transport);
+  }
+};
+var ExternalAppsResource = class {
+  constructor(t) {
+    this.t = t;
+  }
+  t;
+  /**
+   * Idempotent upsert, keyed on the string `appId`: creates when unknown, updates credentials
+   * and URL when it already exists. Safe to retry and to re-run on every provisioning pass.
+   *
+   * When the server mints the token (`generateApiKey: true` on a *new* app) it comes back as
+   * `generatedApiKey` — plaintext, exactly once. On an update it is `null`.
+   */
+  register(input) {
+    assertRegisterInput(input);
+    return this.t.request({ method: "POST", path: "/external-apps/service/register", body: input });
+  }
+  /** Registration status, last-sync info and job count for one app, by its string `appId`. */
+  status(appId) {
+    assertAppId(appId, "status");
+    return this.t.request({ method: "GET", path: `/external-apps/service/status/${enc2(appId)}` });
+  }
+  /**
+   * Mint a fresh per-app token, by string `appId`. The new token is returned once as `newApiKey`
+   * and must be written into the app's environment — the previous one stops working.
+   *
+   * Use this for drift recovery when the current token is no longer known.
+   */
+  rotateKey(appId) {
+    assertAppId(appId, "rotateKey");
+    return this.t.request({ method: "POST", path: `/external-apps/service/rotate-key/${enc2(appId)}` });
+  }
+  /**
+   * Delete a registration, cascading its jobs and tasks.
+   *
+   * ⚠ This one takes the **numeric** {@link ExternalApp.id}, not the string `appId` the other
+   * three methods take — an asymmetry in the server's route contract. Read the id off a
+   * `register()` result (or a prior lookup); passing a string `appId` here is rejected locally.
+   */
+  delete(id) {
+    if (!Number.isInteger(id) || id <= 0) {
+      throw new CronvelloConfigError(
+        `externalApps.delete() takes the numeric app id (ExternalApp.id), not the string appId \u2014 received ${JSON.stringify(id)}.`
+      );
+    }
+    return this.t.request({ method: "DELETE", path: `/external-apps/service/delete/${id}` });
+  }
+};
+function assertRegisterInput(input) {
+  if (!input || typeof input !== "object") {
+    throw new CronvelloConfigError("externalApps.register() requires an input object.");
+  }
+  if (!input.appId || !input.appId.trim()) {
+    throw new CronvelloConfigError("externalApps.register() requires a non-empty `appId`.");
+  }
+  if (!input.name || !input.name.trim()) {
+    throw new CronvelloConfigError("externalApps.register() requires a non-empty `name`.");
+  }
+  if (!input.base_url && input.targetUrl === void 0) {
+    throw new CronvelloConfigError("externalApps.register() requires either `base_url` or `targetUrl`.");
+  }
+  const authMethod = input.authMethod ?? (input.oauthClientId || input.oauthClientSecret ? "oauth" : "api_key");
+  if (authMethod === "api_key" && !input.apiKey && !input.generateApiKey) {
+    throw new CronvelloConfigError(
+      "externalApps.register() with api_key auth requires either `apiKey` or `generateApiKey: true`."
+    );
+  }
+  if (authMethod === "oauth" && (!input.oauthClientId || !input.oauthClientSecret)) {
+    throw new CronvelloConfigError(
+      "externalApps.register() with oauth auth requires both `oauthClientId` and `oauthClientSecret`."
+    );
+  }
+}
+function assertAppId(appId, method) {
+  if (typeof appId !== "string" || !appId.trim()) {
+    throw new CronvelloConfigError(`externalApps.${method}() requires a non-empty string appId.`);
+  }
+}
+function enc2(segment) {
+  return encodeURIComponent(segment);
+}
+
 // src/index.ts
 function generateDispatchSecret(bytes = 32) {
   const buf = new Uint8Array(bytes);
@@ -1924,6 +2030,7 @@ function generateDispatchSecret(bytes = 32) {
 }
 
 exports.CRONVELLO_DEFAULT_BASE_URL = CRONVELLO_DEFAULT_BASE_URL;
+exports.CronvelloAdminClient = CronvelloAdminClient;
 exports.CronvelloApiError = CronvelloApiError;
 exports.CronvelloClient = CronvelloClient;
 exports.CronvelloConfigError = CronvelloConfigError;