@isomorph.ai/app-sdk 1.33.0 → 1.34.0

package/dist/index.d.ts

@@ -1114,18 +1114,25 @@ export interface BooksLineInput {
 export interface BooksBillLineInput extends BooksLineInput {
     purchaseOrderItemId?: string;
 }
+export interface BooksInvoiceLineInput extends BooksLineInput {
+    salesOrderItemId?: string;
+}
 export interface BooksDocument {
     id: string;
     number: string;
     status: string;
     currency: string;
     total: string;
+    referenceNumber?: string;
     vendorId?: string;
     customerId?: string;
     lineItems: {
         itemId: string;
         lineItemId?: string;
         purchaseOrderItemId?: string;
+        sku?: string;
+        taxId?: string;
+        isInvoiced?: boolean;
         quantity: string;
         rate: string;
         total: string;
@@ -1146,6 +1153,43 @@ export type ZohoBooksRequest = {
         vendorId: string;
         pageToken?: string;
     };
+} | {
+    operation: 'zohobooks.salesorder.list';
+    resource: 'organization';
+    input: {
+        customerId: string;
+        pageToken?: string;
+    };
+} | {
+    operation: 'zohobooks.salesorder.read' | 'zohobooks.creditnote.read';
+    resource: 'organization';
+    input: {
+        documentId: string;
+    };
+} | {
+    operation: 'zohobooks.invoice.reviseDraft';
+    resource: 'organization';
+    idempotencyKey: string;
+    input: {
+        documentId: string;
+        lineItems: {
+            lineItemId: string;
+            quantity: string;
+        }[];
+    };
+} | {
+    operation: 'zohobooks.creditnote.create';
+    resource: 'organization';
+    idempotencyKey: string;
+    input: {
+        documentId: string;
+        documentDate: string;
+        referenceNumber?: string;
+        lineItems: {
+            lineItemId: string;
+            quantity: string;
+        }[];
+    };
 } | {
     operation: 'zohobooks.purchaseorder.read';
     resource: 'organization';
@@ -1178,7 +1222,7 @@ export type ZohoBooksRequest = {
         documentDate: string;
         documentNumber?: string;
         referenceNumber?: string;
-        lineItems: BooksLineInput[];
+        lineItems: BooksInvoiceLineInput[];
     };
 };
 export type IntegrationRequest = ZohoBooksRequest | ServiceRequest | SlackChannelHistoryRequest | SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest | SlackDmSendRequest | SlackUserLookupRequest | WarehouseViewReadRequest | WarehouseTableAppendRequest | PhoneSmsListRequest | PhoneNumberGetRequest | GmailThreadListRequest | GmailThreadReadRequest | GmailMessageReadRequest | GmailAttachmentReadRequest | GmailMessageSendRequest | BasecampProjectListRequest | BasecampTodolistListRequest | BasecampTodoListRequest | BasecampTodoCreateRequest | BasecampTodoCompleteRequest | BasecampMessageListRequest | BasecampMessagePostRequest | BasecampCommentListRequest | BasecampCommentPostRequest | BasecampCampfirePostRequest | BasecampPeopleListRequest | SharePointListListRequest | SharePointItemListRequest | SharePointItemCreateRequest | SharePointItemUpdateRequest | SharePointDriveListRequest | SharePointFileListRequest | SharePointFileSearchRequest | SharePointFileReadRequest | SharePointFileUploadRequest | CalendarCalendarListRequest | CalendarEventListRequest | CalendarEventReadRequest | CalendarEventCreateRequest | CalendarEventUpdateRequest | CalendarEventCancelRequest | DriveFileListRequest | DriveFileSearchRequest | DriveFileReadRequest | DriveFileUploadRequest | DriveFolderCreateRequest | DocsDocumentReadRequest | DocsDocumentCreateRequest | DocsDocumentAppendRequest | DocsTextReplaceRequest | SheetsSpreadsheetReadRequest | SheetsValuesReadRequest | SheetsValuesAppendRequest | SheetsValuesUpdateRequest | SheetsValuesClearRequest | SheetsSpreadsheetCreateRequest | OutlookMessageListRequest | OutlookMessageReadRequest | OutlookAttachmentReadRequest | OutlookMessageSendRequest | OutlookMessageReplyRequest | OutlookEventListRequest | OutlookEventReadRequest | OutlookEventCreateRequest | OutlookEventUpdateRequest | OutlookEventCancelRequest | OneDriveFileListRequest | OneDriveFileSearchRequest | OneDriveFileReadRequest | OneDriveFileUploadRequest | OneDriveFolderCreateRequest | ExcelWorksheetListRequest | ExcelRangeReadRequest | ExcelRangeUpdateRequest | ExcelTableListRequest | ExcelRowAddRequest | ExcelWorksheetAddRequest | TeamsMessageListRequest | TeamsMessagePostRequest | TeamsReplyPostRequest;
@@ -1685,6 +1729,12 @@ export type IntegrationResult<R extends IntegrationRequest> = R extends {
     }[];
     hasMore: boolean;
     nextPageToken?: string;
+} : R extends {
+    operation: 'zohobooks.salesorder.list';
+} ? {
+    booksSalesOrders: BooksDocument[];
+    hasMore: boolean;
+    nextPageToken?: string;
 } : R extends {
     operation: 'zohobooks.purchaseorder.list';
 } ? {
@@ -1694,7 +1744,7 @@ export type IntegrationResult<R extends IntegrationRequest> = R extends {
 } : R extends {
     operation: 'zohobooks.invoice.pdf';
 } ? GmailAttachmentReadResult : R extends {
-    operation: 'zohobooks.bill.create' | 'zohobooks.invoice.create';
+    operation: 'zohobooks.bill.create' | 'zohobooks.invoice.create' | 'zohobooks.invoice.reviseDraft' | 'zohobooks.creditnote.create';
 } ? {
     id: string;
 } : R extends ZohoBooksRequest ? {
@@ -1935,6 +1985,11 @@ export declare function createClient(options?: ClientOptions): {
         }) => Promise<T>;
     };
     jobs: {
+        /** Select the owner's folder for a declared configurable file trigger. */
+        configureTrigger: (name: string, configuration: {
+            folderId: string;
+        }) => Promise<JobTriggerStatus>;
+        getTrigger: (name: string) => Promise<JobTriggerStatus>;
         enqueue: (name: string, input?: unknown) => Promise<{
             id: string;
         }>;
@@ -1972,6 +2027,13 @@ export type HarbourResult<T> = IsomorphResult<T>;
 export type HarbourClient = IsomorphClient;
 /** @deprecated Internal transformation lane only; a kit app uses IsomorphCompatSource. */
 export type HarbourCompatSource = import('./supabase-compat.js').IsomorphCompatSource;
+/** Owner-selected folder; activation still requires the owner's background consent. */
+export interface JobTriggerStatus {
+    name: string;
+    folderId?: string;
+    state: 'configured' | 'unconfigured';
+    updatedAt?: string;
+}
 /** Provider file metadata delivered to a file.created job; bytes are read through its connection. */
 export interface FileArrivalInput {
     type: 'file.created';

package/dist/index.js

@@ -785,6 +785,9 @@ export function createClient(options = {}) {
             },
         },
         jobs: {
+            /** Select the owner's folder for a declared configurable file trigger. */
+            configureTrigger: (name, configuration) => transport.json('/_harbour/integrations/trigger-config', { method: 'POST', body: JSON.stringify({ name, configuration }) }),
+            getTrigger: (name) => transport.json('/_harbour/integrations/trigger-config', { method: 'POST', body: JSON.stringify({ name }) }),
             enqueue: (name, input) => transport.json('/_harbour/actions/isomorph-jobs-enqueue', { method: 'POST', body: JSON.stringify({ name, input: input ?? null }) }),
             get: (id) => transport.json('/_harbour/actions/isomorph-jobs-get', { method: 'POST', body: JSON.stringify({ id }) }),
             cancel: (id) => transport.json('/_harbour/actions/isomorph-jobs-cancel', { method: 'POST', body: JSON.stringify({ id }) }),

package/dist/integration-execute-input-rules.d.ts

@@ -2386,6 +2386,13 @@ export declare const IntegrationExecuteInputRules: {
                         readonly minLength: 0;
                         readonly maxLength: 2000;
                     };
+                    readonly salesOrderItemId: {
+                        readonly kind: "string";
+                        readonly required: false;
+                        readonly minLength: 0;
+                        readonly maxLength: 32;
+                        readonly pattern: "^[0-9]{1,32}$";
+                    };
                 };
             };
         };
