@isomorph.ai/app-sdk 1.12.0 → 1.13.0

package/dist/index.d.ts

@@ -238,7 +238,24 @@ export interface GmailMessageSendRequest {
     /** A fresh UUID per authorized Send action, reused only to retry that action. */
     idempotencyKey: string;
 }
-export type IntegrationRequest = SlackChannelHistoryRequest | SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest | SlackDmSendRequest | SlackUserLookupRequest | WarehouseViewReadRequest | GmailThreadListRequest | GmailThreadReadRequest | GmailMessageReadRequest | GmailAttachmentReadRequest | GmailMessageSendRequest;
+export interface ServiceRequest {
+    operation: 'service.request';
+    resource?: never;
+    input: {
+        method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+        path: string;
+        pathParams?: Record<string, string | number>;
+        query?: Record<string, string | number | boolean>;
+        headers?: Record<string, string>;
+        body?: Record<string, unknown>;
+    };
+}
+export interface ServiceRequestResult {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+}
+export type IntegrationRequest = ServiceRequest | SlackChannelHistoryRequest | SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest | SlackDmSendRequest | SlackUserLookupRequest | WarehouseViewReadRequest | GmailThreadListRequest | GmailThreadReadRequest | GmailMessageReadRequest | GmailAttachmentReadRequest | GmailMessageSendRequest;
 export type IntegrationOperation = IntegrationRequest['operation'];
 export interface SlackMessage {
     id: string;
@@ -324,7 +341,7 @@ export interface GmailMessageSendResult {
     messageId: string;
     threadId: string;
 }
-export type IntegrationResult<R extends IntegrationRequest> = R extends SlackChannelHistoryRequest ? SlackChannelHistoryResult : R extends SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest ? SlackMessagePostResult : R extends SlackDmSendRequest ? SlackDmSendResult : R extends SlackUserLookupRequest ? SlackUserLookupResult : R extends WarehouseViewReadRequest ? WarehouseViewReadResult : R extends GmailThreadListRequest ? GmailThreadListResult : R extends GmailThreadReadRequest ? GmailThreadReadResult : R extends GmailMessageReadRequest ? GmailMessageReadResult : R extends GmailAttachmentReadRequest ? GmailAttachmentReadResult : R extends GmailMessageSendRequest ? GmailMessageSendResult : never;
+export type IntegrationResult<R extends IntegrationRequest> = R extends ServiceRequest ? ServiceRequestResult : R extends SlackChannelHistoryRequest ? SlackChannelHistoryResult : R extends SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest ? SlackMessagePostResult : R extends SlackDmSendRequest ? SlackDmSendResult : R extends SlackUserLookupRequest ? SlackUserLookupResult : R extends WarehouseViewReadRequest ? WarehouseViewReadResult : R extends GmailThreadListRequest ? GmailThreadListResult : R extends GmailThreadReadRequest ? GmailThreadReadResult : R extends GmailMessageReadRequest ? GmailMessageReadResult : R extends GmailAttachmentReadRequest ? GmailAttachmentReadResult : R extends GmailMessageSendRequest ? GmailMessageSendResult : never;
 export type IntegrationConnectResult = {
     status: 'connected';
     accountLabel: string;

package/dist/index.js

@@ -189,7 +189,13 @@ class Transport {
         const response = await this.fetch(`${this.baseUrl}${path}`, {
             credentials: 'same-origin',
             ...init,
-            headers: mergeHeaders({ 'content-type': 'application/json' }, runnerIdentityHeaders(this.identity), init.headers, onProgress ? { accept: PROGRESS_MEDIA_TYPE } : undefined),
+            headers: mergeHeaders(
+            // No content type on a request without a body: a browser GET that
+            // carries one is not a "simple" request, so it costs a CORS preflight
+            // (OPTIONS, one more round trip, on a separate uncredentialed
+            // connection a preconnect cannot warm) before the GET itself. Without
+            // it the identity GET and every other read is one round trip.
+            init.body === undefined && ['GET', 'HEAD'].includes((init.method ?? 'GET').toUpperCase()) ? {} : { 'content-type': 'application/json' }, runnerIdentityHeaders(this.identity), init.headers, onProgress ? { accept: PROGRESS_MEDIA_TYPE } : undefined),
         });
         if (onProgress && response.ok && response.body && response.headers.get('content-type')?.startsWith(PROGRESS_MEDIA_TYPE)) {
             return readProgress(response, onProgress);
@@ -737,7 +743,7 @@ export function createClient(options = {}) {
                 // operations accept `mode`; identity and stray fields are not sent.
                 const { operation, resource, input, idempotencyKey, mode } = request;
                 return transport.json('/_harbour/integrations/execute', {
-                    method: 'POST', body: JSON.stringify({ connection, operation, resource, ...(input !== undefined ? { input } : {}), ...(idempotencyKey !== undefined ? { idempotencyKey } : {}), ...(IntegrationOperations[operation]?.declaredMode && mode !== undefined ? { mode } : {}) }),
+                    method: 'POST', body: JSON.stringify({ connection, operation, ...(operation !== 'service.request' ? { resource } : {}), ...(input !== undefined ? { input } : {}), ...(idempotencyKey !== undefined ? { idempotencyKey } : {}), ...(IntegrationOperations[operation]?.declaredMode && mode !== undefined ? { mode } : {}) }),
                 });
             },
             // In a browser the consent returns the person to this page (without its

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

@@ -6,6 +6,9 @@
  * same message wherever it is made.
  */
 export type IntegrationExecuteInputFieldRule = {
+    kind: 'object';
+    required: boolean;
+} | {
     kind: 'integer';
     required: boolean;
     minimum: number;
@@ -461,6 +464,38 @@ export declare const IntegrationExecuteInputRules: {
             };
         };
     };
+    readonly "service.request": {
+        readonly idempotencyKey: false;
+        readonly fields: {
+            readonly method: {
+                readonly kind: "enum";
+                readonly required: true;
+                readonly values: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
+            };
+            readonly path: {
+                readonly kind: "string";
+                readonly required: true;
+                readonly minLength: 0;
+                readonly maxLength: 16384;
+            };
+            readonly pathParams: {
+                readonly kind: "object";
+                readonly required: false;
+            };
+            readonly query: {
+                readonly kind: "object";
+                readonly required: false;
+            };
+            readonly headers: {
+                readonly kind: "object";
+                readonly required: false;
+            };
+            readonly body: {
+                readonly kind: "object";
+                readonly required: false;
+            };
+        };
+    };
 };
 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

@@ -113,6 +113,17 @@ export const IntegrationExecuteInputRules = {
             limit: { kind: "integer", required: false, minimum: 1, maximum: 1000, default: 100 },
         },
     },
+    "service.request": {
+        idempotencyKey: false,
+        fields: {
+            method: { kind: "enum", required: true, values: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"] },
+            path: { kind: "string", required: true, minLength: 0, maxLength: 16384 },
+            pathParams: { kind: "object", required: false },
+            query: { kind: "object", required: false },
+            headers: { kind: "object", required: false },
+            body: { kind: "object", required: false },
+        },
+    },
 };
 /** The upper bound of one integer input as a literal type: integrationExecuteInputMaximum('slack.channel.history', 'limit') is 15. */
 export function integrationExecuteInputMaximum(operation, field) {
@@ -173,6 +184,10 @@ function checkFields(operation, prefix, fields, given, nullIsAbsent) {
 }
 function checkField(operation, path, name, field, value) {
     switch (field.kind) {
+        case 'object':
+            if (value === null || typeof value !== 'object' || Array.isArray(value))
+                return refuse(path, `${path} must be a JSON object`);
+            return { ok: true, value };
         case 'integer':
             if (typeof value !== 'number' || !Number.isInteger(value) || value < field.minimum || value > field.maximum)
                 return refuse(path, `${path} must be an integer between ${field.minimum} and ${field.maximum}`);

package/dist/integration-operations.d.ts

@@ -84,4 +84,11 @@ export declare const IntegrationOperations: {
         readonly declaredMode: false;
         readonly idempotencyKey: false;
     };
+    readonly "service.request": {
+        readonly kind: "service";
+        readonly identities: readonly ["app"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
 };

package/dist/integration-operations.js

@@ -113,5 +113,14 @@ export const IntegrationOperations = {
         "readOnly": true,
         "declaredMode": false,
         "idempotencyKey": false
+    },
+    "service.request": {
+        "kind": "service",
+        "identities": [
+            "app"
+        ],
+        "readOnly": false,
+        "declaredMode": false,
+        "idempotencyKey": false
     }
 };

package/package.json

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