@fourier-labs/harbour-contracts 0.96.0 → 0.97.0

package/dist/gen-ts/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/gen-ts/saas-connection.d.ts

@@ -55,15 +55,15 @@ export interface SaasConnection {
      * Operations IT allows apps to request on this connection: the provider's own SaaS operations (Slack: slack.channel.history, slack.message.post, slack.message.update, slack.message.delete, slack.dm.send, slack.user.lookup; Gmail: gmail.thread.list, gmail.thread.read, gmail.message.read, gmail.message.send, gmail.attachment.read; Basecamp (0.76.0): basecamp.project.list, basecamp.todolist.list, basecamp.todo.list, basecamp.todo.create, basecamp.todo.complete, basecamp.message.list, basecamp.message.post, basecamp.comment.list, basecamp.comment.post, basecamp.campfire.post, basecamp.people.list; SharePoint (0.78.0): sharepoint.list.list, sharepoint.item.list, sharepoint.item.create, sharepoint.item.update, sharepoint.drive.list, sharepoint.file.list, sharepoint.file.search, sharepoint.file.read, sharepoint.file.upload; Google Workspace and Microsoft 365 (0.86.0): the calendar.*, drive.*, docs.*, sheets.*, outlook.*, onedrive.*, excel.* and teams.* operations of the connection's provider). Never warehouse.view.read. Phone (0.82.0): phone.sms.list; 0.83.0 adds phone.number.get. Seventy-eight SaaS operations in all since 0.86.0.
      *
      * @minItems 1
-     * @maxItems 86
+     * @maxItems 91
      */
-    operations: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf')[];
+    operations: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf' | 'zohobooks.salesorder.list' | 'zohobooks.salesorder.read' | 'zohobooks.invoice.reviseDraft' | 'zohobooks.creditnote.create' | 'zohobooks.creditnote.read')[];
     /**
      * Explicit user-mode operations eligible for automatic app access, subject to the connection operation ceiling and personal consent. Empty means review all; absent inherits company defaults or the existing userModeApproval migration rule. Governance validates provider and mode compatibility. Background execution still requires personal background consent, not a separate admin grant.
      *
-     * @maxItems 86
+     * @maxItems 91
      */
-    automaticUserOperations?: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf')[];
+    automaticUserOperations?: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf' | 'zohobooks.salesorder.list' | 'zohobooks.salesorder.read' | 'zohobooks.invoice.reviseDraft' | 'zohobooks.creditnote.create' | 'zohobooks.creditnote.read')[];
     /**
      * Reusable permissions for admitted builders on explicit shared SaaS resources. Governance checks registered resources, provider/mode compatibility and the connection operation ceiling. Connection version and audit record changes; no per-entry approval metadata.
      *
@@ -168,9 +168,9 @@ export interface ReusableSaasAccess {
     mode: 'app' | 'user';
     /**
      * @minItems 1
-     * @maxItems 86
+     * @maxItems 91
      */
