@automate.ax/integration-contracts 0.147.1 → 0.150.0

package/dist/kit/operation-manifest.js

@@ -0,0 +1,98 @@
+/** Complete practical Kit V4 action surface with verifiable request contracts. */
+export const KIT_OPERATION_DEFINITIONS = [
+    operation("getCurrentAccount", "GET", "/v4/account", "getKitCurrentAccount", "Get current Kit account", "Returns the authenticated Kit account and user identity.", "safe", false),
+    operation("listColors", "GET", "/v4/account/colors", "listKitColors", "List Kit colors", "Lists the account's saved brand color palette.", "safe", false),
+    operation("updateColors", "PUT", "/v4/account/colors", "updateKitColors", "Update Kit colors", "Replaces the account's saved brand color palette.", "safe", false),
+    operation("getCreatorProfile", "GET", "/v4/account/creator_profile", "getKitCreatorProfile", "Get Kit creator profile", "Returns the account's public creator profile.", "safe", false),
+    operation("getEmailStats", "GET", "/v4/account/email_stats", "getKitEmailStats", "Get Kit email stats", "Returns account-level email performance for the last 90 days.", "safe", false),
+    operation("getGrowthStats", "GET", "/v4/account/growth_stats", "getKitGrowthStats", "Get Kit growth stats", "Returns subscriber growth statistics for a selected period.", "safe", false),
+    operation("listBroadcasts", "GET", "/v4/broadcasts", "listKitBroadcasts", "List Kit broadcasts", "Lists broadcasts with cursor pagination and lifecycle filters.", "safe", false),
+    operation("createBroadcast", "POST", "/v4/broadcasts", "createKitBroadcast", "Create Kit broadcast", "Creates a draft or scheduled Kit broadcast.", "unsafe", false),
+    operation("listBroadcastStats", "GET", "/v4/broadcasts/stats", "listKitBroadcastStats", "List Kit broadcast stats", "Lists delivery and engagement statistics for broadcasts.", "safe", false),
+    operation("listBroadcastLinkClicks", "GET", "/v4/broadcasts/{broadcast_id}/clicks", "listKitBroadcastLinkClicks", "List Kit broadcast link clicks", "Lists link-level click performance for a broadcast.", "safe", false),
+    operation("getBroadcastStats", "GET", "/v4/broadcasts/{broadcast_id}/stats", "getKitBroadcastStats", "Get Kit broadcast stats", "Returns delivery and engagement statistics for one broadcast.", "safe", false),
+    operation("deleteBroadcast", "DELETE", "/v4/broadcasts/{id}", "deleteKitBroadcast", "Delete Kit broadcast", "Permanently deletes a draft or scheduled broadcast.", "safe", false),
+    operation("getBroadcast", "GET", "/v4/broadcasts/{id}", "getKitBroadcast", "Get Kit broadcast", "Returns one broadcast with content, targeting, and publication settings.", "safe", false),
+    operation("updateBroadcast", "PUT", "/v4/broadcasts/{id}", "updateKitBroadcast", "Update Kit broadcast", "Updates a draft or scheduled broadcast.", "safe", false),
+    operation("bulkCreateCustomFields", "POST", "/v4/bulk/custom_fields", "bulkCreateKitCustomFields", "Bulk create Kit custom fields", "Creates custom fields synchronously or as an asynchronous bulk job.", "unsafe", true),
+    operation("bulkUpdateSubscriberCustomFieldValues", "POST", "/v4/bulk/custom_fields/subscribers", "bulkUpdateKitSubscriberCustomFieldValues", "Bulk update Kit subscriber custom fields", "Updates custom field values across subscribers in one bulk request.", "safe", true),
+    operation("listCustomFields", "GET", "/v4/custom_fields", "listKitCustomFields", "List Kit custom fields", "Lists custom fields with cursor pagination.", "safe", false),
+    operation("createCustomField", "POST", "/v4/custom_fields", "createKitCustomField", "Create Kit custom field", "Creates one account custom field.", "unsafe", false),
+    operation("deleteCustomField", "DELETE", "/v4/custom_fields/{id}", "deleteKitCustomField", "Delete Kit custom field", "Deletes a custom field and all subscriber values stored in it.", "safe", false),
+    operation("updateCustomField", "PUT", "/v4/custom_fields/{id}", "updateKitCustomField", "Update Kit custom field", "Renames one custom field.", "safe", false),
+    operation("listEmailTemplates", "GET", "/v4/email_templates", "listKitEmailTemplates", "List Kit email templates", "Lists account email templates with cursor pagination.", "safe", false),
+    operation("bulkAddSubscribersToForms", "POST", "/v4/bulk/forms/subscribers", "bulkAddKitSubscribersToForms", "Bulk add Kit subscribers to forms", "Adds subscribers to forms synchronously or as an asynchronous bulk job.", "safe", true),
+    operation("listForms", "GET", "/v4/forms", "listKitForms", "List Kit forms", "Lists forms and landing pages with status and type filters.", "safe", false),
+    operation("listFormSubscribers", "GET", "/v4/forms/{form_id}/subscribers", "listKitFormSubscribers", "List Kit form subscribers", "Lists subscribers associated with one form.", "safe", false),
+    operation("addSubscriberToFormByEmailAddress", "POST", "/v4/forms/{form_id}/subscribers", "addKitSubscriberToFormByEmailAddress", "Add Kit subscriber to form by email", "Adds an existing subscriber to a form by email address.", "safe", false),
+    operation("addSubscriberToForm", "POST", "/v4/forms/{form_id}/subscribers/{id}", "addKitSubscriberToForm", "Add Kit subscriber to form", "Adds an existing subscriber to a form by subscriber ID.", "safe", false),
+    operation("listPosts", "GET", "/v4/posts", "listKitPosts", "List Kit posts", "Lists posts published to the creator's Kit site or email audience.", "safe", false),
+    operation("getPost", "GET", "/v4/posts/{id}", "getKitPost", "Get Kit post", "Returns one post with content, publication, and SEO fields.", "safe", false),
+    operation("listPurchases", "GET", "/v4/purchases", "listKitPurchases", "List Kit purchases", "Lists purchases recorded in the account.", "safe", true),
+    operation("createPurchase", "POST", "/v4/purchases", "createKitPurchase", "Create Kit purchase", "Records a purchase against a subscriber.", "unsafe", true),
+    operation("getPurchase", "GET", "/v4/purchases/{id}", "getKitPurchase", "Get Kit purchase", "Returns one recorded purchase.", "safe", true),
+    operation("listSegments", "GET", "/v4/segments", "listKitSegments", "List Kit segments", "Lists account segments with cursor pagination.", "safe", false),
+    operation("listSequenceEmails", "GET", "/v4/sequences/{sequence_id}/emails", "listKitSequenceEmails", "List Kit sequence emails", "Lists the email steps in one sequence.", "safe", false),
+    operation("createSequenceEmail", "POST", "/v4/sequences/{sequence_id}/emails", "createKitSequenceEmail", "Create Kit sequence email", "Adds one email step to a sequence.", "unsafe", false),
+    operation("deleteSequenceEmail", "DELETE", "/v4/sequences/{sequence_id}/emails/{id}", "deleteKitSequenceEmail", "Delete Kit sequence email", "Permanently removes one email from a sequence.", "safe", false),
+    operation("getSequenceEmail", "GET", "/v4/sequences/{sequence_id}/emails/{id}", "getKitSequenceEmail", "Get Kit sequence email", "Returns one sequence email with its full content.", "safe", false),
+    operation("updateSequenceEmail", "PUT", "/v4/sequences/{sequence_id}/emails/{id}", "updateKitSequenceEmail", "Update Kit sequence email", "Updates one sequence email's content, timing, position, or state.", "safe", false),
+    operation("listSequences", "GET", "/v4/sequences", "listKitSequences", "List Kit sequences", "Lists automated email sequences.", "safe", false),
+    operation("createSequence", "POST", "/v4/sequences", "createKitSequence", "Create Kit sequence", "Creates an empty automated email sequence.", "unsafe", false),
+    operation("deleteSequence", "DELETE", "/v4/sequences/{id}", "deleteKitSequence", "Delete Kit sequence", "Soft-deletes a sequence and stops active delivery.", "safe", false),
+    operation("getSequence", "GET", "/v4/sequences/{id}", "getKitSequence", "Get Kit sequence", "Returns one sequence and its delivery settings.", "safe", false),
+    operation("updateSequence", "PUT", "/v4/sequences/{id}", "updateKitSequence", "Update Kit sequence", "Updates one sequence's schedule and delivery settings.", "safe", false),
+    operation("listSequenceSubscribers", "GET", "/v4/sequences/{sequence_id}/subscribers", "listKitSequenceSubscribers", "List Kit sequence subscribers", "Lists subscribers enrolled in one sequence.", "safe", false),
+    operation("addSubscriberToSequenceByEmailAddress", "POST", "/v4/sequences/{sequence_id}/subscribers", "addKitSubscriberToSequenceByEmailAddress", "Add Kit subscriber to sequence by email", "Adds an existing subscriber to a sequence by email address.", "safe", false),
+    operation("addSubscriberToSequence", "POST", "/v4/sequences/{sequence_id}/subscribers/{id}", "addKitSubscriberToSequence", "Add Kit subscriber to sequence", "Adds an existing subscriber to a sequence by subscriber ID.", "safe", false),
+    operation("listSnippets", "GET", "/v4/snippets", "listKitSnippets", "List Kit snippets", "Lists reusable email snippets.", "safe", false),
+    operation("createSnippet", "POST", "/v4/snippets", "createKitSnippet", "Create Kit snippet", "Creates a reusable email snippet.", "unsafe", false),
+    operation("getSnippet", "GET", "/v4/snippets/{id}", "getKitSnippet", "Get Kit snippet", "Returns one reusable snippet with full content.", "safe", false),
+    operation("updateSnippet", "PUT", "/v4/snippets/{id}", "updateKitSnippet", "Update Kit snippet", "Updates a snippet's name, content, or archive state.", "safe", false),
+    operation("bulkCreateSubscribers", "POST", "/v4/bulk/subscribers", "bulkCreateKitSubscribers", "Bulk create Kit subscribers", "Creates or updates subscribers in one bulk request.", "safe", true),
+    operation("listSubscribers", "GET", "/v4/subscribers", "listKitSubscribers", "List Kit subscribers", "Lists subscribers with cursor, status, date, and engagement sorting filters.", "safe", false),
+    operation("createSubscriber", "POST", "/v4/subscribers", "createKitSubscriber", "Create Kit subscriber", "Creates or updates a subscriber by email address.", "safe", false),
+    operation("filterSubscribers", "POST", "/v4/subscribers/filter", "filterKitSubscribers", "Filter Kit subscribers", "Filters subscribers by engagement, signup, state, and tags.", "safe", false),
+    operation("getSubscriber", "GET", "/v4/subscribers/{id}", "getKitSubscriber", "Get Kit subscriber", "Returns one subscriber and their custom field values.", "safe", false),
+    operation("updateSubscriber", "PUT", "/v4/subscribers/{id}", "updateKitSubscriber", "Update Kit subscriber", "Updates one subscriber and their custom field values.", "safe", false),
+    operation("unsubscribeSubscriber", "POST", "/v4/subscribers/{id}/unsubscribe", "unsubscribeKitSubscriber", "Unsubscribe Kit subscriber", "Unsubscribes a subscriber from all future Kit email.", "safe", false),
+    operation("deleteSubscriberLocation", "DELETE", "/v4/subscribers/{subscriber_id}/location", "deleteKitSubscriberLocation", "Delete Kit subscriber location", "Removes a subscriber's pinned location.", "safe", false),
+    operation("updateSubscriberLocation", "PATCH", "/v4/subscribers/{subscriber_id}/location", "updateKitSubscriberLocation", "Update Kit subscriber location", "Replaces a subscriber's pinned location.", "safe", false),
+    operation("pinSubscriberLocation", "POST", "/v4/subscribers/{subscriber_id}/location", "pinKitSubscriberLocation", "Pin Kit subscriber location", "Pins an explicit location to a subscriber.", "safe", false),
+    operation("getSubscriberStats", "GET", "/v4/subscribers/{subscriber_id}/stats", "getKitSubscriberStats", "Get Kit subscriber stats", "Returns delivery and engagement statistics for one subscriber.", "safe", false),
+    operation("listSubscriberTags", "GET", "/v4/subscribers/{subscriber_id}/tags", "listKitSubscriberTags", "List Kit subscriber tags", "Lists tags currently applied to one subscriber.", "safe", false),
+    operation("bulkDeleteTags", "DELETE", "/v4/bulk/tags", "bulkDeleteKitTags", "Bulk delete Kit tags", "Deletes tags synchronously or as an asynchronous bulk job.", "safe", true),
+    operation("bulkCreateTags", "POST", "/v4/bulk/tags", "bulkCreateKitTags", "Bulk create Kit tags", "Creates tags synchronously or as an asynchronous bulk job.", "safe", true),
+    operation("bulkTagSubscribers", "POST", "/v4/bulk/tags/subscribers", "bulkTagKitSubscribers", "Bulk tag Kit subscribers", "Applies tags to subscribers in one bulk request.", "safe", true),
+    operation("listTags", "GET", "/v4/tags", "listKitTags", "List Kit tags", "Lists account tags with cursor pagination.", "safe", false),
+    operation("createTag", "POST", "/v4/tags", "createKitTag", "Create Kit tag", "Creates a tag or returns the existing case-insensitive name match.", "safe", false),
+    operation("updateTag", "PUT", "/v4/tags/{id}", "updateKitTag", "Update Kit tag", "Renames one tag without changing its memberships.", "safe", false),
+    operation("listTagSubscribers", "GET", "/v4/tags/{tag_id}/subscribers", "listKitTagSubscribers", "List Kit tag subscribers", "Lists subscribers that have one tag.", "safe", false),
+    operation("tagSubscriberByEmailAddress", "POST", "/v4/tags/{tag_id}/subscribers", "tagKitSubscriberByEmailAddress", "Tag Kit subscriber by email", "Applies a tag to an existing subscriber by email address.", "safe", false),
+    operation("removeTagFromSubscriber", "DELETE", "/v4/tags/{tag_id}/subscribers/{id}", "removeKitTagFromSubscriber", "Remove Kit tag from subscriber", "Removes one tag from a subscriber by ID.", "safe", false),
+    operation("tagSubscriber", "POST", "/v4/tags/{tag_id}/subscribers/{id}", "tagKitSubscriber", "Tag Kit subscriber", "Applies a tag to an existing subscriber by ID.", "safe", false),
+];
+/**
+ * Preserves one Kit operation's public metadata.
+ *
+ * @param alias Public object alias and generated operation key.
+ * @param method Provider HTTP method.
+ * @param path Provider-relative V4 path.
+ * @param exportName Named SDK export.
+ * @param title Public action title.
+ * @param description Public action description.
+ * @param replaySafety Whether the provider operation can be replayed.
+ * @param oauthOnly Whether Kit rejects API-key authentication.
+ */
+function operation(alias, method, path, exportName, title, description, replaySafety, oauthOnly) {
+    return {
+        alias,
+        description,
+        exportName,
+        method,
+        oauthOnly,
+        path,
+        replaySafety,
+        title,
+    };
+}

