@wildo-ai/external-connectors-models 1.1.2 → 1.1.3

package/dist/esm/protocols/rest-api.external-connectors-models.schemas.d.ts

@@ -1,75 +1,5 @@
 import { z } from "zod";
-import { API_HttpMethod, ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Profile_Base, ExternalProvider_ExchangeProtocol_Configuration_Base } from "../core/commons.external-connectors-models.schemas";
-import { ExternalProvider_OperationDefinition_Base } from "../core/operations.external-connectors-models.schemas";
-export declare enum API_ParameterIn {
-    QUERY = "query",
-    HEADER = "header",
-    PATH = "path",
-    COOKIE = "cookie"
-}
-export declare enum API_ContentType {
-    JSON = "application/json",
-    XML = "application/xml",
-    FORM_URLENCODED = "application/x-www-form-urlencoded",
-    MULTIPART_FORM = "multipart/form-data",
-    TEXT_PLAIN = "text/plain",
-    OCTET_STREAM = "application/octet-stream"
-}
-export declare const API_ParameterSchema: z.ZodObject<{
-    name: z.ZodString;
-    in: z.ZodEnum<typeof API_ParameterIn>;
-    description: z.ZodOptional<z.ZodString>;
-    required: z.ZodDefault<z.ZodBoolean>;
-    deprecated: z.ZodOptional<z.ZodBoolean>;
-    schemaRef: z.ZodOptional<z.ZodString>;
-    type: z.ZodOptional<z.ZodEnum<{
-        string: "string";
-        number: "number";
-        boolean: "boolean";
-        array: "array";
-        integer: "integer";
-    }>>;
-    format: z.ZodOptional<z.ZodString>;
-    enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    defaultValue: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strip>;
-export type API_Parameter = z.infer<typeof API_ParameterSchema>;
-export declare const REST_API_OperationSpecSchema: z.ZodObject<{
-    method: z.ZodEnum<typeof API_HttpMethod>;
-    path: z.ZodString;
-    parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        in: z.ZodEnum<typeof API_ParameterIn>;
-        description: z.ZodOptional<z.ZodString>;
-        required: z.ZodDefault<z.ZodBoolean>;
-        deprecated: z.ZodOptional<z.ZodBoolean>;
-        schemaRef: z.ZodOptional<z.ZodString>;
-        type: z.ZodOptional<z.ZodEnum<{
-            string: "string";
-            number: "number";
-            boolean: "boolean";
-            array: "array";
-            integer: "integer";
-        }>>;
-        format: z.ZodOptional<z.ZodString>;
-        enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        defaultValue: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strip>>>;
-    requestContentType: z.ZodOptional<z.ZodEnum<typeof API_ContentType>>;
-    responseContentType: z.ZodOptional<z.ZodEnum<typeof API_ContentType>>;
-    rateLimit: z.ZodOptional<z.ZodObject<{
-        requests: z.ZodNumber;
-        period: z.ZodEnum<{
-            second: "second";
-            minute: "minute";
-            hour: "hour";
-            day: "day";
-        }>;
-    }, z.core.$strip>>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    deprecated: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export type REST_API_OperationSpec = z.infer<typeof REST_API_OperationSpecSchema>;
+import { ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Profile_Base, ExternalProvider_ExchangeProtocol_Configuration_Base } from "../core/commons.external-connectors-models.schemas";
 export type REST_API_Provider_Profile = ExternalProvider_ExchangeProtocol_Profile_Base & {
     baseURL: string;
     version?: string;
@@ -96,24 +26,6 @@ export type REST_API_Provider_Configuration = ExternalProvider_ExchangeProtocol_
         defaultLimit?: number;
     };
 };
-export declare const REST_API_OperationContextSchema: z.ZodObject<{
-    callTimestamp: z.ZodISODateTime;
-    callDuration: z.ZodOptional<z.ZodNumber>;
-    errorReason: z.ZodOptional<z.ZodString>;
-    requestMethod: z.ZodEnum<typeof API_HttpMethod>;
-    requestPath: z.ZodString;
-    requestUrl: z.ZodString;
-    responseStatus: z.ZodNumber;
-    responseStatusText: z.ZodOptional<z.ZodString>;
-    rateLimitRemaining: z.ZodOptional<z.ZodNumber>;
-    rateLimitReset: z.ZodOptional<z.ZodString>;
-    retryCount: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type REST_API_OperationContext = z.infer<typeof REST_API_OperationContextSchema>;
-export type REST_API_OperationDefinition = ExternalProvider_OperationDefinition_Base & {
-    spec: REST_API_OperationSpec;
-    operationContextSchema: typeof REST_API_OperationContextSchema;
-};
 export declare const REST_APIProvider_StatusSchema: z.ZodObject<{
     status: z.ZodEnum<typeof import("..").ExternalProvider_Status>;
     lastCheckedAt: z.ZodString;

package/dist/esm/protocols/rest-api.external-connectors-models.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-api.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../../src/protocols/rest-api.external-connectors-models.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,sCAAsC,EAEtC,8CAA8C,EAC9C,oDAAoD,EACrD,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAA2C,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAa3J,oBAAY,eAAe;IACzB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,oBAAY,eAAe;IACzB,IAAI,qBAAqB;IACzB,GAAG,oBAAoB;IACvB,eAAe,sCAAsC;IACrD,cAAc,wBAAwB;IACtC,UAAU,eAAe;IACzB,YAAY,6BAA6B;CAC1C;AAMD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;iBAe9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAMlF,MAAM,MAAM,yBAAyB,GAAG,8CAA8C,GAAG;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAEH;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CAChC,CAAC;AAMF,MAAM,MAAM,+BAA+B,GAAG,oDAAoD,GAAG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;QAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAMF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;iBAgB1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,MAAM,MAAM,4BAA4B,GAAG,yCAAyC,GAAG;IACrF,IAAI,EAAE,sBAAsB,CAAC;IAC7B,sBAAsB,EAAE,OAAO,+BAA+B,CAAC;CAIhE,CAAC;AAMF,eAAO,MAAM,6BAA6B;;;;;;iBAGxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}
+{"version":3,"file":"rest-api.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../../src/protocols/rest-api.external-connectors-models.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sCAAsC,EAEtC,8CAA8C,EAC9C,oDAAoD,EACrD,MAAM,oDAAoD,CAAC;AAoC5D,MAAM,MAAM,yBAAyB,GAAG,8CAA8C,GAAG;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAEH;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CAChC,CAAC;AAMF,MAAM,MAAM,+BAA+B,GAAG,oDAAoD,GAAG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;QAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAMF,eAAO,MAAM,6BAA6B;;;;;;iBAGxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/esm/protocols/rest-api.external-connectors-models.schemas.js

@@ -1,87 +1,5 @@
 import { z } from "zod";
-import { API_HttpMethod, ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Status_BaseSchema } from "../core/commons.external-connectors-models.schemas.js";
-import { ExternalProvider_OperationContextSchema } from "../core/operations.external-connectors-models.schemas.js";
-//===============================================================
-// REST API Provider
-// --------
-// Integration with REST APIs. Uses Zod schemas for request/response
-// definitions. OpenAPI-compatible concepts mapped to Zod types.
-//===============================================================
-// ===============================================================
-// Parameter Location & Content Types
-// ===============================================================
-export var API_ParameterIn;
-(function (API_ParameterIn) {
-    API_ParameterIn["QUERY"] = "query";
-    API_ParameterIn["HEADER"] = "header";
-    API_ParameterIn["PATH"] = "path";
-    API_ParameterIn["COOKIE"] = "cookie";
-})(API_ParameterIn || (API_ParameterIn = {}));
-export var API_ContentType;
-(function (API_ContentType) {
-    API_ContentType["JSON"] = "application/json";
-    API_ContentType["XML"] = "application/xml";
-    API_ContentType["FORM_URLENCODED"] = "application/x-www-form-urlencoded";
-    API_ContentType["MULTIPART_FORM"] = "multipart/form-data";
-    API_ContentType["TEXT_PLAIN"] = "text/plain";
-    API_ContentType["OCTET_STREAM"] = "application/octet-stream";
-})(API_ContentType || (API_ContentType = {}));
-// ===============================================================
-// API Parameter (for path, query, header params)
-// ===============================================================
-export const API_ParameterSchema = z.object({
-    name: z.string(),
-    in: z.enum(API_ParameterIn),
-    description: z.string().optional(),
-    required: z.boolean().default(false),
-    deprecated: z.boolean().optional(),
-    // Schema is a Zod schema reference (stored as string for serialization)
-    schemaRef: z.string().optional(), // Reference to a named schema
-    // Or inline type info
-    type: z.enum(["string", "number", "integer", "boolean", "array"]).optional(),
-    format: z.string().optional(), // e.g., "date-time", "email", "uuid"
-    enumValues: z.array(z.string()).optional(),
-    defaultValue: z.unknown().optional(),
-});
-// ===============================================================
-// REST API Operation Spec
-// ===============================================================
-export const REST_API_OperationSpecSchema = z.object({
-    // HTTP specifics
-    method: z.enum(API_HttpMethod),
-    path: z.string(), // e.g., "/users/{userId}/posts"
-    // Parameters
-    parameters: z.array(API_ParameterSchema).optional(),
-    // Request/Response content types
-    requestContentType: z.enum(API_ContentType).optional(),
-    responseContentType: z.enum(API_ContentType).optional(),
-    // Rate limiting hints
-    rateLimit: z.object({
-        requests: z.number(),
-        period: z.enum(["second", "minute", "hour", "day"]),
-    }).optional(),
-    // Tags for grouping
-    tags: z.array(z.string()).optional(),
-    // Deprecation
-    deprecated: z.boolean().optional(),
-});
-// ===============================================================
-// REST API Operation Context (for tracking)
-// ===============================================================
-export const REST_API_OperationContextSchema = ExternalProvider_OperationContextSchema.extend({
-    // Request details
-    requestMethod: z.enum(API_HttpMethod),
-    requestPath: z.string(),
-    requestUrl: z.string(),
-    // Response details
-    responseStatus: z.number(),
-    responseStatusText: z.string().optional(),
-    // Rate limit info
-    rateLimitRemaining: z.number().optional(),
-    rateLimitReset: z.string().optional(),
-    // Retry info
-    retryCount: z.number().optional(),
-});
+import { ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Status_BaseSchema } from "../core/commons.external-connectors-models.schemas.js";
 // ===============================================================
 // STATUS
 // ===============================================================

package/dist/esm/protocols/rest-api.external-connectors-models.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"rest-api.external-connectors-models.schemas.js","sourceRoot":"","sources":["../../../../src/protocols/rest-api.external-connectors-models.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,sCAAsC,EACtC,mDAAmD,EAGpD,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,uCAAuC,EAA6C,MAAM,uDAAuD,CAAC;AAE3J,iEAAiE;AACjE,oBAAoB;AACpB,WAAW;AACX,oEAAoE;AACpE,gEAAgE;AAChE,iEAAiE;AAEjE,kEAAkE;AAClE,qCAAqC;AACrC,kEAAkE;AAElE,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,gCAAa,CAAA;IACb,oCAAiB,CAAA;AACnB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,wEAAqD,CAAA;IACrD,yDAAsC,CAAA;IACtC,4CAAyB,CAAA;IACzB,4DAAyC,CAAA;AAC3C,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAED,kEAAkE;AAClE,iDAAiD;AACjD,kEAAkE;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAElC,wEAAwE;IACxE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAG,8BAA8B;IAEjE,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAG,qCAAqC;IACrE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAGH,kEAAkE;AAClE,0BAA0B;AAC1B,kEAAkE;AAElE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,iBAAiB;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAG,gCAAgC;IAEnD,aAAa;IACb,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAEnD,iCAAiC;IACjC,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IACtD,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAEvD,sBAAsB;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;KACpD,CAAC,CAAC,QAAQ,EAAE;IAEb,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEpC,cAAc;IACd,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AA8CH,kEAAkE;AAClE,4CAA4C;AAC5C,kEAAkE;AAElE,MAAM,CAAC,MAAM,+BAA+B,GAAG,uCAAuC,CAAC,MAAM,CAAC;IAC5F,kBAAkB;IAClB,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IAEtB,mBAAmB;IACnB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEzC,kBAAkB;IAClB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAErC,aAAa;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAeH,kEAAkE;AAClE,SAAS;AACT,kEAAkE;AAElE,MAAM,CAAC,MAAM,6BAA6B,GAAG,mDAAmD,CAAC,MAAM,CAAC;IACtG,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,QAAQ,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { \n  API_HttpMethod, \n  ExternalProvider_ExchangeProtocol_Kind, \n  ExternalProvider_ExchangeProtocol_Status_BaseSchema, \n  ExternalProvider_ExchangeProtocol_Profile_Base, \n  ExternalProvider_ExchangeProtocol_Configuration_Base \n} from \"../core/commons.external-connectors-models.schemas\";\nimport { ExternalProvider_OperationContextSchema, ExternalProvider_OperationDefinition_Base } from \"../core/operations.external-connectors-models.schemas\";\n\n//===============================================================\n// REST API Provider\n// --------\n// Integration with REST APIs. Uses Zod schemas for request/response\n// definitions. OpenAPI-compatible concepts mapped to Zod types.\n//===============================================================\n\n// ===============================================================\n// Parameter Location & Content Types\n// ===============================================================\n\nexport enum API_ParameterIn {\n  QUERY = \"query\",\n  HEADER = \"header\",\n  PATH = \"path\",\n  COOKIE = \"cookie\",\n}\n\nexport enum API_ContentType {\n  JSON = \"application/json\",\n  XML = \"application/xml\",\n  FORM_URLENCODED = \"application/x-www-form-urlencoded\",\n  MULTIPART_FORM = \"multipart/form-data\",\n  TEXT_PLAIN = \"text/plain\",\n  OCTET_STREAM = \"application/octet-stream\",\n}\n\n// ===============================================================\n// API Parameter (for path, query, header params)\n// ===============================================================\n\nexport const API_ParameterSchema = z.object({\n  name: z.string(),\n  in: z.enum(API_ParameterIn),\n  description: z.string().optional(),\n  required: z.boolean().default(false),\n  deprecated: z.boolean().optional(),\n  \n  // Schema is a Zod schema reference (stored as string for serialization)\n  schemaRef: z.string().optional(),  // Reference to a named schema\n  \n  // Or inline type info\n  type: z.enum([\"string\", \"number\", \"integer\", \"boolean\", \"array\"]).optional(),\n  format: z.string().optional(),  // e.g., \"date-time\", \"email\", \"uuid\"\n  enumValues: z.array(z.string()).optional(),\n  defaultValue: z.unknown().optional(),\n});\nexport type API_Parameter = z.infer<typeof API_ParameterSchema>;\n\n// ===============================================================\n// REST API Operation Spec\n// ===============================================================\n\nexport const REST_API_OperationSpecSchema = z.object({\n  // HTTP specifics\n  method: z.enum(API_HttpMethod),\n  path: z.string(),  // e.g., \"/users/{userId}/posts\"\n  \n  // Parameters\n  parameters: z.array(API_ParameterSchema).optional(),\n  \n  // Request/Response content types\n  requestContentType: z.enum(API_ContentType).optional(),\n  responseContentType: z.enum(API_ContentType).optional(),\n  \n  // Rate limiting hints\n  rateLimit: z.object({\n    requests: z.number(),\n    period: z.enum([\"second\", \"minute\", \"hour\", \"day\"]),\n  }).optional(),\n  \n  // Tags for grouping\n  tags: z.array(z.string()).optional(),\n  \n  // Deprecation\n  deprecated: z.boolean().optional(),\n});\nexport type REST_API_OperationSpec = z.infer<typeof REST_API_OperationSpecSchema>;\n\n// ===============================================================\n// REST API Provider Profile\n// ===============================================================\n\nexport type REST_API_Provider_Profile = ExternalProvider_ExchangeProtocol_Profile_Base & {\n  baseURL: string;\n  version?: string;  // API version (e.g., \"v1\", \"2024-01-01\")\n  \n  // Default headers for all requests\n  defaultHeaders?: Record<string, string>;\n  \n  // Server variables for templated URLs\n  serverVariables?: Record<string, {\n    default: string;\n    enum?: string[];\n    description?: string;\n  }>;\n  \n  /** \n   * Common error schema for this API\n   * Used for standardized error handling across all operations\n   * Individual operations can override with their own error schema if needed\n   */\n  errorSchema?: z.ZodSchema<any>;\n};\n\n// ===============================================================\n// REST API Provider Configuration\n// ===============================================================\n\nexport type REST_API_Provider_Configuration = ExternalProvider_ExchangeProtocol_Configuration_Base & {\n  defaultTimeout?: number;  // ms\n  defaultRetries?: number;\n  \n  // Pagination settings\n  pagination?: {\n    style: \"offset\" | \"cursor\" | \"page\" | \"link\";\n    pageParam?: string;\n    limitParam?: string;\n    defaultLimit?: number;\n  };\n};\n\n// ===============================================================\n// REST API Operation Context (for tracking)\n// ===============================================================\n\nexport const REST_API_OperationContextSchema = ExternalProvider_OperationContextSchema.extend({\n  // Request details\n  requestMethod: z.enum(API_HttpMethod),\n  requestPath: z.string(),\n  requestUrl: z.string(),\n  \n  // Response details\n  responseStatus: z.number(),\n  responseStatusText: z.string().optional(),\n  \n  // Rate limit info\n  rateLimitRemaining: z.number().optional(),\n  rateLimitReset: z.string().optional(),\n  \n  // Retry info\n  retryCount: z.number().optional(),\n});\nexport type REST_API_OperationContext = z.infer<typeof REST_API_OperationContextSchema>;\n\n// ===============================================================\n// REST API Operation Definition\n// ===============================================================\n\nexport type REST_API_OperationDefinition = ExternalProvider_OperationDefinition_Base & {\n  spec: REST_API_OperationSpec;\n  operationContextSchema: typeof REST_API_OperationContextSchema;\n  \n  // Zod schemas for request/response (the actual schemas, not descriptions)\n  // inputSchema and outputSchema are inherited from ExternalProvider_OperationDefinition_Base\n};\n\n// ===============================================================\n// STATUS\n// ===============================================================\n\nexport const REST_APIProvider_StatusSchema = ExternalProvider_ExchangeProtocol_Status_BaseSchema.extend({\n  protocolKind: z.literal(ExternalProvider_ExchangeProtocol_Kind.REST_API),\n  apiVersion: z.string().optional(),\n});\nexport type REST_APIProvider_Status = z.infer<typeof REST_APIProvider_StatusSchema>;\n"]}
+{"version":3,"file":"rest-api.external-connectors-models.schemas.js","sourceRoot":"","sources":["../../../../src/protocols/rest-api.external-connectors-models.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sCAAsC,EACtC,mDAAmD,EAGpD,MAAM,oDAAoD,CAAC;AA2E5D,kEAAkE;AAClE,SAAS;AACT,kEAAkE;AAElE,MAAM,CAAC,MAAM,6BAA6B,GAAG,mDAAmD,CAAC,MAAM,CAAC;IACtG,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,QAAQ,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { \n  ExternalProvider_ExchangeProtocol_Kind, \n  ExternalProvider_ExchangeProtocol_Status_BaseSchema, \n  ExternalProvider_ExchangeProtocol_Profile_Base, \n  ExternalProvider_ExchangeProtocol_Configuration_Base \n} from \"../core/commons.external-connectors-models.schemas\";\n\n//===============================================================\n// REST API Provider\n// --------\n// WHERE a REST API lives and how this application is configured against it:\n// base URL, version, default headers, server variables, timeouts, retries and\n// pagination defaults, plus the protocol's status shape.\n//\n// WHAT can be called against it is NOT here. A provider's callable operations\n// live on the `rest` arm of `BackendProviderRuntimeContract`\n// (`@wildo-ai/external-connectors-private/backend-runtime`) as\n// `ProviderRestOperation`, and `ProviderOperationExecutorBackendService`\n// executes them — one door, whether the catalogue was hand-authored or emitted\n// by the build-time mapper that scrapes an external source (plan D4/D8).\n//\n// This module DESCRIBED operations too, until 2026-09-06 (#331): an\n// OpenAPI-shaped `REST_API_OperationSpecSchema` / `REST_API_OperationContextSchema`\n// / `REST_API_OperationDefinition` with `API_Parameter`, `API_ParameterIn` and\n// `API_ContentType` beneath them. Ten exported symbols, and a repo-wide sweep\n// (`command grep -r`, hidden and gitignored trees included) found ZERO code\n// readers anywhere: nothing built one, nothing executed one, and a provider that\n// authored one would have compiled, shipped, and been invisible to every runtime.\n//\n// They are deleted rather than wired up, and that is the decision worth keeping:\n// a second description of \"what a provider can do\" is not a missing feature, it\n// is the drift that makes an authoring surface untrustworthy — an author cannot\n// tell which of two shapes is the one that runs. If an OpenAPI document is ever\n// read (D11 keeps it as a second MAPPER INPUT, deferred per vendor), it feeds\n// `ProviderRestOperation` like every other source. It does not come back here.\n//===============================================================\n\n// ===============================================================\n// REST API Provider Profile\n// ===============================================================\n\nexport type REST_API_Provider_Profile = ExternalProvider_ExchangeProtocol_Profile_Base & {\n  baseURL: string;\n  version?: string;  // API version (e.g., \"v1\", \"2024-01-01\")\n  \n  // Default headers for all requests\n  defaultHeaders?: Record<string, string>;\n  \n  // Server variables for templated URLs\n  serverVariables?: Record<string, {\n    default: string;\n    enum?: string[];\n    description?: string;\n  }>;\n  \n  /** \n   * Common error schema for this API\n   * Used for standardized error handling across all operations\n   * Individual operations can override with their own error schema if needed\n   */\n  errorSchema?: z.ZodSchema<any>;\n};\n\n// ===============================================================\n// REST API Provider Configuration\n// ===============================================================\n\nexport type REST_API_Provider_Configuration = ExternalProvider_ExchangeProtocol_Configuration_Base & {\n  defaultTimeout?: number;  // ms\n  defaultRetries?: number;\n  \n  // Pagination settings\n  pagination?: {\n    style: \"offset\" | \"cursor\" | \"page\" | \"link\";\n    pageParam?: string;\n    limitParam?: string;\n    defaultLimit?: number;\n  };\n};\n\n// ===============================================================\n// STATUS\n// ===============================================================\n\nexport const REST_APIProvider_StatusSchema = ExternalProvider_ExchangeProtocol_Status_BaseSchema.extend({\n  protocolKind: z.literal(ExternalProvider_ExchangeProtocol_Kind.REST_API),\n  apiVersion: z.string().optional(),\n});\nexport type REST_APIProvider_Status = z.infer<typeof REST_APIProvider_StatusSchema>;\n"]}

package/dist/esm/protocols/rest-operations.external-connectors-models.schemas.d.ts

@@ -0,0 +1,370 @@
+/**
+ * The REST OPERATION vocabulary — what an operation IS, independent of who executes one.
+ *
+ * Moved here from `@wildo-ai/external-connectors-private/backend` on 2026-09-06 (#378), and the
+ * reason is a measurement rather than tidiness. A generated provider's operation catalogue is loaded
+ * LAZILY on purpose: the loader contract forbids evaluating it at boot, because a provider whose
+ * operations are eager puts every vendor's operations into every process's boot graph. But the
+ * catalogue module needs `ProviderRestParameterLocation` and `ProviderRestRequestBodyEncoding` as
+ * VALUES, and their only public door was the backend barrel — so reading two string enums pulled the
+ * entire backend provider surface in behind them:
+ *
+ * | import | heap | time |
+ * |---|---|---|
+ * | `@wildo-ai/external-connectors-models` | 20.8 MB | 39 ms |
+ * | `@wildo-ai/external-connectors-private/backend` | 160.7 MB | 251 ms |
+ *
+ * 161 MB to answer "is this parameter in the path or the query". The vocabulary belongs here for a
+ * reason that survives the measurement, too: it describes what an operation IS — its method, its
+ * path template, where its parameters ride — and none of that is backend runtime. The arrow already
+ * pointed this way, since this package has no dependency on the private backend and the private
+ * backend depends on it.
+ */
+import { z } from 'zod';
+import { API_HttpMethod } from '../core/commons.external-connectors-models.schemas';
+import { ExternalOperation_Classification } from '../core/operation-classification.external-connectors-models.schemas';
+import type { ExternalProvider_ConnectionTarget } from '../core/security.external-connectors-models.schemas';
+/** Where a declared parameter rides on the wire. */
+export declare enum ProviderRestParameterLocation {
+    /** Substituted into a `{token}` of the path template. Always required — a path cannot have a hole. */
+    PATH = "path",
+    QUERY = "query",
+    HEADER = "header"
+}
+/**
+ * How the request body is encoded. The ETL read surface only ever needed JSON; a hand-authored
+ * write reaches vendors that take form bodies (OAuth-adjacent endpoints, older CRMs) and file
+ * uploads, so the encoding is DECLARED per operation rather than inferred from the method.
+ */
+export declare enum ProviderRestRequestBodyEncoding {
+    JSON = "json",
+    FORM_URLENCODED = "form-urlencoded",
+    MULTIPART = "multipart",
+    /** A raw text body; `contentType` on the declaration says which media type is sent. */
+    TEXT = "text"
+}
+/**
+ * How a listing operation continues. A HINT the caller reads, never something the executor acts
+ * on: an executor that paged on its own would decide a caller's memory budget for it, and the
+ * ETL lane already owns paging as a discipline (drift-safe continuation only).
+ */
+export declare enum ProviderRestPaginationStyle {
+    OFFSET = "offset",
+    PAGE = "page",
+    CURSOR = "cursor",
+    /** The vendor returns its own continuation URL (`@odata.nextLink`, `links.next`). */
+    LINK = "link"
+}
+/** One declared parameter: a wire name, where it rides, and which input field feeds it. */
+export interface ProviderRestOperationParameter {
+    /** The name ON THE WIRE (`page_size`, `X-Vendor-Version`, or the `{token}` in the path). */
+    readonly name: string;
+    readonly in: ProviderRestParameterLocation;
+    /**
+     * The INPUT field that feeds it, when the two differ (`pageSize` → `page_size`). Absent means
+     * the input field is spelled exactly like the wire name. Declared, never camel/snake-guessed:
+     * a guess that is wrong drops a parameter silently and the vendor answers a valid-looking
+     * default page.
+     */
+    readonly from?: string;
+    /** PATH parameters are required whatever this says; for QUERY/HEADER, absent means optional. */
+    readonly required?: boolean;
+    /** A literal value sent on every call — for a version pin or a fixed format selector. */
+    readonly constantValue?: string;
+    readonly description?: string;
+}
+/** How the request body is built from the operation's input. */
+export interface ProviderRestOperationRequestBody {
+    readonly encoding: ProviderRestRequestBodyEncoding;
+    /**
+     * The input field carrying the whole body. Absent = the body is every input field NOT consumed
+     * by a declared parameter — the ordinary shape, and the reason parameters declare `from`.
+     */
+    readonly from?: string;
+    /** For `TEXT`: the media type actually sent (`text/csv`, `application/xml`). */
+    readonly contentType?: string;
+}
+/** Where the payload sits inside a response, and how a listing continues. */
+export interface ProviderRestOperationPagination {
+    readonly style: ProviderRestPaginationStyle;
+    /** OFFSET/PAGE/CURSOR: the request parameter names the caller advances. */
+    readonly limitParam?: string;
+    readonly offsetParam?: string;
+    readonly pageParam?: string;
+    readonly cursorParam?: string;
+    /** CURSOR/LINK: dot-path in the RESPONSE carrying the next cursor or the next URL. */
+    readonly nextPath?: string;
+}
+/**
+ * A provider operation, hand-authored. The unit an application addresses:
+ * `executeProviderOperation({ providerRef: 'slack', operationId: 'conversations.list', input })`.
+ */
+export interface ProviderRestOperation {
+    /** Unique within the provider, and the address an ETL binding reference uses. */
+    readonly operationId: string;
+    /**
+     * The lazy-load unit. `operations('conversations')` answers only this domain's operations, so a
+     * vendor with hundreds need not evaluate them all to run one.
+     */
+    readonly domain: string;
+    readonly method: API_HttpMethod;
+    /** Relative to the provider's base URL. `{token}` interpolates a PATH parameter of that name. */
+    readonly pathTemplate: string;
+    readonly summary?: string;
+    /**
+     * Whether the operation MUTATES the vendor.
+     *
+     * ONE vocabulary for every operation catalogue, whatever produced it: a hand-authored operation
+     * and a generated one are the same concept, and two enums over the same two values is precisely
+     * the drift D1 exists to remove. Read by an ETL binding reference (which refuses to serve a read
+     * surface from a WRITE), by the audit trail as the axis a reviewer filters on first, and by a UI
+     * deciding whether to confirm.
+     *
+     * The name carried a source catalogue's spelling until 2026-09-06 and no longer does — an
+     * operation's EFFECT is not a property of where its definition came from.
+     */
+    readonly classification: ExternalOperation_Classification;
+    readonly parameters?: readonly ProviderRestOperationParameter[];
+    readonly requestBody?: ProviderRestOperationRequestBody;
+    /**
+     * Zod schema the caller's input is parsed through BEFORE anything is compiled. A typed client
+     * (S3b) derives its argument type from it. Absent = the input is passed through unvalidated,
+     * which is legal for a thin wrapper and honest about carrying no contract.
+     */
+    readonly inputSchema?: z.ZodType;
+    /**
+     * Zod schema the RESPONSE is parsed through. Absent = the parsed body is returned as `unknown`.
+     * A vendor adding a field must never break a call, so authors should keep these permissive; the
+     * value is in naming the fields a caller may rely on, not in policing the vendor.
+     */
+    readonly outputSchema?: z.ZodType;
+    /** Dot-path to the payload inside the response body. Absent = the body IS the payload. */
+    readonly resultPath?: string;
+    readonly pagination?: ProviderRestOperationPagination;
+    /**
+     * OAuth scopes (or vendor permission names) the credential must carry. DECLARED in S3a and not
+     * yet CHECKED: checking it needs the composed registry's view of the secrets contract, which is
+     * #329's. Recorded as owed rather than half-enforced — a check that silently passes is worse
+     * than no check.
+     */
+    readonly requiredScopes?: readonly string[];
+    /**
+     * Whether re-sending this request is safe. Absent = derived from the method: GET, HEAD, OPTIONS,
+     * PUT and DELETE are idempotent, POST and PATCH are not.
+     * spec-cite: RFC 9110 §9.2.2 (PUT, DELETE and the safe methods are idempotent) and §9.2.1
+     * (GET, HEAD, OPTIONS, TRACE are safe).
+     * Declare it TRUE on a POST the vendor documents as idempotent (an idempotency-key endpoint);
+     * declaring it wrongly is how a retried timeout charges a customer twice.
+     */
+    readonly idempotent?: boolean;
+    /** Narrows the provider's semantics for this one operation (a slow export, a tight endpoint). */
+    readonly remoteCallSemantics?: Partial<ProviderRestCallSemantics>;
+    /** Set when the vendor has deprecated it; the executor logs once per operation, never refuses. */
+    readonly deprecated?: {
+        readonly reason: string;
+        readonly since?: string;
+        readonly replacedByOperationId?: string;
+    };
+}
+/** What one `operations(domain?)` call answers. */
+export interface ProviderRestOperationCatalogue {
+    /** The domains this load carries — the whole set when called with no argument. */
+    readonly domains: readonly string[];
+    /** Keyed by `operationId`. */
+    readonly operations: Readonly<Record<string, ProviderRestOperation>>;
+}
+/**
+ * The lazy catalogue loader — the seam #330's host loader consumes (interface note on #331).
+ *
+ * MUST NOT be called during composition, discovery or boot: it exists so a provider package can
+ * `import()` its own operation module only when a run needs it, and calling it at boot puts every
+ * provider's operations back into every process's boot graph, which is the thing on-demand
+ * loading exists to remove. Async, idempotent, and memoized by the executor per
+ * `(providerRef, domain)` — a loader may assume one call per pair and must stay correct on two.
+ *
+ * The values it returns carry live Zod schemas, so a catalogue is an IN-PROCESS value and is
+ * never serializable into a runtime artifact or any JSON the CLI emits.
+ */
+export type ProviderRestOperationCatalogueLoader = (domain?: string) => Promise<ProviderRestOperationCatalogue>;
+/**
+ * Provider-level call semantics: the defaults every operation of this provider runs under.
+ *
+ * Structurally the executable subset of the ETL's `HttpApiRemoteCallSemantics`, and deliberately
+ * NOT that type: the ETL's lives in `@wildo-ai/saas-models/external-data` and carries
+ * `maxIdSetSize`, an ETL query-translation bound that means nothing to a provider operation.
+ * Importing it here would point the PROVIDER contract at the ETL read surface — backwards, since
+ * the ETL references provider operations and not the reverse. Three fields is the price of
+ * keeping that arrow pointing the right way.
+ */
+export interface ProviderRestCallSemantics {
+    /** Per-attempt timeout. */
+    readonly timeoutMs: number;
+    readonly retry: {
+        /** Total attempts including the first; 1 disables retry. */
+        readonly maxAttempts: number;
+        /** Linear backoff base — attempt N waits `backoffMs * (N - 1)`. */
+        readonly backoffMs: number;
+    };
+    /** A local sliding-window ceiling; the call REFUSES when exhausted rather than queueing. */
+    readonly maxRequestsPerMinute?: number;
+}
+/**
+ * A provider whose credential is MINTED by an authorization-code exchange rather than pasted.
+ *
+ * Recorded because the source catalogues state it and nothing else does. 131 of the 699 transposed
+ * vendors declare OAuth2, and their authorize URL, token URL and scopes exist nowhere in this
+ * repository except the catalogue that was read — so extracting them and keeping them only in a
+ * comment (which is what the transposer did until 2026-09-07) means the delegated-authorization lane
+ * re-derives 131 vendors' endpoints by hand.
+ *
+ * ## What it does NOT change
+ *
+ * The wire placement. An OAuth2 access token rides in the same header as an API key —
+ * `Authorization: Bearer …` — so `apiKey.headerName` and `apiKey.prefix` still describe the request,
+ * and `apiKey.secretRef` still names the slot the credential is read from. What this block adds is
+ * where that value COMES FROM: an exchange, per organization or per user, refreshable — rather than
+ * an operator pasting a long-lived token into an environment variable.
+ *
+ * That distinction is the whole point. Without it a provider declares a static bearer key and, if an
+ * operator happens to paste a long-lived token, WORKS — while advertising a credential model the
+ * vendor does not offer, with no authorize step, no refresh and no per-tenant token. A wrong
+ * configuration that works is worse than one that fails, because nothing surfaces it.
+ *
+ * The FLOW is not here and is not implied: connected accounts, the authorization round trip, refresh
+ * and revocation are their own lane. This is the declaration that lane consumes.
+ */
+export interface ProviderRestOAuth2 {
+    /** Where the user is sent to grant access. Carries the vendor's own default scopes when it states them. */
+    readonly authorizeUrl: string;
+    /** Where an authorization code (or a refresh token) is exchanged for an access token. */
+    readonly tokenUrl: string;
+    /**
+     * Scopes the vendor's own catalogue entry asked for. Advisory rather than enforced: an application
+     * may need fewer, and an operation's `requiredScopes` is the finer statement. Kept because it is
+     * the only record of what the vendor expects for the operations transposed beside it.
+     */
+    readonly scopes?: readonly string[];
+    /**
+     * Env-var names resolving the APPLICATION's registration with the vendor. These are the two values
+     * an operator genuinely does paste — they identify the integration, not the end user — and they
+     * are separate from `apiKey.secretRef`, which names the minted access token.
+     */
+    readonly clientIdSecretRef?: string;
+    readonly clientSecretSecretRef?: string;
+    /**
+     * Placeholders the endpoints above carry, which a CONNECTION must supply before either URL is a
+     * URL at all — `{cloud}`, `{tenantId}`, `{region}`, `{domain}`.
+     *
+     * Measured over the transposed catalogue on 2026-09-08: of the 96 vendors that recovered both
+     * endpoints, **21 carry at least one placeholder**, led by `{cloud}` (18), `{location}` (10) and
+     * `{tenantId}` (6). Microsoft's authorize URL is
+     * `https://{cloud}/{tenantId}/oauth2/v2.0/authorize`, and no amount of application configuration
+     * supplies those: which Azure cloud and which directory are facts about the ACCOUNT BEING
+     * CONNECTED, known only to the person connecting it.
+     *
+     * So this is not decoration on the endpoint strings — it is the difference between a vendor that
+     * can be connected and one that cannot. Without it the flow would build
+     * `https://{cloud}/…/authorize`, send somebody to a hostname containing a brace, and fail in the
+     * browser rather than at the point where the missing input could have been asked for.
+     *
+     * DERIVED from the endpoint strings rather than authored, so a vendor whose URL gains a
+     * placeholder declares one the next time the batch runs. Absent — not empty — when the endpoints
+     * are plain, which is the common case and must stay distinguishable from "nobody has looked".
+     *
+     * Deliberately NOT a judgement about which connections a provider admits. That is a recorded
+     * decision in the catalogue record and is never read from a vendor's API surface; this is a
+     * mechanical fact about a string.
+     */
+    readonly connectionParameters?: readonly string[];
+}
+/**
+ * Vendors whose credential is COMPUTED per request rather than sent as a fixed header.
+ *
+ * A static header covers bearer tokens and API keys, which is most of the world. It cannot express a
+ * signature: AWS Signature Version 4 signs the method, the canonical path, the sorted query, a
+ * subset of headers, a SHA-256 of the payload and a timestamp, with a key derived from the secret,
+ * the date, the region and the service — so the header's VALUE differs for every request and none of
+ * its inputs exist when a provider module is authored.
+ *
+ * Until this existed, such a vendor could not be expressed at all — not badly, not partially. There
+ * was no `if` to write, because the field where the answer goes did not exist. 45 transposed actions
+ * across `amazon-s3`, `amazon-ses`, `amazon-textract`, `amazon-secrets-manager`, `amazon-sqs`,
+ * `amazon-bedrock`, `azure-blob-storage`, `azure-communication-services` and `azure-openai` are
+ * blocked on it (#373).
+ */
+export declare enum ProviderRestSigningScheme {
+    /**
+     * AWS Signature Version 4 — the `Authorization: AWS4-HMAC-SHA256 …` scheme used by every current
+     * AWS service API.
+     * spec-cite: AWS General Reference, "Signature Version 4 signing process"
+     * (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv4-signing-process.html)
+     */
+    AWS_SIGV4 = "AWS_SIGV4",
+    /**
+     * Azure Storage shared-key — `Authorization: SharedKey <account>:<signature>` over a canonicalized
+     * request and resource.
+     * spec-cite: Azure Storage REST, "Authorize with Shared Key"
+     * (https://learn.microsoft.com/en-us/rest/api/storageservices/authorize-with-shared-key)
+     */
+    AZURE_SHARED_KEY = "AZURE_SHARED_KEY"
+}
+/**
+ * How a provider signs each request.
+ *
+ * Declared by the provider module and executed by the engine, with NO vendor branch in the executor:
+ * the scheme is data, and the signer dispatches on it exhaustively. That is the same discipline the
+ * rest of the provider contract keeps — a consumer branches on a contract field, never on a
+ * provider ref.
+ *
+ * The credential is TWO values for both schemes (an identity and a secret), and optionally a third
+ * for temporary credentials, which is why it cannot ride in the single `apiKey.secretRef` slot.
+ */
+export interface ProviderRestRequestSigning {
+    readonly scheme: ProviderRestSigningScheme;
+    /** Env-var naming the identity half — an AWS access-key id, an Azure storage account name. */
+    readonly keyIdSecretRef: string;
+    /** Env-var naming the secret half. */
+    readonly secretKeySecretRef: string;
+    /**
+     * Env-var naming a session token, for temporary credentials (STS, a role assumption). Absent means
+     * long-lived credentials; present-but-unset is treated as long-lived rather than as an error,
+     * because the same provider serves both.
+     */
+    readonly sessionTokenSecretRef?: string;
+    /**
+     * AWS_SIGV4: the region and service that scope the derived key. Both are part of the SIGNATURE,
+     * not merely of the URL, so a wrong value fails authentication rather than routing — which is why
+     * they are declared rather than parsed out of the host.
+     */
+    readonly region?: string;
+    readonly service?: string;
+    /**
+     * Env-var overriding {@link region} per deployment, for an application that runs in more than one.
+     * The declared value is the default.
+     */
+    readonly regionEnvVarName?: string;
+}
+/**
+ * The one function a generated typed client needs, as a TYPE.
+ *
+ * A generated provider package must not import the engine's runtime to be callable: that would put
+ * the whole backend into the module graph of anything that touches a vendor, which is precisely the
+ * weight #378 removed (models 20.8 MB against the backend barrel's 160.7 MB). So a client is a
+ * FACTORY that takes the executor as an argument — the application wires its own, the package
+ * declares only this signature, and nothing crosses at runtime.
+ *
+ * R3's ergonomics bought with a type rather than a dependency.
+ *
+ * ## The connection is a parameter, and OPTIONAL for a reason that is not convenience
+ *
+ * Omitted means the application's own account, acting as itself — the floor, and the only connection
+ * that needs no store and no authorization. That default is what keeps the ordinary single-account
+ * call as short as it should be.
+ *
+ * It could not be anything BUT a parameter. One execution may legitimately spend several tenants'
+ * accounts — a user action pushing a message to every organization that user belongs to — so a client
+ * that read the owner from ambient state could not vary it per call, and the fan-out would be
+ * inexpressible through the generated surface even though the engine beneath it supports one.
+ */
+export type ProviderOperationExecute = (providerRef: string, operationId: string, input: Readonly<Record<string, unknown>>, connection?: ExternalProvider_ConnectionTarget) => Promise<unknown>;
+//# sourceMappingURL=rest-operations.external-connectors-models.schemas.d.ts.map

package/dist/esm/protocols/rest-operations.external-connectors-models.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-operations.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../../src/protocols/rest-operations.external-connectors-models.schemas.ts"],"names":[],"mappings":"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"}