-    operations: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf')[];
+    operations: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf' | 'zohobooks.salesorder.list' | 'zohobooks.salesorder.read' | 'zohobooks.invoice.reviseDraft' | 'zohobooks.creditnote.create' | 'zohobooks.creditnote.read')[];
 }
 export interface DevelopmentPreapproval {
     /**

package/gen-ts/app-integrations-declaration.ts

@@ -94,6 +94,11 @@ export type DeclaredConnection = {
     'zohobooks.invoice.create'?: UserModeChannelOperation;
     'zohobooks.invoice.read'?: UserModeChannelOperation;
     'zohobooks.invoice.pdf'?: UserModeChannelOperation;
+    'zohobooks.salesorder.list'?: UserModeChannelOperation;
+    'zohobooks.salesorder.read'?: UserModeChannelOperation;
+    'zohobooks.invoice.reviseDraft'?: UserModeChannelOperation;
+    'zohobooks.creditnote.create'?: UserModeChannelOperation;
+    'zohobooks.creditnote.read'?: UserModeChannelOperation;
   };
 };
 export type IntegrationConnectionKind = 'saas' | 'database' | 'service';

package/gen-ts/contract-release.ts

@@ -1,10 +1,10 @@
 /* eslint-disable */
 // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
 
-export const ContractRepositoryVersion = "0.96.0.0" as const;
-export const ContractPublishVersion = "0.96.0" as const;
-export const ContractPublishTag = "v0.96.0" as const;
-export const ContractSchemasDigest = "sha256:0baae0630687f4345db30f36b86d1821c4769728187b825db6d63c63c8dc229b" as const;
+export const ContractRepositoryVersion = "0.97.0.0" as const;
+export const ContractPublishVersion = "0.97.0" as const;
+export const ContractPublishTag = "v0.97.0" as const;
+export const ContractSchemasDigest = "sha256:96d7ca6fc25f98bb0b35598d8d72eb68cabd841d4b8b644330dea37fbed0916f" as const;
 export const ContractAiFixturesDigest = "sha256:edac31c92e146ca1c40130f2fb5649db82e24b8cd1ac758153b90612052fddb6" as const;
-export const ContractGeneratedGoDigest = "sha256:725161b06837cacb79c92fd28ed00ef96b132a86ac5d5531ee1b3c3ce0fbb905" as const;
-export const ContractGeneratedTypeScriptDigest = "sha256:b6116203eda0c74ae1cb5ebe2ad9c54f0d73759d7eca1b571dd7aab13ee9c3a6" as const;
+export const ContractGeneratedGoDigest = "sha256:628254d6676684c7356611eaa434890fa28ad7cf78a487ec407d33b4aa8dad0a" as const;
+export const ContractGeneratedTypeScriptDigest = "sha256:db0823b4134a04e599b159fab0fd439c88160541bdf67c58b568758c98a8dfcc" as const;

package/gen-ts/data-grant-v2.ts

@@ -35,7 +35,7 @@ export interface DataGrantV2 {
   /**
    * Approved operations; each must match this grant's mode. Empty until the first approval. At most the seventy-eight SaaS operations (0.86.0: eleven Slack and Gmail, eleven Basecamp, nine SharePoint, two phone, forty-five Google Workspace and Microsoft 365); a database grant holds up to two (warehouse.view.read, warehouse.table.append).
    *
-   * @maxItems 86
+   * @maxItems 91
    */
   operations: (
     | 'slack.channel.history'
@@ -127,6 +127,11 @@ export interface DataGrantV2 {
     | 'zohobooks.invoice.create'
     | 'zohobooks.invoice.read'
     | 'zohobooks.invoice.pdf'
+    | 'zohobooks.salesorder.list'
+    | 'zohobooks.salesorder.read'
+    | 'zohobooks.invoice.reviseDraft'
+    | 'zohobooks.creditnote.create'
+    | 'zohobooks.creditnote.read'
   )[];
   /**
    * Approved logical resources. Never inherited by wildcard. Empty until the first approval.
@@ -197,7 +202,7 @@ export interface IntegrationResource {
  */
 export interface ReviewedIntegrationScope {
   /**
-   * @maxItems 86
+   * @maxItems 91
    */
   operations: (
     | 'slack.channel.history'
@@ -289,6 +294,11 @@ export interface ReviewedIntegrationScope {
     | 'zohobooks.invoice.create'
     | 'zohobooks.invoice.read'
     | 'zohobooks.invoice.pdf'
+    | 'zohobooks.salesorder.list'
+    | 'zohobooks.salesorder.read'
+    | 'zohobooks.invoice.reviseDraft'
+    | 'zohobooks.creditnote.create'
+    | 'zohobooks.creditnote.read'
   )[];
   /**
    * @maxItems 64

package/gen-ts/deployment-app-registration.ts

@@ -70,13 +70,22 @@ export type EventJobs = {
         type: 'file.created';
         connection: string;
         resource: string;
-        folderId: string;
+        folderId?: string;
         driveId?: string;
         /**
          * @minItems 1
-         * @maxItems 2
+         * @maxItems 4
          */
-        mimeTypes?: ('application/pdf' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')[];
+        mimeTypes?: (
+          | 'application/pdf'
+          | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+          | 'image/png'
+          | 'image/jpeg'
+        )[];
+        /**
+         * The app owner may select a folder at runtime within the declared connection and resource.
+         */
+        configurableFolder?: true;
       };
 }[];
 

package/gen-ts/file-arrival.ts

@@ -9,7 +9,11 @@ export type FileArrival = {
   folderId: string;
   driveId?: string;
   name: string;
-  mimeType: 'application/pdf' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+  mimeType:
+    | 'application/pdf'
+    | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+    | 'image/png'
+    | 'image/jpeg';
   size: number;
   createdAt: string;
   observedAt: string;

package/gen-ts/integration-execute-input-rules.ts

@@ -758,6 +758,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}$" },
       } },
     },
   },
