@zapier/zapier-sdk 0.73.0 → 0.74.0

package/dist/plugins/codeSubstrate/shared.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 /**
  * Method-meta defaults shared across every workflow plugin. Each plugin
  * spreads `...codeSubstrateDefaults` into its `createPluginMethod` /
@@ -13,4 +14,59 @@ export declare const codeSubstrateDefaults: {
     categories: string[];
     experimental: true;
 };
+/**
+ * Source files map, shared by `runDurable` and `publishWorkflowVersion`.
+ * Both require at least one file.
+ */
+export declare const SourceFilesSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+/**
+ * A Zapier connection ID accepted on the wire: a positive integer (legacy)
+ * or a UUID string (newer connections). Split into three union members so a
+ * bad value produces a precise message at the input boundary.
+ */
+export declare const ConnectionIdValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>;
+/**
+ * Connection binding: maps a single alias to a concrete connection. The
+ * locator is camelCase (`connectionId`) per SDK convention; the snake_case
+ * `connection_id` is a deprecated alias. Both are optional in the schema so
+ * `.shape` stays introspectable for docs — the wire mapper enforces that one
+ * is present (see {@link toWireConnections}).
+ */
+export declare const ConnectionBindingSchema: z.ZodObject<{
+    connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>;
+/**
+ * App-version binding: maps an app key to a pinned implementation/version.
+ * `implementationName` is the camelCase locator; `implementation_name` is a
+ * deprecated alias. Required-ness of the name is enforced by the wire mapper
+ * (see {@link toWireAppVersions}).
+ */
+export declare const AppVersionBindingSchema: z.ZodObject<{
+    implementationName: z.ZodOptional<z.ZodString>;
+    implementation_name: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ConnectionEntryInput = z.infer<typeof ConnectionBindingSchema>;
+type AppVersionEntryInput = z.infer<typeof AppVersionBindingSchema>;
+/**
+ * Reshape a caller's `connections` map into the wire body. The nested
+ * locator is camelCase (`connectionId`) per SDK convention but the API
+ * expects `connection_id`; the deprecated snake_case alias is still
+ * accepted. The connection ID itself is required, so a missing one is a
+ * client-side validation error rather than a malformed request.
+ */
+export declare function toWireConnections(connections: Record<string, ConnectionEntryInput>): Record<string, {
+    connection_id: string | number;
+}>;
+/**
+ * Reshape a caller's `appVersions` map into the wire body, mapping the
+ * camelCase `implementationName` locator (and its deprecated snake_case
+ * alias) onto the API's `implementation_name`.
+ */
+export declare function toWireAppVersions(appVersions: Record<string, AppVersionEntryInput>): Record<string, {
+    implementation_name: string;
+    version?: string;
+}>;
+export {};
 //# sourceMappingURL=shared.d.ts.map

package/dist/plugins/codeSubstrate/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/plugins/codeSubstrate/shared.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;;;CAGH,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/plugins/codeSubstrate/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB;;;CAGH,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,uCAK0B,CAAC;AAYzD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,8DAQjC,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;iBAIlC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;iBAYlC,CAAC;AAEH,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACpE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAChD,MAAM,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC,CAYpD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAChD,MAAM,CAAC,MAAM,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBnE"}

package/dist/plugins/codeSubstrate/shared.js

@@ -1,3 +1,5 @@
+import { z } from "zod";
+import { ZapierValidationError } from "../../types/errors";
 /**
  * Method-meta defaults shared across every workflow plugin. Each plugin
  * spreads `...codeSubstrateDefaults` into its `createPluginMethod` /
@@ -13,3 +15,101 @@ export const codeSubstrateDefaults = {
     categories: ["code-workflow"],
     experimental: true,
 };
+/**
+ * Source files map, shared by `runDurable` and `publishWorkflowVersion`.
+ * Both require at least one file.
+ */
+export const SourceFilesSchema = z
+    .record(z.string(), z.string())
+    .refine((files) => Object.keys(files).length > 0, {
+    message: "sourceFiles must contain at least one file",
+})
+    .describe("Source files keyed by filename → contents");
+// Structural UUID match (8-4-4-4-12 hex), not `z.uuid()`. Both backends
+// validate `connection_id` with this same structural regex and intentionally
+// do NOT enforce RFC version/variant nibbles:
+//   - durableworkflowzaps `CreateWorkflowVersionRequest` (publishWorkflowVersion)
+//   - sdkdurableapi `StartRunRequest` (runDurable)
+// `z.uuid()` is stricter — it rejects non-RFC variants — so it would reject IDs
+// these backends accept. The SDK boundary must not be stricter than the wire.
+const UUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+/**
+ * A Zapier connection ID accepted on the wire: a positive integer (legacy)
+ * or a UUID string (newer connections). Split into three union members so a
+ * bad value produces a precise message at the input boundary.
+ */
+export const ConnectionIdValueSchema = z
+    .union([
+    z.string().regex(/^[1-9][0-9]*$/, "must be a positive integer string"),
+    z.string().regex(UUID_PATTERN, "must be a UUID"),
+    z.number().int().positive(),
+])
+    .describe("Zapier connection ID. Accepts a positive integer (legacy) or a UUID string (newer connections).");
+/**
+ * Connection binding: maps a single alias to a concrete connection. The
+ * locator is camelCase (`connectionId`) per SDK convention; the snake_case
+ * `connection_id` is a deprecated alias. Both are optional in the schema so
+ * `.shape` stays introspectable for docs — the wire mapper enforces that one
+ * is present (see {@link toWireConnections}).
+ */
+export const ConnectionBindingSchema = z.object({
+    connectionId: ConnectionIdValueSchema.optional(),
+    /** @deprecated Use `connectionId` instead. */
+    connection_id: ConnectionIdValueSchema.optional().meta({ deprecated: true }),
+});
+/**
+ * App-version binding: maps an app key to a pinned implementation/version.
+ * `implementationName` is the camelCase locator; `implementation_name` is a
+ * deprecated alias. Required-ness of the name is enforced by the wire mapper
+ * (see {@link toWireAppVersions}).
+ */
+export const AppVersionBindingSchema = z.object({
+    implementationName: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Zapier app implementation name (e.g. `SlackCLIAPI`)"),
+    /** @deprecated Use `implementationName` instead. */
+    implementation_name: z.string().min(1).optional().meta({ deprecated: true }),
+    version: z
+        .string()
+        .optional()
+        .describe("Pinned app version (e.g. `1.27.1`). Latest if omitted."),
+});
+/**
+ * Reshape a caller's `connections` map into the wire body. The nested
+ * locator is camelCase (`connectionId`) per SDK convention but the API
+ * expects `connection_id`; the deprecated snake_case alias is still
+ * accepted. The connection ID itself is required, so a missing one is a
+ * client-side validation error rather than a malformed request.
+ */
+export function toWireConnections(connections) {
+    const wire = {};
+    for (const [alias, entry] of Object.entries(connections)) {
+        const connectionId = entry.connectionId ?? entry.connection_id;
+        if (connectionId === undefined) {
+            throw new ZapierValidationError(`connections["${alias}"] is missing connectionId`);
+        }
+        wire[alias] = { connection_id: connectionId };
+    }
+    return wire;
+}
+/**
+ * Reshape a caller's `appVersions` map into the wire body, mapping the
+ * camelCase `implementationName` locator (and its deprecated snake_case
+ * alias) onto the API's `implementation_name`.
+ */
+export function toWireAppVersions(appVersions) {
+    const wire = {};
+    for (const [key, entry] of Object.entries(appVersions)) {
+        const implementationName = entry.implementationName ?? entry.implementation_name;
+        if (implementationName === undefined) {
+            throw new ZapierValidationError(`appVersions["${key}"] is missing implementationName`);
+        }
+        wire[key] = {
+            implementation_name: implementationName,
+            ...(entry.version !== undefined ? { version: entry.version } : {}),
+        };
+    }
+    return wire;
+}

package/dist/utils/caller-context.d.ts

@@ -0,0 +1,21 @@
+export interface CallerContext {
+    packageOperation?: string;
+}
+/**
+ * Run `fn` with the given caller context merged onto any parent context, so
+ * the operation that initiated the call (e.g. a CLI command or MCP tool) stays
+ * observable through every SDK call it makes.
+ *
+ * Caller context is telemetry-only: reading the parent scope is wrapped so a
+ * broken ALS store can never crash the wrapped command. Errors thrown by `fn`
+ * itself are intentionally NOT caught — they propagate.
+ */
+export declare function runWithCallerContext<T>(context: CallerContext, fn: () => T): T;
+/**
+ * Read the active caller context, or an empty object outside any caller scope.
+ *
+ * Read on the outbound HTTP path to set a telemetry header, so a failure here
+ * must never break the request — it falls back to an empty context.
+ */
+export declare function getCallerContext(): CallerContext;
+//# sourceMappingURL=caller-context.d.ts.map

package/dist/utils/caller-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-context.d.ts","sourceRoot":"","sources":["../../src/utils/caller-context.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,OAAO,EAAE,aAAa,EACtB,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAQH;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAMhD"}

package/dist/utils/caller-context.js

@@ -0,0 +1,35 @@
+import { createAsyncContext } from "kitcore";
+const callerContext = createAsyncContext();
+/**
+ * Run `fn` with the given caller context merged onto any parent context, so
+ * the operation that initiated the call (e.g. a CLI command or MCP tool) stays
+ * observable through every SDK call it makes.
+ *
+ * Caller context is telemetry-only: reading the parent scope is wrapped so a
+ * broken ALS store can never crash the wrapped command. Errors thrown by `fn`
+ * itself are intentionally NOT caught — they propagate.
+ */
+export function runWithCallerContext(context, fn) {
+    let parent;
+    try {
+        parent = callerContext.get() ?? {};
+    }
+    catch {
+        return fn();
+    }
+    return callerContext.run({ ...parent, ...context }, fn);
+}
+/**
+ * Read the active caller context, or an empty object outside any caller scope.
+ *
+ * Read on the outbound HTTP path to set a telemetry header, so a failure here
+ * must never break the request — it falls back to an empty context.
+ */
+export function getCallerContext() {
+    try {
+        return callerContext.get() ?? {};
+    }
+    catch {
+        return {};
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.73.0",
+  "version": "0.74.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -95,7 +95,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^4.1.4",
-    "kitcore": "0.0.1"
+    "kitcore": "0.1.0"
   },
   "scripts": {
     "build": "tsup",