@salsita-ai/contracts 0.0.0-stage → 0.49.0-develop.d4bea2382c

package/dist/webhook/implementation/webhook-tunnel-types.d.ts

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+/** A webhook invocation waiting for a connected development client. */
+export declare const TunneledWebhookRequest: z.ZodObject<{
+    requestId: z.ZodString;
+    url: z.ZodString;
+    method: z.ZodString;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    body: z.ZodNullable<z.ZodString>;
+    deadline: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body: string | null;
+    deadline: number;
+}, {
+    requestId: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body: string | null;
+    deadline: number;
+}>;
+export type TunneledWebhookRequest = z.infer<typeof TunneledWebhookRequest>;
+/** The development client's response to a tunneled webhook invocation. */
+export declare const TunneledWebhookResponse: z.ZodObject<{
+    status: z.ZodNumber;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: number;
+    headers?: Record<string, string> | undefined;
+    body: string;
+}, {
+    status: number;
+    headers?: Record<string, string> | undefined;
+    body: string;
+}>;
+export type TunneledWebhookResponse = z.infer<typeof TunneledWebhookResponse>;
+/** Payload used to claim a development deployment and wait for its next webhook request. */
+export declare const WebhookTunnelPollRequest: z.ZodObject<{
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+}, {
+    sessionId: string;
+}>;
+export type WebhookTunnelPollRequest = z.infer<typeof WebhookTunnelPollRequest>;
+/** Result of waiting for the next tunneled webhook request. */
+export declare const WebhookTunnelPollResponse: z.ZodObject<{
+    request: z.ZodNullable<z.ZodObject<{
+        requestId: z.ZodString;
+        url: z.ZodString;
+        method: z.ZodString;
+        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        body: z.ZodNullable<z.ZodString>;
+        deadline: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        requestId: string;
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        body: string | null;
+        deadline: number;
+    }, {
+        requestId: string;
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        body: string | null;
+        deadline: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    request: {
+        requestId: string;
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        body: string | null;
+        deadline: number;
+    } | null;
+}, {
+    request: {
+        requestId: string;
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        body: string | null;
+        deadline: number;
+    } | null;
+}>;
+export type WebhookTunnelPollResponse = z.infer<typeof WebhookTunnelPollResponse>;
+/** Payload used by a development client to answer a tunneled webhook request. */
+export declare const WebhookTunnelRespondRequest: z.ZodObject<{
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    status: z.ZodNumber;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    requestId: string;
+    status: number;
+    headers?: Record<string, string> | undefined;
+    body: string;
+}, {
+    sessionId: string;
+    requestId: string;
+    status: number;
+    headers?: Record<string, string> | undefined;
+    body: string;
+}>;
+export type WebhookTunnelRespondRequest = z.infer<typeof WebhookTunnelRespondRequest>;

package/dist/webhook/implementation/webhook-tunnel-types.js

@@ -0,0 +1 @@
+import{z as e}from"zod";export const TunneledWebhookRequest=e.object({requestId:e.string(),url:e.string(),method:e.string(),headers:e.record(e.string()),body:e.string().nullable(),deadline:e.number()});export const TunneledWebhookResponse=e.object({status:e.number().int(),headers:e.record(e.string()).optional(),body:e.string()});export const WebhookTunnelPollRequest=e.object({sessionId:e.string()});export const WebhookTunnelPollResponse=e.object({request:TunneledWebhookRequest.nullable()});export const WebhookTunnelRespondRequest=e.object({sessionId:e.string(),requestId:e.string(),status:e.number().int(),headers:e.record(e.string()).optional(),body:e.string()});

package/dist/webhook/index.d.ts

@@ -0,0 +1,7 @@
+export * from './core/index.js';
+export * from './tasks/index.js';
+export * from './implementation/index.js';
+export * from './spreadsheet-adapter.js';
+export * from './spreadsheet-adapter-factory.js';
+export * from './google-sheets-client.js';
+export * from './excel-workbook-client.js';

package/dist/webhook/index.js

@@ -0,0 +1 @@
+export*from"./core/index.js";export*from"./tasks/index.js";export*from"./implementation/index.js";export*from"./spreadsheet-adapter.js";export*from"./spreadsheet-adapter-factory.js";export*from"./google-sheets-client.js";export*from"./excel-workbook-client.js";

package/dist/webhook/spreadsheet-adapter-factory.d.ts

@@ -0,0 +1,10 @@
+import type { SpreadsheetAdapter } from './spreadsheet-adapter.js';
+/**
+ * Providers supported by the `SpreadsheetAdapter` factory. This is *not* the
+ * same as `OAuthConnectionProvider` — that type only covers providers that
+ * use per-user OAuth (Google). Microsoft uses app-only auth and isn't an
+ * "OAuth connection", but it *does* have a SpreadsheetAdapter implementation.
+ */
+export type SpreadsheetProvider = 'google' | 'microsoft';
+export declare const asOAuthConnectionProvider: (provider: string) => SpreadsheetProvider;
+export declare const getSpreadsheetAdapter: (provider: SpreadsheetProvider | string) => SpreadsheetAdapter;

package/dist/webhook/spreadsheet-adapter-factory.js

@@ -0,0 +1 @@
+import{match as e}from"ts-pattern";import{excelSpreadsheetAdapter as o}from"./excel-workbook-client.js";import{googleSpreadsheetAdapter as t}from"./google-sheets-client.js";export const asOAuthConnectionProvider=e=>{if("google"!==e&&"microsoft"!==e)throw Error(`Unknown spreadsheet provider "${e}". Expected 'google' or 'microsoft'. ConnectedDataConfig.provider is typed as string at the schema layer; runtime values must be one of the supported SpreadsheetProvider literals.`);return e};export const getSpreadsheetAdapter=r=>e(asOAuthConnectionProvider(r)).with("google",()=>t).with("microsoft",()=>o).exhaustive();

package/dist/webhook/spreadsheet-adapter.d.ts

@@ -0,0 +1,94 @@
+import type { OAuthConnectionProvider } from '../domain/index.js';
+export type CellValue = string | number | boolean;
+export interface ColumnMeta {
+    readonly type: 'string' | 'number' | 'integer' | 'boolean';
+    readonly enum?: ReadonlyArray<string | number>;
+    readonly array?: true;
+}
+/**
+ * Discriminated kinds of failure that can come back from a spreadsheet
+ * provider. Both adapters map provider-specific HTTP statuses onto this
+ * union so UI code can branch on `kind` instead of parsing message strings.
+ */
+export type SpreadsheetAdapterErrorKind = 'auth' | 'forbidden' | 'not-found' | 'rate-limit' | 'locked' | 'unknown';
+/**
+ * Error thrown by every SpreadsheetAdapter implementation. The full
+ * provider-specific message is preserved in `.message`; callers that want
+ * to react to *kinds* of failure (re-auth prompt, retry, etc.) should
+ * branch on `.kind` instead.
+ */
+export declare class SpreadsheetAdapterError extends Error {
+    readonly kind: SpreadsheetAdapterErrorKind;
+    readonly provider: 'google' | 'microsoft';
+    readonly status: number;
+    readonly action: string;
+    readonly bodyExcerpt: string;
+    constructor(props: {
+        readonly kind: SpreadsheetAdapterErrorKind;
+        readonly provider: 'google' | 'microsoft';
+        readonly status: number;
+        readonly action: string;
+        readonly bodyExcerpt: string;
+        readonly message: string;
+    });
+}
+/**
+ * Normalizes a CellValue for *writing* based on the column type. Used by
+ * both adapters so coercion semantics match across providers:
+ * - boolean columns: string 'true'/'false' (any case) → real boolean
+ * - number/integer columns: numeric string → number (empty string stays "")
+ * - string columns / no meta: value passed through unchanged
+ *
+ * Non-numeric strings written into a number column stay as the original
+ * string — callers can decide whether to validate before writing.
+ */
+export declare const normalizeCellOnWrite: (value: CellValue, col?: ColumnMeta) => CellValue;
+export interface SheetTabData {
+    readonly headers: readonly string[];
+    readonly rows: ReadonlyArray<readonly string[]>;
+}
+export interface SpreadsheetMeta {
+    readonly tabs: readonly string[];
+}
+export interface LegendTabData {
+    readonly tabName: string;
+    readonly rows: ReadonlyArray<readonly [string, string, string, string]>;
+}
+/**
+ * Provider-agnostic file reference. driveId is null for Google (single-drive
+ * model), required for Microsoft Graph (drive + item id pair). Mirrors the
+ * shape stored on `ConnectedDataConfig`.
+ */
+export interface SpreadsheetFileRef {
+    readonly fileId: string;
+    readonly driveId: string | null;
+}
+export interface CreateSpreadsheetResult {
+    readonly fileId: string;
+    readonly driveId: string | null;
+    readonly title: string;
+}
+/**
+ * Provider-specific location context for createWorkbook. Google ignores it
+ * (creates in the connected user's Drive). Microsoft requires `siteId` so the
+ * file is created in the project's configured SharePoint site's default
+ * document library.
+ */
+export interface CreateWorkbookLocation {
+    readonly siteId?: string;
+}
+export interface SpreadsheetAdapter {
+    fetchMeta: (accessToken: string, ref: SpreadsheetFileRef) => Promise<SpreadsheetMeta>;
+    fetchTabHeaders: (accessToken: string, ref: SpreadsheetFileRef, tabName: string) => Promise<readonly string[]>;
+    /**
+     * Fetches all data from the given tabs/worksheets.
+     * `headerRowIndex` (0-based) selects which row to treat as headers; rows
+     * above it are dropped, rows after it become data. `null`/`undefined`
+     * defaults to row 0 — preserves prior behavior.
+     */
+    fetchData: (accessToken: string, ref: SpreadsheetFileRef, tabNames: readonly string[], headerRowIndex?: number | null) => Promise<readonly SheetTabData[]>;
+    createWorkbook: (accessToken: string, title: string, headers: readonly string[], values?: ReadonlyArray<readonly CellValue[]>, columns?: readonly ColumnMeta[], dataTabName?: string, legendTab?: LegendTabData, location?: CreateWorkbookLocation) => Promise<CreateSpreadsheetResult>;
+    resetData: (accessToken: string, ref: SpreadsheetFileRef, tabNames: readonly string[], headers: readonly string[], values: ReadonlyArray<readonly CellValue[]>, columns?: readonly ColumnMeta[], legendTab?: LegendTabData) => Promise<void>;
+}
+export declare const isRowEmpty: (row: readonly CellValue[]) => boolean;
+export type SpreadsheetAdapterFactory = (provider: OAuthConnectionProvider) => SpreadsheetAdapter;

package/dist/webhook/spreadsheet-adapter.js

@@ -0,0 +1 @@
+export class SpreadsheetAdapterError extends Error{kind;provider;status;action;bodyExcerpt;constructor(e){super(e.message),this.name="SpreadsheetAdapterError",this.kind=e.kind,this.provider=e.provider,this.status=e.status,this.action=e.action,this.bodyExcerpt=e.bodyExcerpt}}export const normalizeCellOnWrite=(e,r)=>{if("string"!=typeof e)return e;if(r?.type==="boolean"){let r=e.toLowerCase();return"true"===r||"false"!==r&&e}if(r?.type==="number"||r?.type==="integer"){if(""===e)return e;let r=Number(e);if(!isNaN(r))return r}return e};export const isRowEmpty=e=>e.every(e=>{let r=String(e).trim().toUpperCase();return""===r||"FALSE"===r||"0"===r});

package/dist/webhook/tasks/call-lambda-back-task.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { ValueOf } from '@salsita-ai/common/utils';
+import { type FinalizeTaskResource, TaskType } from '../core/index.js';
+export declare const CallLambdaBackResourceType: {
+    readonly Link: 'Link';
+};
+export type CallLambdaBackResourceType = ValueOf<typeof CallLambdaBackResourceType>;
+export interface CallLambdaBackResource {
+    /**
+     * Lambda callback supports only link type. Embedding data into the task result would mean
+     * using multiplart/form-data, which would make things more complicated.
+     */
+    embeddingType: CallLambdaBackResourceType;
+}
+export declare const CallLambdaBackResource: z.ZodType<CallLambdaBackResource>;
+export interface CallLambdaBackTask<REPLAY_DATA extends Record<string, unknown>, RESOURCE extends string> {
+    type: typeof TaskType.CallLambdaBack;
+    replayData: REPLAY_DATA;
+    resources: Partial<Record<RESOURCE, CallLambdaBackResource>>;
+}
+export declare const CallLambdaBackTask: z.ZodType<CallLambdaBackTask<Record<string, unknown>, string>>;
+export declare const validateCallLambdaBackTask: (task: CallLambdaBackTask<Record<string, unknown>, string>, resources: FinalizeTaskResource[]) => void;

package/dist/webhook/tasks/call-lambda-back-task.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{TaskType as a}from"../core/index.js";export const CallLambdaBackResourceType={Link:"Link"};export const CallLambdaBackResource=e.object({embeddingType:e.literal(CallLambdaBackResourceType.Link)});export const CallLambdaBackTask=e.object({type:e.literal(a.CallLambdaBack),replayData:e.record(e.unknown()),resources:e.record(CallLambdaBackResource)});export const validateCallLambdaBackTask=(e,a)=>{for(let[r,o]of Object.entries(e.resources)){if(o?.embeddingType!==CallLambdaBackResourceType.Link)throw Error(`Resource ${r} has unsupported embedding type ${o?.embeddingType}`);if(null==a.find(e=>e.name===r))throw Error(`Resource ${r} not found in declared resources!`)}};

package/dist/webhook/tasks/edit-google-spreadsheet-task.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import type { ValueOf } from '@salsita-ai/common/utils';
+import { TaskResourceType, TaskType } from '../core/index.js';
+export declare const GoogleSpreadsheetEditMode: {
+    /**
+     * Append a row or rows
+     */
+    readonly Append: 'append';
+    /**
+     * Overwrite the range
+     */
+    readonly Overwrite: 'overwrite';
+};
+export type GoogleSpreadsheetEditMode = ValueOf<typeof GoogleSpreadsheetEditMode>;
+export interface GoogleSpreadsheetReference {
+    type: typeof TaskResourceType.ConfigurationLink;
+    name: string;
+}
+export declare const GoogleSpreadsheetReference: z.ZodType<GoogleSpreadsheetReference>;
+export type GoogleSpreadsheetCellValue = string | number | boolean | GoogleSpreadsheetReference;
+export declare const GoogleSpreadsheetCellValue: z.ZodType<GoogleSpreadsheetCellValue>;
+export interface GoogleSpreadsheetEdit {
+    /**
+     * Ranges of cells to edit
+     */
+    ranges: Record<string, GoogleSpreadsheetCellValue[][]>;
+    /**
+     * Edit mode
+     */
+    mode: GoogleSpreadsheetEditMode;
+}
+export declare const GoogleSpreadsheetEdit: z.ZodType<GoogleSpreadsheetEdit>;
+export interface EditGoogleSpreadsheetTask {
+    type: typeof TaskType.EditGoogleSpreadsheet;
+    /**
+     * Service account credentials
+     */
+    credentials: Record<string, string>;
+    /**
+     * The ID of the spreadsheet
+     */
+    spreadsheetId: string;
+    /**
+     * Any edits to be made to the spreadsheet
+     */
+    edits: GoogleSpreadsheetEdit[];
+}
+export declare const EditGoogleSpreadsheetTask: z.ZodType<EditGoogleSpreadsheetTask>;

package/dist/webhook/tasks/edit-google-spreadsheet-task.js

@@ -0,0 +1 @@
+import{z as e}from"zod";import{TaskResourceType as o,TaskType as r}from"../core/index.js";export const GoogleSpreadsheetEditMode={Append:"append",Overwrite:"overwrite"};export const GoogleSpreadsheetReference=e.object({type:e.literal(o.ConfigurationLink),name:e.string()});export const GoogleSpreadsheetCellValue=e.union([e.string(),e.number(),e.boolean(),GoogleSpreadsheetReference]);export const GoogleSpreadsheetEdit=e.object({ranges:e.record(e.array(e.array(GoogleSpreadsheetCellValue))),mode:e.union([e.literal(GoogleSpreadsheetEditMode.Append),e.literal(GoogleSpreadsheetEditMode.Overwrite)])});export const EditGoogleSpreadsheetTask=e.object({type:e.literal(r.EditGoogleSpreadsheet),credentials:e.record(e.string()),spreadsheetId:e.string(),edits:e.array(GoogleSpreadsheetEdit)});

package/dist/webhook/tasks/finalize-task.d.ts

@@ -0,0 +1,184 @@
+import { z } from 'zod';
+import { FinalizeTaskResource } from '../core/task-resource.js';
+import { CallLambdaBackTask } from './call-lambda-back-task.js';
+import { EditGoogleSpreadsheetTask } from './edit-google-spreadsheet-task.js';
+import { GenerateConfigurationLinkTask } from './generate-configuration-link-task.js';
+import { GenerateCsvTask } from './generate-csv-task.js';
+import { GenerateImagesTask } from './generate-images-task.js';
+import { GeneratePdfTask, GenerateStaticPdfTask } from './generate-pdf-task.js';
+import { PublishRevisionChunksStagedTask } from './publish-revision-chunks-staged-task.js';
+import { PublishRevisionChunksTask } from './publish-revision-chunks-task.js';
+import { PublishRevisionTask } from './publish-revision-task.js';
+import { SendEmailTask, SendStaticEmailTask } from './send-email-task.js';
+import { SendHttpRequestTask } from './send-http-task.js';
+import { WooCommerceAddToCartTask } from './woocommerce-add-to-cart-task.js';
+export type WebhookFinalizeTask = GenerateConfigurationLinkTask | SendEmailTask | SendStaticEmailTask | GenerateImagesTask | GeneratePdfTask | GenerateStaticPdfTask | GenerateCsvTask | SendHttpRequestTask | WooCommerceAddToCartTask | EditGoogleSpreadsheetTask | PublishRevisionTask | PublishRevisionChunksTask | PublishRevisionChunksStagedTask | CallLambdaBackTask<Record<string, unknown>, string>;
+export interface WebhookFinalizeTaskConfiguration {
+    /**
+     * Version of the data used to check compatibility of the server and deployed webhooks, BUMP IT UP WHEN introducing breaking CHANGING THE SCHEMA!!!!
+     */
+    dataVersion: 1;
+    /**
+     * The tasks to be executed as part of the finalize configuration
+     * They are executed in order and can reuse the resources generated by the previous tasks
+     *
+     *  GenerateConfigurationLinkTask / PublishRevisionTask => GenerateImages => GenerateCsv => GeneratePdf => SendEmail => SendHttpRequest => WooCommerceAddToCart => EditGoogleSpreadsheet
+     */
+    tasks: WebhookFinalizeTask[];
+    /**
+     * The resources that are generated as part of the finalize configuration, these are validated against the tasks
+     */
+    resources: FinalizeTaskResource[];
+}
+export declare const WebhookFinalizeTaskConfiguration: z.ZodObject<{
+    dataVersion: z.ZodLiteral<1>;
+    tasks: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"GenerateConfigurationLink">;
+        name: z.ZodString;
+        frontendUrl: z.ZodEffects<z.ZodString, import("../../domain/index.js").FrontendUrl, string>;
+        expiration: z.ZodOptional<z.ZodNumber>;
+        access: z.ZodUnion<[z.ZodLiteral<"o">, z.ZodLiteral<"rr">, z.ZodLiteral<"r">]>;
+        configurationId: z.ZodEffects<z.ZodString, import("../../domain/index.js").ConfigurationId, string>;
+        revisionId: z.ZodEffects<z.ZodOptional<z.ZodString>, import("../../domain/index.js").RevisionId | undefined, string | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        type: "GenerateConfigurationLink";
+        name: string;
+        frontendUrl: string & import("@salsita-ai/common/utils").Brand<"FrontendUrl">;
+        expiration?: number | undefined;
+        access: "o" | "r" | "rr";
+        configurationId: string & import("@salsita-ai/common/utils").Brand<"ConfigurationId">;
+        revisionId?: import("../../domain/index.js").RevisionId | undefined;
+    }, {
+        type: "GenerateConfigurationLink";
+        name: string;
+        frontendUrl: string;
+        expiration?: number | undefined;
+        access: "o" | "r" | "rr";
+        configurationId: string;
+        revisionId?: string | undefined;
+    }>, z.ZodType<SendEmailTask, z.ZodTypeDef, SendEmailTask>, z.ZodType<SendStaticEmailTask, z.ZodTypeDef, SendStaticEmailTask>, z.ZodType<GenerateImagesTask, z.ZodTypeDef, GenerateImagesTask>, z.ZodType<GeneratePdfTask, z.ZodTypeDef, GeneratePdfTask>, z.ZodType<GenerateStaticPdfTask, z.ZodTypeDef, GenerateStaticPdfTask>, z.ZodType<GenerateCsvTask, z.ZodTypeDef, GenerateCsvTask>, z.ZodType<SendHttpRequestTask, z.ZodTypeDef, SendHttpRequestTask>, z.ZodType<WooCommerceAddToCartTask, z.ZodTypeDef, WooCommerceAddToCartTask>, z.ZodType<EditGoogleSpreadsheetTask, z.ZodTypeDef, EditGoogleSpreadsheetTask>, z.ZodObject<{
+        type: z.ZodLiteral<"PublishRevision">;
+        version: z.ZodEffects<z.ZodNumber, import("../../domain/index.js").PublishedDataRevisionVersion, number>;
+        revisionId: z.ZodEffects<z.ZodString, import("../../domain/index.js").RevisionId, string>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        type: "PublishRevision";
+        version: number & import("@salsita-ai/common/utils").Brand<"PublishedDataRevisionVersion">;
+        revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+        data: Record<string, unknown>;
+    }, {
+        type: "PublishRevision";
+        version: number;
+        revisionId: string;
+        data: Record<string, unknown>;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"PublishRevisionChunks">;
+        revisionId: z.ZodEffects<z.ZodString, import("../../domain/index.js").RevisionId, string>;
+        chunks: z.ZodArray<z.ZodObject<{
+            key: z.ZodEffects<z.ZodString, import("../../domain/index.js").ChunkKey, string>;
+            scope: z.ZodEffects<z.ZodString, import("../../domain/index.js").ChunkScope, string>;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            key: string & import("@salsita-ai/common/utils").Brand<"ChunkKey">;
+            scope: string & import("@salsita-ai/common/utils").Brand<"ChunkScope">;
+            data: Record<string, unknown>;
+        }, {
+            key: string;
+            scope: string;
+            data: Record<string, unknown>;
+        }>, "many">;
+        publishedDataHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "PublishRevisionChunks";
+        revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+        chunks: {
+            key: string & import("@salsita-ai/common/utils").Brand<"ChunkKey">;
+            scope: string & import("@salsita-ai/common/utils").Brand<"ChunkScope">;
+            data: Record<string, unknown>;
+        }[];
+        publishedDataHash: string;
+    }, {
+        type: "PublishRevisionChunks";
+        revisionId: string;
+        chunks: {
+            key: string;
+            scope: string;
+            data: Record<string, unknown>;
+        }[];
+        publishedDataHash: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"PublishRevisionChunksStaged">;
+        revisionId: z.ZodEffects<z.ZodString, import("../../domain/index.js").RevisionId, string>;
+        publishedDataHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "PublishRevisionChunksStaged";
+        revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+        publishedDataHash: string;
+    }, {
+        type: "PublishRevisionChunksStaged";
+        revisionId: string;
+        publishedDataHash: string;
+    }>, z.ZodType<CallLambdaBackTask<Record<string, unknown>, string>, z.ZodTypeDef, CallLambdaBackTask<Record<string, unknown>, string>>]>, "many">;
+    resources: z.ZodArray<z.ZodType<FinalizeTaskResource<string>, z.ZodTypeDef, FinalizeTaskResource<string>>, "many">;
+}, "strip", z.ZodTypeAny, {
+    dataVersion: 1;
+    tasks: (CallLambdaBackTask<Record<string, unknown>, string> | EditGoogleSpreadsheetTask | GenerateCsvTask | GenerateImagesTask | GeneratePdfTask | GenerateStaticPdfTask | SendEmailTask | SendHttpRequestTask | SendStaticEmailTask | WooCommerceAddToCartTask | {
+        type: "GenerateConfigurationLink";
+        name: string;
+        frontendUrl: string & import("@salsita-ai/common/utils").Brand<"FrontendUrl">;
+        expiration?: number | undefined;
+        access: "o" | "r" | "rr";
+        configurationId: string & import("@salsita-ai/common/utils").Brand<"ConfigurationId">;
+        revisionId?: import("../../domain/index.js").RevisionId | undefined;
+    } | {
+        type: "PublishRevision";
+        version: number & import("@salsita-ai/common/utils").Brand<"PublishedDataRevisionVersion">;
+        revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+        data: Record<string, unknown>;
+    } | {
+        type: "PublishRevisionChunks";
+        revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+        chunks: {
+            key: string & import("@salsita-ai/common/utils").Brand<"ChunkKey">;
+            scope: string & import("@salsita-ai/common/utils").Brand<"ChunkScope">;
+            data: Record<string, unknown>;
+        }[];
+        publishedDataHash: string;
+    } | {
+        type: "PublishRevisionChunksStaged";
+        revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
+        publishedDataHash: string;
+    })[];
+    resources: FinalizeTaskResource<string>[];
+}, {
+    dataVersion: 1;
+    tasks: (CallLambdaBackTask<Record<string, unknown>, string> | EditGoogleSpreadsheetTask | GenerateCsvTask | GenerateImagesTask | GeneratePdfTask | GenerateStaticPdfTask | SendEmailTask | SendHttpRequestTask | SendStaticEmailTask | WooCommerceAddToCartTask | {
+        type: "GenerateConfigurationLink";
+        name: string;
+        frontendUrl: string;
+        expiration?: number | undefined;
+        access: "o" | "r" | "rr";
+        configurationId: string;
+        revisionId?: string | undefined;
+    } | {
+        type: "PublishRevision";
+        version: number;
+        revisionId: string;
+        data: Record<string, unknown>;
+    } | {
+        type: "PublishRevisionChunks";
+        revisionId: string;
+        chunks: {
+            key: string;
+            scope: string;
+            data: Record<string, unknown>;
+        }[];
+        publishedDataHash: string;
+    } | {
+        type: "PublishRevisionChunksStaged";
+        revisionId: string;
+        publishedDataHash: string;
+    })[];
+    resources: FinalizeTaskResource<string>[];
+}>;
+export declare const validateTaskConfiguration: (task: WebhookFinalizeTaskConfiguration) => void;

