@apicircle/core 1.0.3 → 1.0.5

package/dist/index.d.cts

@@ -204,9 +204,9 @@ interface BuiltRequest {
 }
 /**
  * Resolves an attachment slotId to a Blob (with filename for form-data).
- * The host (UI layer) reads this from its IndexedDB attachments store.
- * Returns null when the attachment is missing — composeBody treats missing
- * attachments as empty fields rather than throwing.
+ * The host reads this from IndexedDB; the CLI reads it from its filesystem
+ * cache. A null return means "not downloaded" and becomes a hard execution
+ * failure.
  */
 type AttachmentResolver = (slotId: string) => Promise<{
     blob: Blob;
@@ -1412,7 +1412,7 @@ interface GraphQLField {
 declare function parseGraphqlSchema(source: string, kind: 'sdl' | 'introspection'): GraphQLSchemaInfo;
 
 type DiffStatus = 'unchanged' | 'local-only' | 'remote-only' | 'both-equal' | 'conflict';
-type EntityBucket = 'request' | 'folder' | 'environment' | 'linkedWorkspace' | 'mockServer' | 'executionPlan' | 'secretKey' | 'globalSchema' | 'globalGraphql' | 'linkedRequestOverride' | 'linkedEnvOverride' | 'releasePerLink' | 'tree' | 'environmentsActive' | 'environmentsPriority' | 'releaseSelf' | 'secretCrypto';
+type EntityBucket = 'request' | 'folder' | 'environment' | 'linkedWorkspace' | 'mockServer' | 'executionPlan' | 'secretKey' | 'globalSchema' | 'globalGraphql' | 'globalFile' | 'linkedRequestOverride' | 'linkedEnvOverride' | 'releasePerLink' | 'tree' | 'environmentsActive' | 'environmentsPriority' | 'releaseSelf' | 'secretCrypto';
 interface DiffEntry {
     bucket: EntityBucket;
     /** Entity id within the bucket. Empty string for singleton buckets. */
@@ -1616,6 +1616,8 @@ interface RunPlanOptions {
     signal?: AbortSignal;
     /** Per-request hard timeout in ms. `null` disables. Defaults to executeRequest's 30s. */
     timeoutMs?: number | null;
+    /** Resolver for local and linked attachment bytes used by file/binary bodies. */
+    resolveAttachment?: AttachmentResolver;
     /** Plaintext secret values keyed by `secretKeyId`, for encrypted env vars. */
     secretsById?: Record<string, string>;
     /** Identity of whoever launched the run. Defaults to {@link ANONYMOUS_ACTOR}. */

package/dist/index.d.ts

@@ -204,9 +204,9 @@ interface BuiltRequest {
 }
 /**
  * Resolves an attachment slotId to a Blob (with filename for form-data).
- * The host (UI layer) reads this from its IndexedDB attachments store.
- * Returns null when the attachment is missing — composeBody treats missing
- * attachments as empty fields rather than throwing.
+ * The host reads this from IndexedDB; the CLI reads it from its filesystem
+ * cache. A null return means "not downloaded" and becomes a hard execution
+ * failure.
  */
 type AttachmentResolver = (slotId: string) => Promise<{
     blob: Blob;
@@ -1412,7 +1412,7 @@ interface GraphQLField {
 declare function parseGraphqlSchema(source: string, kind: 'sdl' | 'introspection'): GraphQLSchemaInfo;
 
 type DiffStatus = 'unchanged' | 'local-only' | 'remote-only' | 'both-equal' | 'conflict';
-type EntityBucket = 'request' | 'folder' | 'environment' | 'linkedWorkspace' | 'mockServer' | 'executionPlan' | 'secretKey' | 'globalSchema' | 'globalGraphql' | 'linkedRequestOverride' | 'linkedEnvOverride' | 'releasePerLink' | 'tree' | 'environmentsActive' | 'environmentsPriority' | 'releaseSelf' | 'secretCrypto';
+type EntityBucket = 'request' | 'folder' | 'environment' | 'linkedWorkspace' | 'mockServer' | 'executionPlan' | 'secretKey' | 'globalSchema' | 'globalGraphql' | 'globalFile' | 'linkedRequestOverride' | 'linkedEnvOverride' | 'releasePerLink' | 'tree' | 'environmentsActive' | 'environmentsPriority' | 'releaseSelf' | 'secretCrypto';
 interface DiffEntry {
     bucket: EntityBucket;
     /** Entity id within the bucket. Empty string for singleton buckets. */
@@ -1616,6 +1616,8 @@ interface RunPlanOptions {
     signal?: AbortSignal;
     /** Per-request hard timeout in ms. `null` disables. Defaults to executeRequest's 30s. */
     timeoutMs?: number | null;
+    /** Resolver for local and linked attachment bytes used by file/binary bodies. */
+    resolveAttachment?: AttachmentResolver;
     /** Plaintext secret values keyed by `secretKeyId`, for encrypted env vars. */
     secretsById?: Record<string, string>;
     /** Identity of whoever launched the run. Defaults to {@link ANONYMOUS_ACTOR}. */