@isomorph.ai/app-sdk 1.28.0 → 1.30.0

package/README.md

@@ -509,3 +509,5 @@ job runtime; duplicate deliveries retain the same run instead of rerunning a com
 This does not add a per-app polling timer. Cluster hosting and cross-account delivery are not
 supported by this first release. Local manual job execution tests the handler, not the provider
 subscription; verify a real incoming email after deployment before calling the trigger live.
+
+For PO-linked Zoho bills, first read the PO and send each returned `lineItemId` as the bill line’s `purchaseOrderItemId`. `itemId` identifies the catalog item; it does not identify the PO line. Purchase-order list results are summaries; read the document before comparing lines.

package/dist/index.d.ts

@@ -1100,6 +1100,9 @@ export interface BooksLineInput {
     taxId?: string;
     description?: string;
 }
+export interface BooksBillLineInput extends BooksLineInput {
+    purchaseOrderItemId?: string;
+}
 export interface BooksDocument {
     id: string;
     number: string;
@@ -1110,6 +1113,8 @@ export interface BooksDocument {
     customerId?: string;
     lineItems: {
         itemId: string;
+        lineItemId?: string;
+        purchaseOrderItemId?: string;
         quantity: string;
         rate: string;
         total: string;
@@ -1151,7 +1156,7 @@ export type ZohoBooksRequest = {
         documentNumber: string;
         documentDate: string;
         purchaseOrderId?: string;
-        lineItems: BooksLineInput[];
+        lineItems: BooksBillLineInput[];
     };
 } | {
     operation: 'zohobooks.invoice.create';

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

@@ -2268,6 +2268,13 @@ export declare const IntegrationExecuteInputRules: {
                         readonly minLength: 0;
                         readonly maxLength: 2000;
                     };
+                    readonly purchaseOrderItemId: {
+                        readonly kind: "string";
+                        readonly required: false;
+                        readonly minLength: 0;
+                        readonly maxLength: 32;
+                        readonly pattern: "^[0-9]{1,32}$";
+                    };
                 };
             };
         };

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

@@ -701,6 +701,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 },
+                    purchaseOrderItemId: { kind: "string", required: false, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
                 } },
         },
     },

package/dist/runtime.js

@@ -398,7 +398,7 @@ export class Runtime {
         if (!job?.trigger || job.trigger.connection !== delivery.input.sourceId)
             throw new Error('mail trigger is not declared by this deployed app');
         await this.refreshToken(JOB_SESSION_MIN_VALIDITY_MS);
-        if (!this.options.gatewayUrl || !this.options.queueUrl || this.options.jobRuns === false || !(await this.awaitDataPath()))
+        if (!this.options.gatewayUrl || this.options.mode === 'gate' || this.options.jobRuns === false || !(await this.awaitDataPath()))
             throw new Error('mail arrival requires durable job runs');
         const queued = await this.runs.enqueueMail(delivery);
         await this.signalQueuedRun(queued.id);
@@ -642,6 +642,12 @@ export class Runtime {
         if (this.options.gatewayIdentity && sendsBearer)
             await this.refreshToken().catch((error) => this.log(`gateway session: ${error instanceof Error ? error.message : String(error)}`));
         try {
+            if (name === 'isomorph-mail-arrival') {
+                if (header(request, 'X-Harbour-Verified-Mail-Arrival') !== 'true')
+                    return refuse(response, 403, 'FORBIDDEN', 'governed mail delivery is required', requestId);
+                await this.acceptMailArrival(input);
+                return answer(response, 200, { data: { accepted: true } }, requestId);
+            }
             if (name.startsWith(RESERVED_PREFIX))
                 return answer(response, 200, { data: await this.reserved(name, input, context) }, requestId);
             if (!this.inventory.actions.includes(name))

package/package.json

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