@zapier/kitcore 0.5.1 → 0.6.0

package/dist/index.d.mts

@@ -897,6 +897,21 @@ type StrictPage$1<TResponse> = SdkPage<unknown> & {
 type ItemOf$1<TResponse> = TResponse extends SdkPage<infer TItem> ? TItem : TResponse extends {
     data: readonly (infer TItem)[];
 } ? TItem : never;
+/**
+ * A response whose only own key is `data`. Gates the item overload of
+ * `defineMethod` the way `StrictPage` gates list-standard: `run` returns the
+ * `{ data }` envelope itself, and an envelope with extra keys is rejected (a
+ * future variant may accept metadata alongside `data`).
+ */
+type StrictItem<TResponse> = {
+    data: unknown;
+} & {
+    [K in Exclude<keyof TResponse, "data">]?: never;
+};
+/** Data type sourced from an item envelope. */
+type DataOf<TResponse> = TResponse extends {
+    data: infer TData;
+} ? 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
@@ -1928,8 +1943,8 @@ declare function createPluginStack<TRequires = object>(): PluginStack<TRequires,
  *
  * The `output` mode shapes `run`'s result into the public surface and drives
  * the overload that types the call: raw (default, passthrough), `item`
- * (`run` returns `T`, surfaced as `Promise<{ data: T }>`), or `list` (`run`
- * returns one `SdkPage`, surfaced as `PaginatedSdkResult`). See Output.
+ * (`run` returns `{ data: T }`, surfaced as `Promise<{ data: T }>`), or `list`
+ * (`run` returns one `SdkPage`, surfaced as `PaginatedSdkResult`). See Output.
  */
 declare function defineMethod<const TName extends string, TInput, TOutput, const TPositional extends readonly (keyof TInput & string)[] = readonly [], const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
     name: TName;
@@ -1958,7 +1973,7 @@ declare function defineMethod<const TName extends string, TInput, TOutput, const
     }) => void | Promise<void>;
     run: (bag: MethodRunBag<ImportsOf<TImports>, TInput, TState>) => TOutput;
 } & LeafMetaFields): MethodPlugin<TName, TInput, TOutput, TPositional> & LeafSummary<TNamespace, TName, TImports>;
-declare function defineMethod<const TName extends string, TInput, TData, const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
+declare function defineMethod<const TName extends string, TInput, TResponse extends StrictItem<TResponse>, TData = DataOf<TResponse>, const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
     name: TName;
     namespace?: TNamespace;
     imports?: TImports & StaticList<TImports>;
@@ -1976,9 +1991,9 @@ declare function defineMethod<const TName extends string, TInput, TData, const T
         state: TState;
         input?: unknown;
     }) => void | Promise<void>;
-    run: (bag: MethodRunBag<ImportsOf<TImports>, TInput, TState>) => TData;
+    run: (bag: MethodRunBag<ImportsOf<TImports>, TInput, TState>) => TResponse | Promise<TResponse>;
 } & LeafMetaFields): MethodPlugin<TName, TInput, Promise<{
-    data: Awaited<TData>;
+    data: TData;
 }>> & LeafSummary<TNamespace, TName, TImports>;
 declare function defineMethod<const TName extends string, TInput, TResponse extends StrictPage$1<TResponse>, TItem = ItemOf$1<TResponse>, const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
     name: TName;

package/dist/index.d.ts

@@ -897,6 +897,21 @@ type StrictPage$1<TResponse> = SdkPage<unknown> & {
 type ItemOf$1<TResponse> = TResponse extends SdkPage<infer TItem> ? TItem : TResponse extends {
     data: readonly (infer TItem)[];
 } ? TItem : never;
+/**
+ * A response whose only own key is `data`. Gates the item overload of
+ * `defineMethod` the way `StrictPage` gates list-standard: `run` returns the
+ * `{ data }` envelope itself, and an envelope with extra keys is rejected (a
+ * future variant may accept metadata alongside `data`).
+ */
+type StrictItem<TResponse> = {
+    data: unknown;
+} & {
+    [K in Exclude<keyof TResponse, "data">]?: never;
+};
+/** Data type sourced from an item envelope. */
+type DataOf<TResponse> = TResponse extends {
+    data: infer TData;
+} ? 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
@@ -1928,8 +1943,8 @@ declare function createPluginStack<TRequires = object>(): PluginStack<TRequires,
  *
  * The `output` mode shapes `run`'s result into the public surface and drives
  * the overload that types the call: raw (default, passthrough), `item`
- * (`run` returns `T`, surfaced as `Promise<{ data: T }>`), or `list` (`run`
- * returns one `SdkPage`, surfaced as `PaginatedSdkResult`). See Output.
+ * (`run` returns `{ data: T }`, surfaced as `Promise<{ data: T }>`), or `list`
+ * (`run` returns one `SdkPage`, surfaced as `PaginatedSdkResult`). See Output.
  */
 declare function defineMethod<const TName extends string, TInput, TOutput, const TPositional extends readonly (keyof TInput & string)[] = readonly [], const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
     name: TName;
@@ -1958,7 +1973,7 @@ declare function defineMethod<const TName extends string, TInput, TOutput, const
     }) => void | Promise<void>;
     run: (bag: MethodRunBag<ImportsOf<TImports>, TInput, TState>) => TOutput;
 } & LeafMetaFields): MethodPlugin<TName, TInput, TOutput, TPositional> & LeafSummary<TNamespace, TName, TImports>;
-declare function defineMethod<const TName extends string, TInput, TData, const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
+declare function defineMethod<const TName extends string, TInput, TResponse extends StrictItem<TResponse>, TData = DataOf<TResponse>, const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
     name: TName;
     namespace?: TNamespace;
     imports?: TImports & StaticList<TImports>;
@@ -1976,9 +1991,9 @@ declare function defineMethod<const TName extends string, TInput, TData, const T
         state: TState;
         input?: unknown;
     }) => void | Promise<void>;
-    run: (bag: MethodRunBag<ImportsOf<TImports>, TInput, TState>) => TData;
+    run: (bag: MethodRunBag<ImportsOf<TImports>, TInput, TState>) => TResponse | Promise<TResponse>;
 } & LeafMetaFields): MethodPlugin<TName, TInput, Promise<{
-    data: Awaited<TData>;
+    data: TData;
 }>> & LeafSummary<TNamespace, TName, TImports>;
 declare function defineMethod<const TName extends string, TInput, TResponse extends StrictPage$1<TResponse>, TItem = ItemOf$1<TResponse>, const TImports extends ImportsInput = readonly [], const TNamespace extends string = "", TState = undefined>(config: {
     name: TName;

package/dist/index.mjs

@@ -2177,9 +2177,7 @@ function buildMethodEntries(descriptors, context, states) {
         }
       );
     } else if (out.type === "item") {
-      const itemCore = async (input) => ({
-        data: await callRun(input)
-      });
+      const itemCore = async (input) => callRun(input);
       entry.value = createFunction(
         fold(itemCore),
         {