@@ -773,6 +774,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}$" },
+    },
+  },
 } as const satisfies Record<string, IntegrationExecuteOperationRule>;
 
 export type IntegrationExecuteOperation = keyof typeof IntegrationExecuteInputRules;

package/gen-ts/integration-execute-request.ts

@@ -101,7 +101,12 @@ export type IntegrationExecuteRequest = {
     | 'zohobooks.bill.read'
     | 'zohobooks.invoice.create'
     | 'zohobooks.invoice.read'
-    | 'zohobooks.invoice.pdf';
+    | 'zohobooks.invoice.pdf'
+    | 'zohobooks.salesorder.list'
+    | 'zohobooks.salesorder.read'
+    | 'zohobooks.invoice.reviseDraft'
+    | 'zohobooks.creditnote.create'
+    | 'zohobooks.creditnote.read';
   /**
    * Tenant-wide logical alias of a connection (governance sourceId) or of a resource under it.
    */
@@ -462,12 +467,14 @@ export type IntegrationExecuteRequest = {
      * @maxItems 100
      */
     lineItems?: {
-      itemId: string;
+      itemId?: string;
       quantity: string;
-      rate: string;
+      rate?: string;
       taxId?: string;
       description?: string;
       purchaseOrderItemId?: string;
+      lineItemId?: string;
+      salesOrderItemId?: string;
     }[];
   };
   /**

package/gen-ts/integration-execute-result.ts

@@ -308,7 +308,11 @@ export type IntegrationExecuteResult = {
       description?: string;
       lineItemId?: string;
       purchaseOrderItemId?: string;
+      sku?: string;
+      taxId?: string;
+      isInvoiced?: boolean;
     }[];
+    referenceNumber?: string;
   };
   /**
    * @maxItems 100
@@ -340,7 +344,11 @@ export type IntegrationExecuteResult = {
       description?: string;
       lineItemId?: string;
       purchaseOrderItemId?: string;
+      sku?: string;
+      taxId?: string;
+      isInvoiced?: boolean;
     }[];
+    referenceNumber?: string;
   }[];
   /**
    * Resolved reply recipients, when supplied by the provider adapter. Outlook uses replyTo when present, otherwise from. Optional for backward compatibility.
@@ -348,6 +356,34 @@ export type IntegrationExecuteResult = {
    * @maxItems 50
    */
   replyTo?: string[];
+  /**
+   * @maxItems 100
+   */
+  booksSalesOrders?: {
+    id: string;
+    number: string;
+    status: string;
+    currency: string;
+    total: string;
+    vendorId?: string;
+    customerId?: string;
+    /**
+     * @maxItems 100
+     */
+    lineItems: {
+      itemId: string;
+      quantity: string;
+      rate: string;
+      total: string;
+      description?: string;
+      lineItemId?: string;
+      purchaseOrderItemId?: string;
+      sku?: string;
+      taxId?: string;
+      isInvoiced?: boolean;
+    }[];
+    referenceNumber?: string;
+  }[];
 };
 /**
  * An event's state (0.86.0): confirmed (Google `confirmed`, Graph not cancelled and not tentative), tentative, or cancelled.

package/gen-ts/integration-operations.ts

@@ -807,5 +807,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
   }
 } as const;

package/gen-ts/saas-connection.ts

@@ -73,7 +73,7 @@ export interface SaasConnection {
    * Operations IT allows apps to request on this connection: the provider's own SaaS operations (Slack: slack.channel.history, slack.message.post, slack.message.update, slack.message.delete, slack.dm.send, slack.user.lookup; Gmail: gmail.thread.list, gmail.thread.read, gmail.message.read, gmail.message.send, gmail.attachment.read; Basecamp (0.76.0): basecamp.project.list, basecamp.todolist.list, basecamp.todo.list, basecamp.todo.create, basecamp.todo.complete, basecamp.message.list, basecamp.message.post, basecamp.comment.list, basecamp.comment.post, basecamp.campfire.post, basecamp.people.list; SharePoint (0.78.0): sharepoint.list.list, sharepoint.item.list, sharepoint.item.create, sharepoint.item.update, sharepoint.drive.list, sharepoint.file.list, sharepoint.file.search, sharepoint.file.read, sharepoint.file.upload; Google Workspace and Microsoft 365 (0.86.0): the calendar.*, drive.*, docs.*, sheets.*, outlook.*, onedrive.*, excel.* and teams.* operations of the connection's provider). Never warehouse.view.read. Phone (0.82.0): phone.sms.list; 0.83.0 adds phone.number.get. Seventy-eight SaaS operations in all since 0.86.0.
    *
    * @minItems 1
-   * @maxItems 86
+   * @maxItems 91
    */
   operations: (
     | 'slack.channel.history'
@@ -165,11 +165,16 @@ export interface SaasConnection {
     | 'zohobooks.invoice.create'
     | 'zohobooks.invoice.read'
     | 'zohobooks.invoice.pdf'
+    | 'zohobooks.salesorder.list'
+    | 'zohobooks.salesorder.read'
+    | 'zohobooks.invoice.reviseDraft'
+    | 'zohobooks.creditnote.create'
+    | 'zohobooks.creditnote.read'
   )[];
   /**
    * Explicit user-mode operations eligible for automatic app access, subject to the connection operation ceiling and personal consent. Empty means review all; absent inherits company defaults or the existing userModeApproval migration rule. Governance validates provider and mode compatibility. Background execution still requires personal background consent, not a separate admin grant.
    *
-   * @maxItems 86
+   * @maxItems 91
    */
   automaticUserOperations?: (
     | 'slack.channel.history'
@@ -261,6 +266,11 @@ export interface SaasConnection {
     | 'zohobooks.invoice.create'
     | 'zohobooks.invoice.read'
     | 'zohobooks.invoice.pdf'
+    | 'zohobooks.salesorder.list'
+    | 'zohobooks.salesorder.read'
+    | 'zohobooks.invoice.reviseDraft'
+    | 'zohobooks.creditnote.create'
+    | 'zohobooks.creditnote.read'
   )[];
   /**
    * Reusable permissions for admitted builders on explicit shared SaaS resources. Governance checks registered resources, provider/mode compatibility and the connection operation ceiling. Connection version and audit record changes; no per-entry approval metadata.
@@ -366,7 +376,7 @@ export interface ReusableSaasAccess {
   mode: 'app' | 'user';
   /**
    * @minItems 1
-   * @maxItems 86
+   * @maxItems 91
    */
   operations: (
     | 'slack.channel.history'
@@ -458,6 +468,11 @@ export interface ReusableSaasAccess {
     | 'zohobooks.invoice.create'
     | 'zohobooks.invoice.read'
     | 'zohobooks.invoice.pdf'
+    | 'zohobooks.salesorder.list'
+    | 'zohobooks.salesorder.read'
+    | 'zohobooks.invoice.reviseDraft'
+    | 'zohobooks.creditnote.create'
+    | 'zohobooks.creditnote.read'
   )[];
 }
 export interface DevelopmentPreapproval {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fourier-labs/harbour-contracts",
-  "version": "0.96.0",
+  "version": "0.97.0",
   "description": "Single source of truth for every data shape that crosses a boundary between Isomorph components.",
   "license": "UNLICENSED",
   "private": false,

package/schema/app-integrations-declaration.schema.json

@@ -141,7 +141,12 @@
         "zohobooks.bill.read",
         "zohobooks.invoice.create",
         "zohobooks.invoice.read",
-        "zohobooks.invoice.pdf"
+        "zohobooks.invoice.pdf",
+        "zohobooks.salesorder.list",
+        "zohobooks.salesorder.read",
+        "zohobooks.invoice.reviseDraft",
+        "zohobooks.creditnote.create",
+        "zohobooks.creditnote.read"
       ],
       "description": "Closed operation set. Extending it is a contracts change. 0.86.0 (ADR 0032) adds the forty-five Google Workspace and Microsoft 365 operations, every one user mode only: on the provider's fixed alias for the signed-in person's own data, calendar.calendar.list, calendar.event.list, calendar.event.read, calendar.event.create (a receipted write: explicit action, idempotencyKey), calendar.event.update and calendar.event.cancel (idempotent at Google, no key); drive.file.list, drive.file.search, drive.file.read, drive.file.upload and drive.folder.create (receipted writes); docs.document.read, docs.document.create (receipted), docs.document.append and docs.text.replace (no key); sheets.spreadsheet.read, sheets.values.read, sheets.values.append (receipted), sheets.values.update and sheets.values.clear (no key), sheets.spreadsheet.create (receipted); outlook.message.list, outlook.message.read, outlook.attachment.read, outlook.message.send and outlook.message.reply (receipted sends, as gmail.message.send), outlook.event.list, outlook.event.read, outlook.event.create (receipted), outlook.event.update and outlook.event.cancel (no key); onedrive.file.list, onedrive.file.search, onedrive.file.read, onedrive.file.upload and onedrive.folder.create (receipted); excel.worksheet.list, excel.range.read, excel.range.update (no key), excel.table.list, excel.row.add and excel.worksheet.add (receipted); and on a Teams channel alias (a key of the connection's `channels` map) teams.message.list, teams.message.post and teams.reply.post (receipted). 0.78.0 (ADR 0024) adds the nine SharePoint operations, every one user mode only on a site alias (a key of the connection's `channels` map, holding a Microsoft Graph site id): sharepoint.list.list, sharepoint.item.list, sharepoint.item.create (a receipted write: explicit action, idempotencyKey), sharepoint.item.update (a PATCH, idempotent at Graph, no key), sharepoint.drive.list, sharepoint.file.list, sharepoint.file.search, sharepoint.file.read and sharepoint.file.upload (a receipted write). 0.76.0 (ADR 0022) adds the eleven Basecamp operations, every one user mode only like gmail.*: basecamp.project.list (the projects of the company's pinned Basecamp account; its resource is the fixed `account` alias), and on one mapped project (the resource is a project alias, a key of the connection's `channels` map) basecamp.todolist.list, basecamp.todo.list, basecamp.todo.create (a receipted write: explicit action, idempotencyKey), basecamp.todo.complete (idempotent at Basecamp, no key), basecamp.message.list, basecamp.message.post, basecamp.comment.list, basecamp.comment.post, basecamp.campfire.post (the three posts are receipted writes) and basecamp.people.list. gmail.message.send (0.50.0) sends one email as the signed-in person: a send like slack.message.post (explicit Send, idempotencyKey, write receipt) under user identity; since 0.71.0 it may carry an HTML body and attachments. slack.message.post (0.53.0) runs in the mode the app declares: app (the company's Slack app, under the IT-approved per-app name) or user (the signed-in person, after their consent); since 0.55.0 each call names which of the approved modes it runs under. 0.71.0 (ADR 0018) adds slack.message.update and slack.message.delete (declared mode, like post), slack.dm.send (app mode: a direct message to 1..8 workspace members named by email), slack.user.lookup (app mode: email to Slack user id), gmail.thread.read (every message of one thread) and gmail.attachment.read (one attachment's bytes), and lets slack.channel.history run in app mode as well as user mode. 0.82.0 (ADR 0028) adds phone.sms.list (app mode only, a number alias from a phone connection's `channels` map: the SMS received on that number since a time) and warehouse.table.append (app mode only on a database connection, a receipted write with idempotencyKey: rows appended to a view alias whose mapping says `access: append`). 0.83.0 (ADR 0029) adds phone.number.get (app mode only, read-only, no input, on a number alias from a phone connection's `channels` map: the E.164 number that alias maps to, so the app — or a computer-use agent it drives — can type it into a portal that signs in by mobile number). 0.85.0 (ADR 0031) raises warehouse.table.append's `rows` from 1..500 to 1..5000 records (the byte cap stays governance's, now 8 MiB), so a downloaded report of a few thousand rows lands in one call."
     },
@@ -599,6 +604,21 @@
             },
             "zohobooks.invoice.pdf": {
               "$ref": "#/definitions/UserModeChannelOperation"
+            },
+            "zohobooks.salesorder.list": {
+              "$ref": "#/definitions/UserModeChannelOperation"
+            },
+            "zohobooks.salesorder.read": {
+              "$ref": "#/definitions/UserModeChannelOperation"
+            },
+            "zohobooks.invoice.reviseDraft": {
+              "$ref": "#/definitions/UserModeChannelOperation"
+            },
+            "zohobooks.creditnote.create": {
+              "$ref": "#/definitions/UserModeChannelOperation"
+            },
+            "zohobooks.creditnote.read": {
+              "$ref": "#/definitions/UserModeChannelOperation"
             }
           }
         }