@@ -2414,6 +2421,129 @@ export declare const IntegrationExecuteInputRules: {
             };
         };
     };
+    readonly "zohobooks.salesorder.list": {
+        readonly idempotencyKey: false;
+        readonly fields: {
+            readonly customerId: {
+                readonly kind: "string";
+                readonly required: true;
+                readonly minLength: 0;
+                readonly maxLength: 32;
+                readonly pattern: "^[0-9]{1,32}$";
+            };
+            readonly pageToken: {
+                readonly kind: "string";
+                readonly required: false;
+                readonly minLength: 1;
+                readonly maxLength: 2048;
+            };
+        };
+    };
+    readonly "zohobooks.salesorder.read": {
+        readonly idempotencyKey: false;
+        readonly fields: {
+            readonly documentId: {
+                readonly kind: "string";
+                readonly required: true;
+                readonly minLength: 0;
+                readonly maxLength: 32;
+                readonly pattern: "^[0-9]{1,32}$";
+            };
+        };
+    };
+    readonly "zohobooks.invoice.reviseDraft": {
+        readonly idempotencyKey: true;
+        readonly fields: {
+            readonly documentId: {
+                readonly kind: "string";
+                readonly required: true;
+                readonly minLength: 0;
+                readonly maxLength: 32;
+                readonly pattern: "^[0-9]{1,32}$";
+            };
+            readonly lineItems: {
+                readonly kind: "object[]";
+                readonly required: true;
+                readonly minItems: 1;
+                readonly maxItems: 100;
+                readonly fields: {
+                    readonly lineItemId: {
+                        readonly kind: "string";
+                        readonly required: true;
+                        readonly minLength: 0;
+                        readonly maxLength: 32;
+                        readonly pattern: "^[0-9]{1,32}$";
+                    };
+                    readonly quantity: {
+                        readonly kind: "string";
+                        readonly required: true;
+                        readonly minLength: 0;
+                        readonly maxLength: 17;
+                        readonly pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$";
+                    };
+                };
+            };
+        };
+    };
+    readonly "zohobooks.creditnote.create": {
+        readonly idempotencyKey: true;
+        readonly fields: {
+            readonly documentId: {
+                readonly kind: "string";
+                readonly required: true;
+                readonly minLength: 0;
+                readonly maxLength: 32;
+                readonly pattern: "^[0-9]{1,32}$";
+            };
+            readonly documentDate: {
+                readonly kind: "string";
+                readonly required: true;
+                readonly minLength: 0;
+                readonly maxLength: 10;
+                readonly pattern: "^[0-9]{4}-[0-9]{2}-[0-9]{2}$";
+            };
+            readonly referenceNumber: {
+                readonly kind: "string";
+                readonly required: false;
+                readonly minLength: 1;
+                readonly maxLength: 100;
+            };
+            readonly lineItems: {
+                readonly kind: "object[]";
+                readonly required: true;
+                readonly minItems: 1;
+                readonly maxItems: 100;
+                readonly fields: {
+                    readonly lineItemId: {
+                        readonly kind: "string";
+                        readonly required: true;
+                        readonly minLength: 0;
+                        readonly maxLength: 32;
+                        readonly pattern: "^[0-9]{1,32}$";
+                    };
+                    readonly quantity: {
+                        readonly kind: "string";
+                        readonly required: true;
+                        readonly minLength: 0;
+                        readonly maxLength: 17;
+                        readonly pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$";
+                    };
+                };
+            };
+        };
+    };
+    readonly "zohobooks.creditnote.read": {
+        readonly idempotencyKey: false;
+        readonly fields: {
+            readonly documentId: {
+                readonly kind: "string";
+                readonly required: true;
+                readonly minLength: 0;
+                readonly maxLength: 32;
+                readonly pattern: "^[0-9]{1,32}$";
+            };
+        };
+    };
 };
 export type IntegrationExecuteOperation = keyof typeof IntegrationExecuteInputRules;
 /** The upper bound of one integer input as a literal type: integrationExecuteInputMaximum('slack.channel.history', 'limit') is 15. */