package/dist/webhook/tasks/finalize-task.js

@@ -0,0 +1 @@
+import{match as e}from"ts-pattern";import{z as t}from"zod";import{TaskType as a}from"../core/index.js";import{FinalizeTaskResource as i,TaskResourceType as r}from"../core/task-resource.js";import{CallLambdaBackTask as s,validateCallLambdaBackTask as o}from"./call-lambda-back-task.js";import{EditGoogleSpreadsheetTask as n}from"./edit-google-spreadsheet-task.js";import{GenerateConfigurationLinkTask as m}from"./generate-configuration-link-task.js";import{GenerateCsvTask as d}from"./generate-csv-task.js";import{GenerateImagesTask as k}from"./generate-images-task.js";import{GeneratePdfTask as f,GenerateStaticPdfTask as l,validateGeneratePdfTask as h,validateGenerateStaticPdfTask as p}from"./generate-pdf-task.js";import{PublishRevisionChunksStagedTask as u}from"./publish-revision-chunks-staged-task.js";import{PublishRevisionChunksTask as c}from"./publish-revision-chunks-task.js";import{PublishRevisionTask as g}from"./publish-revision-task.js";import{SendEmailTask as v,SendStaticEmailTask as y,validateSendEmailTask as b,validateSendStaticEmailTask as C}from"./send-email-task.js";import{SendHttpRequestTask as j}from"./send-http-task.js";import{WooCommerceAddToCartTask as w}from"./woocommerce-add-to-cart-task.js";export const WebhookFinalizeTaskConfiguration=t.object({dataVersion:t.literal(1),tasks:t.array(t.union([m,v,y,k,f,l,d,j,w,n,g,c,u,s])),resources:t.array(i)});export const validateTaskConfiguration=t=>{let i=t.resources.map(e=>e.name);if(new Set(i).size!==i.length){let e=i.filter((e,t)=>i.indexOf(e)!==t);throw Error(`The provided FinalizeTask configuration is invalid! Duplicate resource names: [${[...new Set(e)].join(", ")}].`)}t.resources.forEach(i=>{"exists"in i||"clientGenerated"in i||e(i.type).with(r.Image,()=>{if(!t.tasks.some(e=>e.type===a.GenerateImages&&e.images.some(e=>e.name===i.name)))throw Error(`The provided FinalizeTask configuration is invalid! Resource ${i.name} is not generated by any task. Create a GenerateImages task that generates the image.`)}).with(r.Csv,()=>{if(!t.tasks.some(e=>e.type===a.GenerateCsv&&e.name===i.name))throw Error(`The provided FinalizeTask configuration is invalid! Resource ${i.name} is not generated by any task. Create a GenerateCsv task that generates the CSV.`)}).with(r.Pdf,()=>{if(!t.tasks.some(e=>(e.type===a.GeneratePdf||e.type===a.GenerateStaticPdf)&&e.name===i.name))throw Error(`The provided FinalizeTask configuration is invalid! Resource ${i.name} is not generated by any task. Create a GeneratePdf or GenerateStaticPdf task that generates the PDF.`)}).with(r.ConfigurationLink,()=>{if(!t.tasks.some(e=>e.type===a.GenerateConfigurationLink&&e.name===i.name))throw Error(`The provided FinalizeTask configuration is invalid! Resource ${i.name} is not generated by any task. Create a GenerateConfigurationLink task that generates the configuration link.`)}).exhaustive()});let s=t.tasks.filter(e=>e.type===a.PublishRevision||e.type===a.PublishRevisionChunks||e.type===a.PublishRevisionChunksStaged).length;if(s>1)throw Error(`The provided FinalizeTask configuration is invalid! Only one publish task (PublishRevision, PublishRevisionChunks, or PublishRevisionChunksStaged) is allowed, found ${s}.`);t.tasks.forEach(e=>{e.type===a.GeneratePdf?h(e,t.resources):e.type===a.GenerateStaticPdf?p(e,t.resources):e.type===a.SendEmail?b(e,t.resources):e.type===a.SendStaticEmail?C(e,t.resources):e.type===a.CallLambdaBack&&o(e,t.resources)})};