package/dist/kit/schemas.d.ts

@@ -0,0 +1,42 @@
+import * as z from "zod";
+import type { KitOperationKey } from "./operation-manifest.js";
+import type { KitOperationInput, KitOperationOutput } from "./types.js";
+export interface KitRuntimeParameter {
+    explode: boolean;
+    name: string;
+    providerName: string;
+    style: string;
+}
+/** Frozen runtime description of one public Kit operation. */
+export interface KitRuntimeOperation {
+    bodyParameters: string[];
+    bodyWireSchema?: Record<string, unknown>;
+    inputSchema: Record<string, unknown>;
+    method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    outputSchema: Record<string, unknown>;
+    outputWireSchema: Record<string, unknown>;
+    path: string;
+    pathParameters: KitRuntimeParameter[];
+    queryParameters: KitRuntimeParameter[];
+    responseMode: "json" | "void";
+}
+/**
+ * Returns the immutable runtime descriptor for one Kit operation.
+ *
+ * @param key Public operation name.
+ */
+export declare function kitOperation<TKey extends KitOperationKey>(key: TKey): Record<"getCurrentAccount" | "listColors" | "updateColors" | "getCreatorProfile" | "getEmailStats" | "getGrowthStats" | "listBroadcasts" | "createBroadcast" | "listBroadcastStats" | "listBroadcastLinkClicks" | "getBroadcastStats" | "deleteBroadcast" | "getBroadcast" | "updateBroadcast" | "bulkCreateCustomFields" | "bulkUpdateSubscriberCustomFieldValues" | "listCustomFields" | "createCustomField" | "deleteCustomField" | "updateCustomField" | "listEmailTemplates" | "bulkAddSubscribersToForms" | "listForms" | "listFormSubscribers" | "addSubscriberToFormByEmailAddress" | "addSubscriberToForm" | "listPosts" | "getPost" | "listPurchases" | "createPurchase" | "getPurchase" | "listSegments" | "listSequenceEmails" | "createSequenceEmail" | "deleteSequenceEmail" | "getSequenceEmail" | "updateSequenceEmail" | "listSequences" | "createSequence" | "deleteSequence" | "getSequence" | "updateSequence" | "listSequenceSubscribers" | "addSubscriberToSequenceByEmailAddress" | "addSubscriberToSequence" | "listSnippets" | "createSnippet" | "getSnippet" | "updateSnippet" | "bulkCreateSubscribers" | "listSubscribers" | "createSubscriber" | "filterSubscribers" | "getSubscriber" | "updateSubscriber" | "unsubscribeSubscriber" | "deleteSubscriberLocation" | "updateSubscriberLocation" | "pinSubscriberLocation" | "getSubscriberStats" | "listSubscriberTags" | "bulkDeleteTags" | "bulkCreateTags" | "bulkTagSubscribers" | "listTags" | "createTag" | "updateTag" | "listTagSubscribers" | "tagSubscriberByEmailAddress" | "removeTagFromSubscriber" | "tagSubscriber", KitRuntimeOperation>[TKey];
+/**
+ * Validates flattened public input for one Kit operation.
+ *
+ * @param key Public operation name.
+ */
+export declare function kitOperationInputSchema<TKey extends KitOperationKey>(key: TKey): z.ZodType<KitOperationInput<TKey>>;
+/**
+ * Validates a public successful response for one Kit operation.
+ *
+ * @param key Public operation name.
+ */
+export declare function kitOperationOutputSchema<TKey extends KitOperationKey>(key: TKey): z.ZodType<KitOperationOutput<TKey>>;
+/** Provider-native component schemas used for schema-guided key mapping. */
+export declare const KIT_WIRE_DEFINITIONS: Record<string, Record<string, unknown>>;