package/dist/integration-execute-input-rules.js

@@ -729,6 +729,7 @@ export const IntegrationExecuteInputRules = {
                     rate: { kind: "string", required: true, minLength: 0, maxLength: 17, pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$" },
                     taxId: { kind: "string", required: false, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
                     description: { kind: "string", required: false, minLength: 0, maxLength: 2000 },
+                    salesOrderItemId: { kind: "string", required: false, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
                 } },
         },
     },
@@ -744,6 +745,47 @@ export const IntegrationExecuteInputRules = {
             documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
         },
     },
+    "zohobooks.salesorder.list": {
+        idempotencyKey: false,
+        fields: {
+            customerId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+            pageToken: { kind: "string", required: false, minLength: 1, maxLength: 2048 },
+        },
+    },
+    "zohobooks.salesorder.read": {
+        idempotencyKey: false,
+        fields: {
+            documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+        },
+    },
+    "zohobooks.invoice.reviseDraft": {
+        idempotencyKey: true,
+        fields: {
+            documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+            lineItems: { kind: "object[]", required: true, minItems: 1, maxItems: 100, fields: {
+                    lineItemId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+                    quantity: { kind: "string", required: true, minLength: 0, maxLength: 17, pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$" },
+                } },
+        },
+    },
+    "zohobooks.creditnote.create": {
+        idempotencyKey: true,
+        fields: {
+            documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+            documentDate: { kind: "string", required: true, minLength: 0, maxLength: 10, pattern: "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+            referenceNumber: { kind: "string", required: false, minLength: 1, maxLength: 100 },
+            lineItems: { kind: "object[]", required: true, minItems: 1, maxItems: 100, fields: {
+                    lineItemId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+                    quantity: { kind: "string", required: true, minLength: 0, maxLength: 17, pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$" },
+                } },
+        },
+    },
+    "zohobooks.creditnote.read": {
+        idempotencyKey: false,
+        fields: {
+            documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+        },
+    },
 };
 /** The upper bound of one integer input as a literal type: integrationExecuteInputMaximum('slack.channel.history', 'limit') is 15. */
 export function integrationExecuteInputMaximum(operation, field) {

package/dist/integration-operations.d.ts

@@ -623,4 +623,39 @@ export declare const IntegrationOperations: {
         readonly declaredMode: false;
         readonly idempotencyKey: false;
     };
+    readonly "zohobooks.salesorder.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "zohobooks.salesorder.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "zohobooks.invoice.reviseDraft": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "zohobooks.creditnote.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "zohobooks.creditnote.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
 };

package/dist/integration-operations.js

@@ -806,5 +806,50 @@ export const IntegrationOperations = {
         "readOnly": true,
         "declaredMode": false,
         "idempotencyKey": false
+    },
+    "zohobooks.salesorder.list": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
+    "zohobooks.salesorder.read": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
+    "zohobooks.invoice.reviseDraft": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": false,
+        "declaredMode": false,
+        "idempotencyKey": true
+    },
+    "zohobooks.creditnote.create": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": false,
+        "declaredMode": false,
+        "idempotencyKey": true
+    },
+    "zohobooks.creditnote.read": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
     }
 };