@@ -1085,6 +1105,31 @@
                       "required": [
                         "zohobooks.invoice.pdf"
                       ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.salesorder.list"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.salesorder.read"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.invoice.reviseDraft"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.creditnote.create"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.creditnote.read"
+                      ]
                     }
                   ]
                 }
@@ -1549,6 +1594,31 @@
                       "required": [
                         "zohobooks.invoice.pdf"
                       ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.salesorder.list"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.salesorder.read"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.invoice.reviseDraft"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.creditnote.create"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "zohobooks.creditnote.read"
+                      ]
                     }
                   ]
                 }

package/schema/data-grant-v2.schema.json

@@ -17,7 +17,7 @@
     "status": { "$ref": "#/definitions/DataGrantV2Status" },
     "operations": {
       "type": "array",
-      "maxItems": 86,
+      "maxItems": 91,
       "uniqueItems": true,
       "items": { "$ref": "app-integrations-declaration.schema.json#/definitions/IntegrationOperation" },
       "description": "Approved operations; each must match this grant's mode. Empty until the first approval. At most the seventy-eight SaaS operations (0.86.0: eleven Slack and Gmail, eleven Basecamp, nine SharePoint, two phone, forty-five Google Workspace and Microsoft 365); a database grant holds up to two (warehouse.view.read, warehouse.table.append)."
@@ -65,7 +65,7 @@
       "description": "Only for SaaS grants mixing reviewed and automatic access: the previously human-reviewed scope. The remaining scope must satisfy current automatic rules. Homogeneous grants continue using approvedBy alone. Governance validates this is a subset of the grant; database behaviour is unchanged.",
       "properties": {
         "operations": {
-          "type": "array", "maxItems": 86, "uniqueItems": true,
+          "type": "array", "maxItems": 91, "uniqueItems": true,
           "items": { "$ref": "app-integrations-declaration.schema.json#/definitions/IntegrationOperation" }
         },
         "resources": {