package/dist/webhook/tasks/generate-configuration-link-task.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import type { AccessLevel } from '../../api/index.js';
+import { ConfigurationId, FrontendUrl, RevisionId } from '../../domain/index.js';
+import { TaskType } from '../core/index.js';
+export interface GenerateConfigurationLinkTask {
+    type: typeof TaskType.GenerateConfigurationLink;
+    /**
+     * The name of the resource to be generated
+     */
+    name: string;
+    /**
+     * The URL where the frontend is hosted
+     */
+    frontendUrl: FrontendUrl;
+    /**
+     * Expiration time of the generated link in hours, if not provided the link will not expire. Relevant only for revision links as owner links are always permanent.
+     */
+    expiration?: number;
+    /**
+     * The access level of the generated link
+     */
+    access: AccessLevel;
+    /**
+     * The ID of the configuration to generate the link for
+     */
+    configurationId: ConfigurationId;
+    /**
+     * The ID of the revision to generate the link for in the case of a revision link
+     */
+    revisionId?: RevisionId;
+}
+export declare const GenerateConfigurationLinkTask: z.ZodObject<{
+    type: z.ZodLiteral<"GenerateConfigurationLink">;
+    name: z.ZodString;
+    frontendUrl: z.ZodEffects<z.ZodString, FrontendUrl, string>;
+    expiration: z.ZodOptional<z.ZodNumber>;
+    access: z.ZodUnion<[z.ZodLiteral<"o">, z.ZodLiteral<"rr">, z.ZodLiteral<"r">]>;
+    configurationId: z.ZodEffects<z.ZodString, ConfigurationId, string>;
+    revisionId: z.ZodEffects<z.ZodOptional<z.ZodString>, RevisionId | undefined, string | undefined>;
+}, "strip", z.ZodTypeAny, {
+    type: "GenerateConfigurationLink";
+    name: string;
+    frontendUrl: string & import("@salsita-ai/common/utils").Brand<"FrontendUrl">;
+    expiration?: number | undefined;
+    access: "o" | "r" | "rr";
+    configurationId: string & import("@salsita-ai/common/utils").Brand<"ConfigurationId">;
+    revisionId?: RevisionId | undefined;
+}, {
+    type: "GenerateConfigurationLink";
+    name: string;
+    frontendUrl: string;
+    expiration?: number | undefined;
+    access: "o" | "r" | "rr";
+    configurationId: string;
+    revisionId?: string | undefined;
+}>;

