@zapier/kitcore 0.15.0 → 0.16.0

package/dist/index.d.mts

@@ -1263,10 +1263,10 @@ type DataOf<TResponse> = TResponse extends {
 } ? TData : never;
 /**
  * A leaf plugin that is a single value (not a function). `value` is a static
- * constant; `get({ imports })` computes the value from imports. Like a
- * method's `setup`, `get` runs eagerly at createSdk (dependencies first), so a
- * module-level value is built on import. An imported/surfaced property yields
- * the value, not a callable.
+ * constant; `get({ imports, state })` computes the value from imports and
+ * `setup` state, re-running live on each read. An optional `setup` runs once
+ * eagerly at createSdk (dependencies first, like a method's `setup`) to build
+ * that state. An imported/surfaced property yields the value, not a callable.
  */
 interface PropertyPlugin<TName extends string = string, TValue = unknown> {
     pluginType: "property";
@@ -1306,6 +1306,7 @@ interface PropertyPlugin<TName extends string = string, TValue = unknown> {
     get?: (bag: {
         imports: Record<string, unknown>;
         state: unknown;
+        callContext?: CallContext;
     }) => TValue;
     /** Descriptive metadata for the registry / CLI / MCP / docs (carry-only). */
     meta?: LeafMeta;
@@ -1548,7 +1549,10 @@ interface PropertyEntry {
     pluginType: "property";
     name: string;
     value?: any;
-    getValue?: () => any;
+    /** Re-derives the value per read. Receives the live per-call `CallContext`
+     * when installed on a method's `imports` bag with a threaded context, and
+     * nothing on a surface / build-time read. */
+    getValue?: (callContext?: CallContext) => any;
     /** Carried from the descriptor for the registry / CLI / MCP / docs. */
     meta?: LeafMeta;
     /** Carried from the descriptor: templated registry members for this
@@ -2627,9 +2631,11 @@ declare function declareOptionalMethod<const TId extends string, TInput = unknow
     optional: true;
 } & PluginSummary<never, never>;
 /**
- * Define a property leaf. Either a static `value` or a computed `get` (eager,
- * dependencies first, like `setup`). `createSdk`, a dependent's `imports`, or
- * an aggregate's re-export binds it under its bare `name` and yields the value.
+ * Define a property leaf. Either a static `value` or a computed `get`, which
+ * re-runs live on each read; an optional `setup` runs once at `createSdk`
+ * (dependencies first, like a method's `setup`) to build the state `get` reads.
+ * `createSdk`, a dependent's `imports`, or an aggregate's re-export binds it
+ * under its bare `name` and yields the value.
  */
 declare function defineProperty<const TName extends string, TValue, const TNamespace extends string = "">(config: {
     name: TName;
@@ -2651,6 +2657,13 @@ declare function defineProperty<const TName extends string, TValue, const TImpor
     get: (bag: {
         imports: ImportsOf<TImports>;
         state: TState;
+        /** The live per-call context when the property is read from a method's
+         * `imports` bag — every method call has one, at any depth. Undefined only
+         * where no call is in flight: the property bound onto the SDK object
+         * itself, and reads from a `setup`-time imports bag. A context-aware
+         * property reads its `callId` off this; because its value is then specific
+         * to the reading call, callers must not cache it across calls. */
+        callContext?: CallContext;
     }) => TValue;
     /** Templated registry members for this property's dynamic sub-surface (e.g.
      * a proxy): each a bodyless declaration keyed by `path` instead of `name`. */

package/dist/index.d.ts

@@ -1263,10 +1263,10 @@ type DataOf<TResponse> = TResponse extends {
 } ? TData : never;
 /**
  * A leaf plugin that is a single value (not a function). `value` is a static
- * constant; `get({ imports })` computes the value from imports. Like a
- * method's `setup`, `get` runs eagerly at createSdk (dependencies first), so a
- * module-level value is built on import. An imported/surfaced property yields
- * the value, not a callable.
+ * constant; `get({ imports, state })` computes the value from imports and
+ * `setup` state, re-running live on each read. An optional `setup` runs once
+ * eagerly at createSdk (dependencies first, like a method's `setup`) to build
+ * that state. An imported/surfaced property yields the value, not a callable.
  */
 interface PropertyPlugin<TName extends string = string, TValue = unknown> {
     pluginType: "property";
@@ -1306,6 +1306,7 @@ interface PropertyPlugin<TName extends string = string, TValue = unknown> {
     get?: (bag: {
         imports: Record<string, unknown>;
         state: unknown;
+        callContext?: CallContext;
     }) => TValue;
     /** Descriptive metadata for the registry / CLI / MCP / docs (carry-only). */
     meta?: LeafMeta;
@@ -1548,7 +1549,10 @@ interface PropertyEntry {
     pluginType: "property";
     name: string;
     value?: any;
-    getValue?: () => any;
+    /** Re-derives the value per read. Receives the live per-call `CallContext`
+     * when installed on a method's `imports` bag with a threaded context, and
+     * nothing on a surface / build-time read. */
+    getValue?: (callContext?: CallContext) => any;
     /** Carried from the descriptor for the registry / CLI / MCP / docs. */
     meta?: LeafMeta;
     /** Carried from the descriptor: templated registry members for this
@@ -2627,9 +2631,11 @@ declare function declareOptionalMethod<const TId extends string, TInput = unknow
     optional: true;
 } & PluginSummary<never, never>;
 /**
- * Define a property leaf. Either a static `value` or a computed `get` (eager,
- * dependencies first, like `setup`). `createSdk`, a dependent's `imports`, or
- * an aggregate's re-export binds it under its bare `name` and yields the value.
+ * Define a property leaf. Either a static `value` or a computed `get`, which
+ * re-runs live on each read; an optional `setup` runs once at `createSdk`
+ * (dependencies first, like a method's `setup`) to build the state `get` reads.
+ * `createSdk`, a dependent's `imports`, or an aggregate's re-export binds it
+ * under its bare `name` and yields the value.
  */
 declare function defineProperty<const TName extends string, TValue, const TNamespace extends string = "">(config: {
     name: TName;
@@ -2651,6 +2657,13 @@ declare function defineProperty<const TName extends string, TValue, const TImpor
     get: (bag: {
         imports: ImportsOf<TImports>;
         state: TState;
+        /** The live per-call context when the property is read from a method's
+         * `imports` bag — every method call has one, at any depth. Undefined only
+         * where no call is in flight: the property bound onto the SDK object
+         * itself, and reads from a `setup`-time imports bag. A context-aware
+         * property reads its `callId` off this; because its value is then specific
+         * to the reading call, callers must not cache it across calls. */
+        callContext?: CallContext;
     }) => TValue;
     /** Templated registry members for this property's dynamic sub-surface (e.g.
      * a proxy): each a bodyless declaration keyed by `path` instead of `name`. */

package/dist/index.mjs

@@ -2382,8 +2382,9 @@ function bindValue({
   frameworkOrigin = false
 }) {
   if (entry.pluginType === "property" && entry.getValue) {
+    const getValue = entry.getValue;
     Object.defineProperty(target, key, {
-      get: entry.getValue,
+      get: ctx ? () => getValue(ctx) : getValue,
       enumerable: true,
       configurable: true
     });
@@ -2922,9 +2923,14 @@ function buildEagerArtifacts(descriptors, context, states) {
         plugins[id] = {
           pluginType: "property",
           name: descriptor.name,
-          getValue: () => get({
-            imports: buildImports({ plugins, importBindings }),
-            state: states.get(id)
+          getValue: (callContext) => get({
+            imports: buildImports({
+              plugins,
+              importBindings,
+              ctx: callContext
+            }),
+            state: states.get(id),
+            callContext
           }),
           meta: descriptor.meta,
           dynamicMembers: descriptor.dynamicMembers