package/dist/jobs.d.ts

@@ -8,13 +8,14 @@ export interface EmailArrivalTrigger {
         subjectContains?: string;
     };
 }
-export declare const FILE_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"];
+export declare const FILE_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "image/png", "image/jpeg"];
 export declare const providerFileId: (value: unknown) => value is string;
 export interface FileCreatedTrigger {
     type: 'file.created';
     connection: string;
     resource: string;
-    folderId: string;
+    folderId?: string;
+    configurableFolder?: true;
     driveId?: string;
     mimeTypes?: string[];
 }

package/dist/jobs.js

@@ -6,7 +6,7 @@ import { stripTypeScriptTypes } from 'node:module';
 import { parse } from 'acorn';
 export const JOBS_DIR = 'jobs';
 const LOGICAL_NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/;
-export const FILE_MIME_TYPES = ['application/pdf', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'];
+export const FILE_MIME_TYPES = ['application/pdf', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'image/png', 'image/jpeg'];
 export const providerFileId = (value) => typeof value === 'string' && /^[A-Za-z0-9!._,=-]{1,256}$/.test(value);
 function literalObject(node) {
     const value = node;
@@ -30,12 +30,13 @@ function literalObject(node) {
 export function eventTrigger(value) {
     if (value?.type === 'file.created') {
         const t = value;
-        if (Object.keys(t).some(k => !['type', 'connection', 'resource', 'folderId', 'driveId', 'mimeTypes'].includes(k))
+        if (Object.keys(t).some(k => !['type', 'connection', 'resource', 'folderId', 'configurableFolder', 'driveId', 'mimeTypes'].includes(k))
             || typeof t.connection !== 'string' || !LOGICAL_NAME.test(t.connection)
             || typeof t.resource !== 'string' || !t.resource.trim() || t.resource.length > 320
-            || !providerFileId(t.folderId) || (t.driveId !== undefined && !providerFileId(t.driveId))
-            || (t.mimeTypes !== undefined && (!Array.isArray(t.mimeTypes) || !t.mimeTypes.length || t.mimeTypes.length > 2 || new Set(t.mimeTypes).size !== t.mimeTypes.length || t.mimeTypes.some(m => !FILE_MIME_TYPES.includes(m)))))
-            throw new Error('file.created requires a connection, resource, folder ID and optional PDF/XLSX MIME types');
+            || (t.configurableFolder !== undefined && t.configurableFolder !== true)
+            || (t.folderId === undefined ? t.configurableFolder !== true : !providerFileId(t.folderId)) || (t.driveId !== undefined && !providerFileId(t.driveId))
+            || (t.mimeTypes !== undefined && (!Array.isArray(t.mimeTypes) || !t.mimeTypes.length || t.mimeTypes.length > FILE_MIME_TYPES.length || new Set(t.mimeTypes).size !== t.mimeTypes.length || t.mimeTypes.some(m => !FILE_MIME_TYPES.includes(m)))))
+            throw new Error('file.created requires a connection, resource, folder ID and optional PDF/XLSX/PNG/JPEG MIME types');
         return t;
     }
     const trigger = value;

package/dist/runtime.js

@@ -395,7 +395,7 @@ export class Runtime {
         if (job.trigger.type === 'file.created') {
             const instant = (v) => typeof v === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(v) && Number.isFinite(Date.parse(v));
             if (Object.keys(input).some(k => !['type', 'provider', 'sourceId', 'fileId', 'folderId', 'driveId', 'name', 'mimeType', 'size', 'createdAt', 'observedAt'].includes(k))
-                || input.type !== 'file.created' || !['drive', 'sharepoint'].includes(String(input.provider)) || !providerFileId(input.fileId) || input.folderId !== job.trigger.folderId
+                || input.type !== 'file.created' || !['drive', 'sharepoint'].includes(String(input.provider)) || !providerFileId(input.fileId) || !providerFileId(input.folderId) || (!job.trigger.configurableFolder && input.folderId !== job.trigger.folderId)
                 || (input.driveId !== undefined && !providerFileId(input.driveId)) || (input.provider === 'sharepoint' && !input.driveId)
                 || (job.trigger.driveId !== undefined && input.driveId !== job.trigger.driveId)
                 || typeof input.name !== 'string' || !input.name || input.name.length > 1024 || !Number.isSafeInteger(input.size) || Number(input.size) < 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isomorph.ai/app-sdk",
-  "version": "1.33.0",
+  "version": "1.34.0",
   "type": "module",
   "repository": {
     "type": "git",