package/dist/kit/schemas.js

@@ -0,0 +1,43 @@
+/* oxlint-disable typescript/no-unsafe-type-assertion -- Generated operation keys index a frozen external contract. */
+import { Validator } from "@cfworker/json-schema";
+import * as z from "zod";
+import { KIT_OPENAPI_DATA } from "./openapi-operations.generated";
+/** Runtime Kit contract narrowed once from the opaque generated payload. */
+const operationData = KIT_OPENAPI_DATA;
+const OPERATIONS = operationData.operations;
+const VALIDATOR = new Validator({
+    $defs: operationData.definitions,
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    additionalProperties: false,
+    properties: Object.fromEntries(Object.entries(OPERATIONS).flatMap(([key, operation]) => [
+        [`${key}:input`, operation.inputSchema],
+        [`${key}:output`, operation.outputSchema],
+    ])),
+    type: "object",
+}, "2020-12");
+/**
+ * Returns the immutable runtime descriptor for one Kit operation.
+ *
+ * @param key Public operation name.
+ */
+export function kitOperation(key) {
+    return OPERATIONS[key];
+}
+/**
+ * Validates flattened public input for one Kit operation.
+ *
+ * @param key Public operation name.
+ */
+export function kitOperationInputSchema(key) {
+    return z.custom((value) => VALIDATOR.validate({ [`${key}:input`]: value }).valid, { message: `Input does not match Kit operation ${key}.` });
+}
+/**
+ * Validates a public successful response for one Kit operation.
+ *
+ * @param key Public operation name.
+ */
+export function kitOperationOutputSchema(key) {
+    return z.custom((value) => VALIDATOR.validate({ [`${key}:output`]: value }).valid, { message: `Output does not match Kit operation ${key}.` });
+}
+/** Provider-native component schemas used for schema-guided key mapping. */
+export const KIT_WIRE_DEFINITIONS = operationData.wireDefinitions;

