sermon-js 0.1.0 → 0.2.0

package/dist/presets/index.d.cts

@@ -150,6 +150,21 @@ type RedisPingOptions = PresetOptions & {
 declare const redis: {
     ping: (options: RedisPingOptions) => ServiceDefinition;
 };
+type PostgresPingOptions = PresetOptions & {
+    /**
+     * Runs one statement with the driver you already use (pg, postgres.js, Neon…). When
+     * undefined the service is "not configured".
+     */
+    query: ((sql: string) => Promise<unknown>) | undefined;
+    /** Optional: the connection string, only so it is redacted from public errors */
+    secrets?: {
+        url?: string;
+    };
+};
+/** Presets for PostgreSQL servers reached with a client library */
+declare const postgres: {
+    ping: (options: PostgresPingOptions) => ServiceDefinition;
+};
 
 type ApiKey = {
     secrets: {
@@ -200,6 +215,24 @@ declare const anthropic: (options: CommonOptions & ApiKey) => ServiceDefinition;
 declare const gemini: (options: CommonOptions & ApiKey) => ServiceDefinition;
 /** CAMB.AI. Lists source languages. */
 declare const cambai: (options: CommonOptions & ApiKey) => ServiceDefinition;
+type ElevenLabsOptions = PresetOptions & ApiKey & {
+    track?: {
+        /** Warn when less than this share of the period's credits is left (default 10) */
+        quota?: {
+            warnBelowPct?: number;
+        };
+    };
+};
+/**
+ * ElevenLabs. Reads the subscription, which validates the API key.
+ * - up: the key works. A key without the user scope is refused with `missing_permissions`,
+ *   which still proves it is valid.
+ * - degraded: less than `track.quota.warnBelowPct` of the credits left
+ * - down: the API rejects the key or errors
+ *
+ * Reports a `usage` bar (credits used this period, with the reset time) and `metrics.tier`.
+ */
+declare const elevenlabs: (options: ElevenLabsOptions) => ServiceDefinition;
 
 type DeepLOptions = PresetOptions & {
     secrets: {
@@ -377,6 +410,40 @@ type StatuspageOptions = PresetOptions & {
  * The provider's own description becomes the error text.
  */
 declare const statuspage: (options: StatuspageOptions) => ServiceDefinition;
+type ResendOptions = PresetOptions & {
+    secrets: {
+        apiKey: string | undefined;
+    };
+};
+/**
+ * Resend. Lists domains, which validates the API key.
+ * - up: the key works. A sending-only key is refused with `restricted_api_key`, which still
+ *   proves it is valid.
+ * - degraded: domains exist, but none is verified
+ * - down: the API rejects the key or errors
+ *
+ * Reports `metrics.domains` and `metrics.verified` for full-access keys.
+ */
+declare const resend: (options: ResendOptions) => ServiceDefinition;
+type MeilisearchOptions = PresetOptions & {
+    /** The server, e.g. "https://search.example.com" */
+    host: string | undefined;
+    /** Also require this index, and report its document count */
+    index?: string;
+    secrets: {
+        apiKey: string | undefined;
+    };
+};
+/**
+ * Meilisearch. Reads `/health`, then the index (or the list of indexes), which validates the key.
+ * - up: the server is available and the key works
+ * - degraded: the index does not exist
+ * - down: the server is unavailable, or rejects the key
+ *
+ * Reports `metrics.documents`, and `metrics.indexing` while a batch is running, when the key
+ * may read statistics; scoped keys often may not, and that is not held against them.
+ */
+declare const meilisearch: (options: MeilisearchOptions) => ServiceDefinition;
 
 type PusherOptions = PresetOptions & {
     appId: string | undefined;
@@ -424,4 +491,26 @@ declare function signPusherRequest({ appId, key, secret, path, params, timestamp
  */
 declare const pusher: (options: PusherOptions) => ServiceDefinition;
 
-export { type AttendeeOptions, type AwsCredentialsOptions, type AxiomOptions, type AzureTranslatorOptions, type CloudflareStreamOptions, type DeepLOptions, type DeepgramOptions, type FlyAppOptions, type GcpInstanceOptions, type GitHubOptions, type GoogleServiceAccount, type GoogleTranslateOptions, type MailerSendOptions, type MongoPingOptions, type MuxOptions, type OpenAIOptions, type PusherOptions, type RedisPingOptions, type RevolutOptions, type S3BucketOptions, type SpeechmaticsOptions, type StatuspageOptions, type UpstashRedisOptions, anthropic, attendee, aws, axiom, azureTranslator, cambai, clearGoogleTokens, cloudflareStream, crashReason, deepgram, deepl, fly, gcp, gemini, github, gladia, googleServiceAccountToken, googleTranslate, mailersend, mongodb, mux, openai, parseServiceAccount, pusher, redis, revolut, signGoogleAssertion, signPusherRequest, speechmatics, statuspage, upstashRedis };
+type VercelAiGatewayOptions = PresetOptions & {
+    secrets: {
+        apiKey: string | undefined;
+    };
+    track?: {
+        /** Warn when the credit balance drops below this amount in USD (default 5). `false` skips the balance. */
+        credits?: {
+            warnBelow?: number;
+        } | false;
+    };
+};
+type VercelBlobOptions = PresetOptions & {
+    secrets: {
+        token: string | undefined;
+    };
+};
+/** Presets for Vercel products */
+declare const vercel: {
+    aiGateway: (options: VercelAiGatewayOptions) => ServiceDefinition;
+    blob: (options: VercelBlobOptions) => ServiceDefinition;
+};
+
+export { type AttendeeOptions, type AwsCredentialsOptions, type AxiomOptions, type AzureTranslatorOptions, type CloudflareStreamOptions, type DeepLOptions, type DeepgramOptions, type ElevenLabsOptions, type FlyAppOptions, type GcpInstanceOptions, type GitHubOptions, type GoogleServiceAccount, type GoogleTranslateOptions, type MailerSendOptions, type MeilisearchOptions, type MongoPingOptions, type MuxOptions, type OpenAIOptions, type PostgresPingOptions, type PusherOptions, type RedisPingOptions, type ResendOptions, type RevolutOptions, type S3BucketOptions, type SpeechmaticsOptions, type StatuspageOptions, type UpstashRedisOptions, type VercelAiGatewayOptions, type VercelBlobOptions, anthropic, attendee, aws, axiom, azureTranslator, cambai, clearGoogleTokens, cloudflareStream, crashReason, deepgram, deepl, elevenlabs, fly, gcp, gemini, github, gladia, googleServiceAccountToken, googleTranslate, mailersend, meilisearch, mongodb, mux, openai, parseServiceAccount, postgres, pusher, redis, resend, revolut, signGoogleAssertion, signPusherRequest, speechmatics, statuspage, upstashRedis, vercel };

package/dist/presets/index.d.ts

@@ -150,6 +150,21 @@ type RedisPingOptions = PresetOptions & {
 declare const redis: {
     ping: (options: RedisPingOptions) => ServiceDefinition;
 };
+type PostgresPingOptions = PresetOptions & {
+    /**
+     * Runs one statement with the driver you already use (pg, postgres.js, Neon…). When
+     * undefined the service is "not configured".
+     */
+    query: ((sql: string) => Promise<unknown>) | undefined;
+    /** Optional: the connection string, only so it is redacted from public errors */
+    secrets?: {
+        url?: string;
+    };
+};
+/** Presets for PostgreSQL servers reached with a client library */
+declare const postgres: {
+    ping: (options: PostgresPingOptions) => ServiceDefinition;
+};
 
 type ApiKey = {
     secrets: {
@@ -200,6 +215,24 @@ declare const anthropic: (options: CommonOptions & ApiKey) => ServiceDefinition;
 declare const gemini: (options: CommonOptions & ApiKey) => ServiceDefinition;
 /** CAMB.AI. Lists source languages. */
 declare const cambai: (options: CommonOptions & ApiKey) => ServiceDefinition;
+type ElevenLabsOptions = PresetOptions & ApiKey & {
+    track?: {
+        /** Warn when less than this share of the period's credits is left (default 10) */
+        quota?: {
+            warnBelowPct?: number;
+        };
+    };
+};
+/**
+ * ElevenLabs. Reads the subscription, which validates the API key.
+ * - up: the key works. A key without the user scope is refused with `missing_permissions`,
+ *   which still proves it is valid.
+ * - degraded: less than `track.quota.warnBelowPct` of the credits left
+ * - down: the API rejects the key or errors
+ *
+ * Reports a `usage` bar (credits used this period, with the reset time) and `metrics.tier`.
+ */
+declare const elevenlabs: (options: ElevenLabsOptions) => ServiceDefinition;
 
 type DeepLOptions = PresetOptions & {
     secrets: {
@@ -377,6 +410,40 @@ type StatuspageOptions = PresetOptions & {
  * The provider's own description becomes the error text.
  */
 declare const statuspage: (options: StatuspageOptions) => ServiceDefinition;
+type ResendOptions = PresetOptions & {
+    secrets: {
+        apiKey: string | undefined;
+    };
+};
+/**
+ * Resend. Lists domains, which validates the API key.
+ * - up: the key works. A sending-only key is refused with `restricted_api_key`, which still
+ *   proves it is valid.
+ * - degraded: domains exist, but none is verified
+ * - down: the API rejects the key or errors
+ *
+ * Reports `metrics.domains` and `metrics.verified` for full-access keys.
+ */
+declare const resend: (options: ResendOptions) => ServiceDefinition;
+type MeilisearchOptions = PresetOptions & {
+    /** The server, e.g. "https://search.example.com" */
+    host: string | undefined;
+    /** Also require this index, and report its document count */
+    index?: string;
+    secrets: {
+        apiKey: string | undefined;
+    };
+};
+/**
+ * Meilisearch. Reads `/health`, then the index (or the list of indexes), which validates the key.
+ * - up: the server is available and the key works
+ * - degraded: the index does not exist
+ * - down: the server is unavailable, or rejects the key
+ *
+ * Reports `metrics.documents`, and `metrics.indexing` while a batch is running, when the key
+ * may read statistics; scoped keys often may not, and that is not held against them.
+ */
+declare const meilisearch: (options: MeilisearchOptions) => ServiceDefinition;
 
 type PusherOptions = PresetOptions & {
     appId: string | undefined;
@@ -424,4 +491,26 @@ declare function signPusherRequest({ appId, key, secret, path, params, timestamp
  */
 declare const pusher: (options: PusherOptions) => ServiceDefinition;
 
-export { type AttendeeOptions, type AwsCredentialsOptions, type AxiomOptions, type AzureTranslatorOptions, type CloudflareStreamOptions, type DeepLOptions, type DeepgramOptions, type FlyAppOptions, type GcpInstanceOptions, type GitHubOptions, type GoogleServiceAccount, type GoogleTranslateOptions, type MailerSendOptions, type MongoPingOptions, type MuxOptions, type OpenAIOptions, type PusherOptions, type RedisPingOptions, type RevolutOptions, type S3BucketOptions, type SpeechmaticsOptions, type StatuspageOptions, type UpstashRedisOptions, anthropic, attendee, aws, axiom, azureTranslator, cambai, clearGoogleTokens, cloudflareStream, crashReason, deepgram, deepl, fly, gcp, gemini, github, gladia, googleServiceAccountToken, googleTranslate, mailersend, mongodb, mux, openai, parseServiceAccount, pusher, redis, revolut, signGoogleAssertion, signPusherRequest, speechmatics, statuspage, upstashRedis };
+type VercelAiGatewayOptions = PresetOptions & {
+    secrets: {
+        apiKey: string | undefined;
+    };
+    track?: {
+        /** Warn when the credit balance drops below this amount in USD (default 5). `false` skips the balance. */
+        credits?: {
+            warnBelow?: number;
+        } | false;
+    };
+};
+type VercelBlobOptions = PresetOptions & {
+    secrets: {
+        token: string | undefined;
+    };
+};
+/** Presets for Vercel products */
+declare const vercel: {
+    aiGateway: (options: VercelAiGatewayOptions) => ServiceDefinition;
+    blob: (options: VercelBlobOptions) => ServiceDefinition;
+};
+
+export { type AttendeeOptions, type AwsCredentialsOptions, type AxiomOptions, type AzureTranslatorOptions, type CloudflareStreamOptions, type DeepLOptions, type DeepgramOptions, type ElevenLabsOptions, type FlyAppOptions, type GcpInstanceOptions, type GitHubOptions, type GoogleServiceAccount, type GoogleTranslateOptions, type MailerSendOptions, type MeilisearchOptions, type MongoPingOptions, type MuxOptions, type OpenAIOptions, type PostgresPingOptions, type PusherOptions, type RedisPingOptions, type ResendOptions, type RevolutOptions, type S3BucketOptions, type SpeechmaticsOptions, type StatuspageOptions, type UpstashRedisOptions, type VercelAiGatewayOptions, type VercelBlobOptions, anthropic, attendee, aws, axiom, azureTranslator, cambai, clearGoogleTokens, cloudflareStream, crashReason, deepgram, deepl, elevenlabs, fly, gcp, gemini, github, gladia, googleServiceAccountToken, googleTranslate, mailersend, meilisearch, mongodb, mux, openai, parseServiceAccount, postgres, pusher, redis, resend, revolut, signGoogleAssertion, signPusherRequest, speechmatics, statuspage, upstashRedis, vercel };

package/dist/presets/index.js

@@ -346,6 +346,16 @@ var redisPing = definePreset()({
   })
 });
 var redis = { ping: redisPing };
+var postgresPing = definePreset()({
+  kind: "postgres.ping",
+  requiredFields: ["query"],
+  defaults: { slowMs: 1e3 },
+  derive: () => ({ name: "PostgreSQL", description: "Runs `select 1`" }),
+  check: ({ options, measure }) => measure(async () => {
+    await options.query("select 1");
+  })
+});
+var postgres = { ping: postgresPing };
 
 // src/presets/providers/shared.ts
 var bearer = (token) => ({ Authorization: `Bearer ${token}` });
@@ -464,6 +474,38 @@ var cambai = definePreset()({
   derive: () => ({ name: "CAMB.AI", identity: "cambai", description: "Lists source languages" }),
   check: ({ secrets, http }) => call(http, "https://client.camb.ai/apis/source-languages", { headers: { "x-api-key": secrets.apiKey } })
 });
+var elevenlabs = definePreset()({
+  kind: "elevenlabs",
+  requiredSecrets: ["apiKey"],
+  derive: () => ({ name: "ElevenLabs", identity: "elevenlabs", description: "Reads the subscription" }),
+  check: async ({ options, secrets, http }) => {
+    const res = await http("https://api.elevenlabs.io/v1/user/subscription", {
+      headers: { "xi-api-key": secrets.apiKey }
+    });
+    const body = res.json ?? {};
+    if (res.status === 401 && body.detail?.status === "missing_permissions") {
+      return { status: "up", latencyMs: res.latencyMs, httpStatus: 401, metrics: { key: "restricted" } };
+    }
+    if (!res.ok) return res.outcome;
+    const metrics = body.tier ? { tier: body.tier } : void 0;
+    const { character_count: used, character_limit: limit } = body;
+    if (typeof used !== "number" || !limit) return { ...res.outcome, metrics };
+    return {
+      ...res.outcome,
+      ...quota({
+        label: "Credits",
+        used,
+        limit,
+        unit: "credits",
+        // ElevenLabs gives the reset as epoch seconds
+        resetsAt: body.next_character_count_reset_unix ? body.next_character_count_reset_unix * 1e3 : void 0,
+        warnAbovePct: 100 - (options.track?.quota?.warnBelowPct ?? 10),
+        warning: "Credits almost exhausted"
+      }),
+      metrics
+    };
+  }
+});
 
 // src/presets/providers/translation.ts
 var deepl = definePreset()({
@@ -695,6 +737,64 @@ var statuspage = definePreset()({
     return { status, error: status === "up" ? void 0 : description };
   })
 });
+var resend = definePreset()({
+  kind: "resend",
+  requiredSecrets: ["apiKey"],
+  derive: () => ({ name: "Resend", identity: "resend", description: "Lists domains" }),
+  check: async ({ secrets, http }) => {
+    const res = await http("https://api.resend.com/domains", { headers: bearer(secrets.apiKey) });
+    const body = res.json ?? {};
+    if (res.status === 401 && body.name === "restricted_api_key") {
+      return { status: "up", latencyMs: res.latencyMs, httpStatus: 401, metrics: { key: "sending only" } };
+    }
+    if (!res.ok || !Array.isArray(body.data)) return res.outcome;
+    const verified = body.data.filter((domain) => domain.status === "verified").length;
+    const unverified = body.data.length > 0 && verified === 0;
+    return {
+      ...res.outcome,
+      status: unverified ? "degraded" : "up",
+      error: unverified ? "No verified domain" : void 0,
+      metrics: { domains: body.data.length, verified }
+    };
+  }
+});
+var meilisearch = definePreset()({
+  kind: "meilisearch",
+  requiredFields: ["host"],
+  requiredSecrets: ["apiKey"],
+  derive: (options) => ({
+    name: "Meilisearch",
+    identity: options.index ? `meilisearch:${options.index}` : "meilisearch",
+    description: options.index ? `Reads the health and the ${options.index} index` : "Reads the health and lists indexes"
+  }),
+  check: async ({ options, secrets, http, combine }) => {
+    const host = options.host.replace(/\/+$/, "");
+    const headers = bearer(secrets.apiKey);
+    const index = options.index ? `/indexes/${encodeURIComponent(options.index)}` : void 0;
+    const health = call(
+      http,
+      `${host}/health`,
+      void 0,
+      (res2) => res2.json?.status === "available" ? void 0 : { status: "down", error: "Not available" }
+    );
+    const access = http(`${host}${index ?? "/indexes?limit=1"}`, { headers }).then((res2) => {
+      if (res2.status !== 404 || !options.index) return res2.outcome;
+      return {
+        status: "degraded",
+        latencyMs: res2.latencyMs,
+        httpStatus: 404,
+        error: `Index ${options.index} not found`
+      };
+    });
+    const stats = http(`${host}${index ?? ""}/stats`, { headers });
+    const outcome = combine(await Promise.all([health, access]));
+    const res = await stats;
+    if (!res.ok) return outcome;
+    const body = res.json ?? {};
+    const documents = body.numberOfDocuments ?? Object.values(body.indexes ?? {}).reduce((sum, entry) => sum + (entry.numberOfDocuments ?? 0), 0);
+    return { ...outcome, metrics: { ...outcome.metrics, documents, ...body.isIndexing ? { indexing: "yes" } : {} } };
+  }
+});
 
 // src/presets/providers/pusher.ts
 var MAX_CHANNELS = 500;
@@ -826,6 +926,46 @@ var pusher = definePreset()({
   }
 });
 
-export { anthropic, attendee, aws, axiom, azureTranslator, cambai, clearGoogleTokens, cloudflareStream, crashReason, deepgram, deepl, fly, gcp, gemini, github, gladia, googleServiceAccountToken, googleTranslate, mailersend, mongodb, mux, openai, parseServiceAccount, pusher, redis, revolut, signGoogleAssertion, signPusherRequest, speechmatics, statuspage, upstashRedis };
+// src/presets/providers/vercel.ts
+var aiGateway = definePreset()({
+  kind: "vercel.aiGateway",
+  requiredSecrets: ["apiKey"],
+  derive: (options) => ({
+    name: "Vercel AI Gateway",
+    identity: "vercel.aiGateway",
+    description: options.track?.credits === false ? "Lists models" : "Reads the credit balance"
+  }),
+  check: ({ options, secrets, http }) => {
+    const headers = bearer(secrets.apiKey);
+    if (options.track?.credits === false) return call(http, "https://ai-gateway.vercel.sh/v1/models", { headers });
+    const warnBelow = options.track?.credits?.warnBelow ?? 5;
+    return call(http, "https://ai-gateway.vercel.sh/v1/credits", { headers }, (res) => {
+      const body = res.json ?? {};
+      const balance = Number(body.balance);
+      if (body.balance === void 0 || !Number.isFinite(balance)) return void 0;
+      const used = Number(body.total_used);
+      const low = balance < warnBelow;
+      return {
+        status: low ? "degraded" : "up",
+        error: low ? "Low credit balance" : void 0,
+        metrics: {
+          balance: `${round(balance, 2)} USD`,
+          ...body.total_used !== void 0 && Number.isFinite(used) ? { used: `${round(used, 2)} USD` } : {}
+        }
+      };
+    });
+  }
+});
+var blob = definePreset()({
+  kind: "vercel.blob",
+  requiredSecrets: ["token"],
+  derive: () => ({ name: "Vercel Blob", identity: "vercel.blob", description: "Lists one blob of the store" }),
+  check: ({ secrets, http }) => call(http, "https://vercel.com/api/blob?limit=1", {
+    headers: { ...bearer(secrets.token), "x-api-version": "12" }
+  })
+});
+var vercel = { aiGateway, blob };
+
+export { anthropic, attendee, aws, axiom, azureTranslator, cambai, clearGoogleTokens, cloudflareStream, crashReason, deepgram, deepl, elevenlabs, fly, gcp, gemini, github, gladia, googleServiceAccountToken, googleTranslate, mailersend, meilisearch, mongodb, mux, openai, parseServiceAccount, postgres, pusher, redis, resend, revolut, signGoogleAssertion, signPusherRequest, speechmatics, statuspage, upstashRedis, vercel };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map