package/dist/webhook/tasks/generate-configuration-link-task.js

@@ -0,0 +1 @@
+import{z as r}from"zod";import{usingOptionalType as o,usingType as i}from"@salsita-ai/common/utils";import{ConfigurationId as n,FrontendUrl as t,RevisionId as a}from"../../domain/index.js";import{TaskType as e}from"../core/index.js";export const GenerateConfigurationLinkTask=r.object({type:r.literal(e.GenerateConfigurationLink),name:r.string(),frontendUrl:r.string().transform(i(t)),expiration:r.number().optional(),access:r.union([r.literal("o"),r.literal("rr"),r.literal("r")]),configurationId:r.string().transform(i(n)),revisionId:r.string().optional().transform(o(a))});

package/dist/webhook/tasks/generate-csv-task.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { TaskType } from '../core/index.js';
+export interface GenerateCsvTask {
+    readonly type: typeof TaskType.GenerateCsv;
+    /**
+     * The name of the csv file
+     */
+    readonly name: string;
+    /**
+     * The columns of the csv file
+     */
+    readonly columns: readonly string[];
+    /**
+     * The data to be written to the csv file
+     */
+    readonly data: unknown[];
+    /**
+     * Prepend the byte order mark (BOM) to the output stream.
+     */
+    readonly bom?: boolean | undefined;
+    /**
+     * Set the field delimiter, one character only, defaults to a comma.
+     */
+    readonly delimiter?: string;
+    /**
+     * Display the column names on the first line if the columns option is provided or discovered.
+     */
+    readonly header?: boolean;
+}
+export declare const GenerateCsvTask: z.ZodType<GenerateCsvTask>;

package/dist/webhook/tasks/generate-csv-task.js

@@ -0,0 +1 @@
+import{z as o}from"zod";import{TaskType as e}from"../core/index.js";export const GenerateCsvTask=o.object({type:o.literal(e.GenerateCsv),name:o.string(),columns:o.array(o.string()),data:o.array(o.unknown()),bom:o.boolean().optional(),delimiter:o.string().optional(),header:o.boolean().optional()});