package/dist/kit/types.d.ts

@@ -0,0 +1,41 @@
+import type { Encodable } from "@automate.ax/codec";
+import type { KitOperationMap } from "./openapi-types.generated";
+import type { KitOperationKey } from "./operation-manifest.js";
+type Operation<TKey extends KitOperationKey> = TKey extends keyof KitOperationMap ? KitOperationMap[TKey] : never;
+/** Converts absent generated operation sections into intersection identities. */
+type InputPart<TValue> = [NonNullable<TValue>] extends [never] ? unknown : NonNullable<TValue>;
+type Parameters<TOperation, TLocation extends string> = TOperation extends {
+    parameters?: infer TParameters;
+} ? TLocation extends keyof NonNullable<TParameters> ? InputPart<NonNullable<TParameters>[TLocation]> : unknown : unknown;
+/** Extracts the JSON request body from one generated operation. */
+type JsonBody<TOperation> = TOperation extends {
+    requestBody?: infer TBody;
+} ? [NonNullable<TBody>] extends [never] ? unknown : NonNullable<TBody> extends {
+    content: infer TContent;
+} ? "application/json" extends keyof TContent ? TContent["application/json"] : unknown : unknown : unknown;
+/** Extracts the JSON response body from one generated response. */
+type JsonResponse<TResponse> = TResponse extends {
+    content: infer TContent;
+} ? "application/json" extends keyof TContent ? TContent["application/json"] : object : object;
+/** Extracts the union of successful generated operation responses. */
+type SuccessResponse<TOperation> = TOperation extends {
+    responses: infer TResponses;
+} ? JsonResponse<TResponses[Extract<keyof TResponses, 200 | 201 | 202 | 203 | 204>]> : never;
+/** Materializes an intersection as one readable object type. */
+type Simplify<TValue> = {
+    [TKey in keyof TValue]: TValue[TKey];
+} & {};
+type EncodableValue<TValue> = unknown extends TValue ? Encodable : TValue extends undefined | null | boolean | number | string ? TValue : TValue extends readonly (infer TItem)[] ? EncodableValue<TItem>[] : TValue extends object ? keyof TValue extends never ? Record<string, Encodable> : {
+    [TKey in keyof TValue]: EncodableValue<TValue[TKey]>;
+} : never;
+/** Flattens one generated operation's path, query, and body fields. */
+type RawKitOperationInput<TKey extends KitOperationKey> = Simplify<Parameters<Operation<TKey>, "path"> & Parameters<Operation<TKey>, "query"> & JsonBody<Operation<TKey>>>;
+/** Preserves operation unions and rejects fields on truly empty inputs. */
+type PublicInput<TValue> = TValue extends unknown ? keyof TValue extends never ? Record<string, never> : {
+    [TField in keyof TValue]: EncodableValue<TValue[TField]>;
+} : never;
+/** Flattened camelCase input for one frozen Kit V4 operation. */
+export type KitOperationInput<TKey extends KitOperationKey> = PublicInput<RawKitOperationInput<TKey>>;
+/** CamelCase successful response for one frozen Kit V4 operation. */
+export type KitOperationOutput<TKey extends KitOperationKey> = EncodableValue<SuccessResponse<Operation<TKey>>>;
+export {};

package/dist/kit/types.js

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

package/dist/krisp/api.d.ts

@@ -0,0 +1,61 @@
+import type { Encodable } from "@automate.ax/codec";
+import * as z from "zod";
+/** Options for one authenticated Krisp REST request. */
+export interface KrispRequestOptions<TSchema extends z.ZodType> {
+    /** Public camelCase JSON body. */
+    body?: Encodable;
+    /** HTTP verb. Defaults to `GET`. */
+    method?: "GET" | "POST";
+    /** Public camelCase query parameters. */
+    query?: Record<string, boolean | number | readonly string[] | string | undefined>;
+    /** Schema for the normalized provider response. */
+    responseSchema: TSchema;
+}
+/** Structured Krisp REST failure. */
+export declare class KrispApiError extends Error {
+    /** Normalized provider error payload, when valid JSON was returned. */
+    readonly body?: Encodable;
+    /** Retry delay in seconds, when Krisp returned one. */
+    readonly retryAfter?: number;
+    /** HTTP status returned by Krisp. */
+    readonly status: number;
+    /**
+     * Creates a structured Krisp API error.
+     *
+     * @param options - Provider status, body, and retry metadata.
+     * @param options.body - Normalized provider error body.
+     * @param options.retryAfter - Retry delay in seconds.
+     * @param options.status - HTTP status.
+     */
+    constructor(options: {
+        body?: Encodable;
+        retryAfter?: number;
+        status: number;
+    });
+}
+/**
+ * Creates an authenticated Krisp Meeting Assistant REST client.
+ *
+ * @param secret - Resolved Krisp API-key secret.
+ */
+export declare function getKrispApi(secret: Record<string, unknown>): {
+    /**
+     * Runs one Krisp request and returns its normalized response.
+     *
+     * @param path - API path relative to the v1 root.
+     * @param options - Method, parameters, and response schema.
+     */
+    request<TSchema extends z.ZodType>(path: string, options: KrispRequestOptions<TSchema>): Promise<z.output<TSchema>>;
+};
+/**
+ * Converts public camelCase JSON to Krisp wire keys.
+ *
+ * @param value - Public value to normalize.
+ */
+export declare function toKrisp(value: Encodable): Encodable;
+/**
+ * Converts Krisp wire JSON to public camelCase keys.
+ *
+ * @param value - Provider value to normalize.
+ */
+export declare function fromKrisp(value: unknown): unknown;

package/dist/krisp/api.js

@@ -0,0 +1,170 @@
+import { encodableSchema } from "@automate.ax/codec";
+import * as z from "zod";
+const KRISP_API_BASE_URL = "https://meeting-api.krisp.ai/v1/";
+const KRISP_API_ORIGIN = new URL(KRISP_API_BASE_URL).origin;
+const KRISP_SECRET_SCHEMA = z.object({ apiKey: z.string().min(1) });
+/** Structured Krisp REST failure. */
+export class KrispApiError extends Error {
+    /** Normalized provider error payload, when valid JSON was returned. */
+    body;
+    /** Retry delay in seconds, when Krisp returned one. */
+    retryAfter;
+    /** HTTP status returned by Krisp. */
+    status;
+    /**
+     * Creates a structured Krisp API error.
+     *
+     * @param options - Provider status, body, and retry metadata.
+     * @param options.body - Normalized provider error body.
+     * @param options.retryAfter - Retry delay in seconds.
+     * @param options.status - HTTP status.
+     */
+    constructor(options) {
+        super(getErrorMessage(options.body) ??
+            `Krisp API request failed with status ${options.status}.`);
+        this.name = "KrispApiError";
+        this.body = options.body;
+        this.retryAfter = options.retryAfter;
+        this.status = options.status;
+    }
+}
+/**
+ * Creates an authenticated Krisp Meeting Assistant REST client.
+ *
+ * @param secret - Resolved Krisp API-key secret.
+ */
+export function getKrispApi(secret) {
+    const { apiKey } = KRISP_SECRET_SCHEMA.parse(secret);
+    return {
+        /**
+         * Runs one Krisp request and returns its normalized response.
+         *
+         * @param path - API path relative to the v1 root.
+         * @param options - Method, parameters, and response schema.
+         */
+        async request(path, options) {
+            const url = new URL(path.replace(/^\//, ""), KRISP_API_BASE_URL);
+            if (url.origin !== KRISP_API_ORIGIN) {
+                throw new Error("Krisp API paths must use the Krisp API origin.");
+            }
+            for (const [name, value] of Object.entries(options.query ?? {})) {
+                if (value === undefined)
+                    continue;
+                url.searchParams.set(toSnakeCase(name), Array.isArray(value) ? value.join(",") : String(value));
+            }
+            const response = await fetch(url, {
+                body: options.body === undefined
+                    ? undefined
+                    : JSON.stringify(toKrisp(options.body)),
+                headers: {
+                    Accept: "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                    ...(options.body === undefined
+                        ? {}
+                        : { "Content-Type": "application/json" }),
+                },
+                method: options.method ?? "GET",
+            });
+            const normalized = fromKrisp(parseJson(await response.text()));
+            if (!response.ok) {
+                const body = encodableSchema.safeParse(normalized);
+                throw new KrispApiError({
+                    ...(body.success && { body: body.data }),
+                    retryAfter: parseFiniteNumber(response.headers.get("Retry-After")),
+                    status: response.status,
+                });
+            }
+            return options.responseSchema.parse(normalized);
+        },
+    };
+}
+/**
+ * Converts public camelCase JSON to Krisp wire keys.
+ *
+ * @param value - Public value to normalize.
+ */
+export function toKrisp(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(toKrisp);
+    if (!isPlainObject(value))
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        toSnakeCase(key),
+        toKrisp(item),
+    ]));
+}
+/**
+ * Converts Krisp wire JSON to public camelCase keys.
+ *
+ * @param value - Provider value to normalize.
+ */
+export function fromKrisp(value) {
+    if (Array.isArray(value))
+        return value.map(fromKrisp);
+    if (!isPlainObject(value))
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        toCamelCase(key),
+        fromKrisp(item),
+    ]));
+}
+/**
+ * Checks whether a value is a key-value object.
+ *
+ * @param value - Candidate value.
+ */
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Parses a JSON response body without obscuring the HTTP status on failure.
+ *
+ * @param value - Raw response text.
+ */
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parses an optional finite numeric header.
+ *
+ * @param value - Raw header value.
+ */
+function parseFiniteNumber(value) {
+    if (value === null)
+        return undefined;
+    const number = Number(value);
+    return Number.isFinite(number) ? number : undefined;
+}
+/**
+ * Extracts Krisp's human-readable error string.
+ *
+ * @param body - Normalized provider error body.
+ */
+function getErrorMessage(body) {
+    return isPlainObject(body) && typeof body.error === "string"
+        ? body.error
+        : undefined;
+}
+/**
+ * Converts one public camelCase key to Krisp snake_case.
+ *
+ * @param value - Public key.
+ */
+function toSnakeCase(value) {
+    return value.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+/**
+ * Converts one Krisp snake_case key to public camelCase.
+ *
+ * @param value - Provider key.
+ */
+function toCamelCase(value) {
+    return value.replace(/_([a-z0-9])/g, (_, letter) => letter.toUpperCase());
+}

package/dist/krisp/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api.js";
+export * from "./schemas.js";

package/dist/krisp/index.js

@@ -0,0 +1,2 @@
+export * from "./api.js";
+export * from "./schemas.js";

package/dist/krisp/schemas.d.ts

@@ -0,0 +1,145 @@
+import * as z from "zod";
+import type { Encodable } from "@automate.ax/codec";
+/** Krisp profile represented by a personal API key. */
+export declare const KRISP_PROFILE_SCHEMA: z.ZodObject<{
+    avatar: z.ZodPrefault<z.ZodNullable<z.ZodURL>>;
+    email: z.ZodEmail;
+    firstName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    id: z.ZodNumber;
+    lastName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    teamId: z.ZodNumber;
+    workspaceId: z.ZodNumber;
+}, z.core.$strip>;
+/** Calendar attendee or diarized speaker attached to a Krisp meeting. */
+export declare const KRISP_PARTICIPANT_SCHEMA: z.ZodObject<{
+    email: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    firstName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    lastName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    photo: z.ZodPrefault<z.ZodNullable<z.ZodURL>>;
+    status: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** Meeting metadata returned by Krisp list and detail endpoints. */
+export declare const KRISP_MEETING_SCHEMA: z.ZodObject<{
+    duration: z.ZodNullable<z.ZodNumber>;
+    id: z.ZodString;
+    ownership: z.ZodEnum<{
+        shared: "shared";
+        owned: "owned";
+    }>;
+    participants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        email: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        firstName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        lastName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        photo: z.ZodPrefault<z.ZodNullable<z.ZodURL>>;
+        status: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    source: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodNullable<z.ZodISODateTime>;
+    status: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    title: z.ZodString;
+}, z.core.$strip>;
+/** One diarized transcript segment. Times are seconds from recording start. */
+export declare const KRISP_TRANSCRIPT_SEGMENT_SCHEMA: z.ZodObject<{
+    end: z.ZodNumber;
+    speaker: z.ZodNumber;
+    start: z.ZodNumber;
+    text: z.ZodString;
+}, z.core.$strip>;
+declare const KRISP_NOTE_ASSIGNEE_SCHEMA: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+export interface KrispNoteBlock {
+    [key: string]: Encodable;
+    assignee?: z.output<typeof KRISP_NOTE_ASSIGNEE_SCHEMA> | null;
+    children?: KrispNoteBlock[];
+    completed?: boolean | null;
+    dueDate?: string | null;
+    text?: string;
+    type: string;
+}
+/** Recursive block returned by Krisp's fixed and custom meeting-note sections. */
+export declare const KRISP_NOTE_BLOCK_SCHEMA: z.ZodType<KrispNoteBlock>;
+/** Complete Krisp meeting detail with optional heavy transcript and note data. */
+export declare const KRISP_MEETING_DETAIL_SCHEMA: z.ZodObject<{
+    duration: z.ZodNullable<z.ZodNumber>;
+    id: z.ZodString;
+    ownership: z.ZodEnum<{
+        shared: "shared";
+        owned: "owned";
+    }>;
+    participants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        email: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        firstName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        lastName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        photo: z.ZodPrefault<z.ZodNullable<z.ZodURL>>;
+        status: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    source: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodNullable<z.ZodISODateTime>;
+    status: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    title: z.ZodString;
+    language: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    meetingType: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        blocks: z.ZodArray<z.ZodType<KrispNoteBlock, unknown, z.core.$ZodTypeInternals<KrispNoteBlock, unknown>>>;
+    }, z.core.$strip>>>;
+    transcript: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        language: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        segments: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+            end: z.ZodNumber;
+            speaker: z.ZodNumber;
+            start: z.ZodNumber;
+            text: z.ZodString;
+        }, z.core.$strip>>>;
+        speakers: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            email: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+            firstName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+            lastName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+            photo: z.ZodPrefault<z.ZodNullable<z.ZodURL>>;
+            status: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** One action item extracted from a Krisp meeting. */
+export declare const KRISP_ACTION_ITEM_SCHEMA: z.ZodObject<{
+    assignee: z.ZodPrefault<z.ZodNullable<z.ZodObject<{
+        email: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        firstName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        lastName: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+        photo: z.ZodPrefault<z.ZodNullable<z.ZodURL>>;
+        status: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    completed: z.ZodPrefault<z.ZodNullable<z.ZodBoolean>>;
+    dueDate: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    id: z.ZodString;
+    meetingId: z.ZodString;
+    meetingStartedAt: z.ZodPrefault<z.ZodNullable<z.ZodISODateTime>>;
+    meetingTitle: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+/** Tag used to organize Krisp meetings. */
+export declare const KRISP_TAG_SCHEMA: z.ZodObject<{
+    color: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+/** Recording-import identity returned after Krisp issues an upload URL. */
+export declare const KRISP_IMPORT_SCHEMA: z.ZodObject<{
+    expiresAt: z.ZodISODateTime;
+    importId: z.ZodString;
+    url: z.ZodURL;
+}, z.core.$strip>;
+/** Current processing state for a Krisp recording import. */
+export declare const KRISP_IMPORT_STATUS_SCHEMA: z.ZodObject<{
+    error: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    importId: z.ZodString;
+    meetingId: z.ZodPrefault<z.ZodNullable<z.ZodString>>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        ready: "ready";
+        uploading: "uploading";
+        processing: "processing";
+    }>;
+}, z.core.$strip>;
+export {};