@zayne-labs/callapi-plugins 4.0.30 → 4.0.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,7 +9,7 @@ declare const fallBackRouteSchemaKey = "@default";
9
9
  type FallBackRouteSchemaKey = typeof fallBackRouteSchemaKey;
10
10
  //#endregion
11
11
  //#endregion
12
- //#region ../callapi/dist/index-DvEQIgL-.d.ts
12
+ //#region ../callapi/dist/index-BDKB03qO.d.ts
13
13
  //#region src/types/type-helpers.d.ts
14
14
  type AnyString = string & NonNullable<unknown>;
15
15
  type AnyNumber = number & NonNullable<unknown>;
@@ -102,156 +102,6 @@ type StreamProgressEvent = {
102
102
  transferredBytes: number;
103
103
  };
104
104
  //#endregion
105
- //#region src/middlewares.d.ts
106
- type FetchImpl = UnmaskType<(input: string | Request | URL, init?: RequestInit) => Promise<Response>>;
107
- interface Middlewares<TCallApiContext extends NoInfer<CallApiContext> = DefaultCallApiContext> {
108
- /**
109
- * Wraps the fetch implementation to intercept requests at the network layer.
110
- *
111
- * Takes a context object containing the current fetch function and returns a new fetch function.
112
- * Use it to cache responses, add logging, handle offline mode, or short-circuit requests etc.
113
- * Multiple middleware compose in order: plugins → base config → per-request.
114
- *
115
- * Unlike `customFetchImpl`, middleware can call through to the original fetch.
116
- *
117
- * @example
118
- * ```ts
119
- * // Cache responses
120
- * const cache = new Map();
121
- *
122
- * fetchMiddleware: (ctx) => async (input, init) => {
123
- * const key = input.toString();
124
- * if (cache.has(key)) return cache.get(key).clone();
125
- *
126
- * const response = await ctx.fetchImpl(input, init);
127
- * cache.set(key, response.clone());
128
- * return response;
129
- * }
130
- *
131
- * // Handle offline
132
- * fetchMiddleware: (ctx) => async (input, init) => {
133
- * if (!navigator.onLine) {
134
- * return new Response('{"error": "offline"}', { status: 503 });
135
- * }
136
- * return ctx.fetchImpl(input, init);
137
- * }
138
- * ```
139
- */
140
- fetchMiddleware?: (context: RequestContext<TCallApiContext> & {
141
- fetchImpl: FetchImpl;
142
- }) => FetchImpl;
143
- }
144
- //#endregion
145
- //#region src/types/conditional-types.d.ts
146
- /**
147
- * @description Makes a type partial if the output type of TSchema is not provided or has undefined in the union, otherwise makes it required
148
- */
149
- type MakeSchemaOptionRequiredIfDefined<TSchemaOption extends CallApiSchema[keyof CallApiSchema], TObject> = undefined extends InferSchemaOutput<TSchemaOption, undefined> ? TObject : Required<TObject>;
150
- type ApplyURLBasedConfig<TSchemaConfig extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = TSchemaConfig["prefix"] extends string ? `${TSchemaConfig["prefix"]}${TSchemaRouteKeys}` : TSchemaConfig["baseURL"] extends string ? `${TSchemaConfig["baseURL"]}${TSchemaRouteKeys}` : TSchemaRouteKeys;
151
- type ApplyStrictConfig<TSchemaConfig extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = TSchemaConfig["strict"] extends true ? TSchemaRouteKeys :
152
- // eslint-disable-next-line perfectionist/sort-union-types -- Don't sort union types
153
- TSchemaRouteKeys | Exclude<InitURLOrURLObject, RouteKeyMethodsURLUnion>;
154
- type ApplySchemaConfiguration<TSchemaConfig extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = ApplyStrictConfig<TSchemaConfig, ApplyURLBasedConfig<TSchemaConfig, TSchemaRouteKeys>>;
155
- type InferAllRouteKeys<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TSchemaConfig extends CallApiSchemaConfig> = ApplySchemaConfiguration<TSchemaConfig, Exclude<Extract<keyof TBaseSchemaRoutes, string>, FallBackRouteSchemaKey>>;
156
- type InferInitURL<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TSchemaConfig extends CallApiSchemaConfig> = keyof TBaseSchemaRoutes extends never ? InitURLOrURLObject : InferAllRouteKeys<TBaseSchemaRoutes, TSchemaConfig>;
157
- type GetCurrentRouteSchema<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TComputedFallBackRouteSchema = TBaseSchemaRoutes[FallBackRouteSchemaKey], TComputedCurrentRouteSchema = TBaseSchemaRoutes[TCurrentRouteSchemaKey], TComputedRouteSchema extends CallApiSchema = NonNullable<Omit<TComputedFallBackRouteSchema, keyof TComputedCurrentRouteSchema> & TComputedCurrentRouteSchema>> = TComputedRouteSchema extends CallApiSchema ? Writeable<TComputedRouteSchema, "deep"> : CallApiSchema;
158
- type JsonPrimitive = boolean | number | string | null | undefined;
159
- type SerializableObject = Record<PropertyKey, unknown>;
160
- type SerializableArray = Array<JsonPrimitive | SerializableObject> | ReadonlyArray<JsonPrimitive | SerializableObject>;
161
- type Body = UnmaskType<Exclude<RequestInit["body"], undefined> | SerializableArray | SerializableObject>;
162
- type InferBodyOption<TSchema extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema["body"], {
163
- /**
164
- * Body of the request, can be a object or any other supported body type.
165
- */
166
- body?: InferSchemaOutput<TSchema["body"], Body>;
167
- }>;
168
- type MethodUnion = UnmaskType<"CONNECT" | "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT" | "TRACE" | AnyString>;
169
- type InferMethodFromURL<TInitURL> = string extends TInitURL ? MethodUnion : TInitURL extends `@${infer TMethod extends RouteKeyMethods}/${string}` ? Uppercase<TMethod> : MethodUnion;
170
- type InferMethodOption<TSchema extends CallApiSchema, TInitURL> = MakeSchemaOptionRequiredIfDefined<TSchema["method"], {
171
- /**
172
- * HTTP method for the request.
173
- * @default "GET"
174
- */
175
- method?: InferSchemaOutput<TSchema["method"], InferMethodFromURL<TInitURL>>;
176
- }>;
177
- type HeadersOption = UnmaskType<Record<"Authorization", CommonAuthorizationHeaders | undefined> | Record<"Content-Type", CommonContentTypes | undefined> | Record<CommonRequestHeaders, string | undefined> | Record<string, string | undefined> | Array<[string, string]>>;
178
- type InferHeadersOption<TSchema extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema["headers"], {
179
- /**
180
- * Headers to be used in the request.
181
- */
182
- headers?: InferSchemaOutput<TSchema["headers"], HeadersOption> | ((context: {
183
- baseHeaders: NonNullable<HeadersOption>;
184
- }) => InferSchemaOutput<TSchema["headers"], HeadersOption>);
185
- }>;
186
- type InferRequestOptions<TSchema extends CallApiSchema, TInitURL extends InferInitURL<BaseCallApiSchemaRoutes, CallApiSchemaConfig>> = InferBodyOption<TSchema> & InferHeadersOption<TSchema> & InferMethodOption<TSchema, TInitURL>;
187
- type InferMetaOption<TSchema extends CallApiSchema, TCallApiContext extends CallApiContext> = MakeSchemaOptionRequiredIfDefined<TSchema["meta"], {
188
- /**
189
- * - An optional field you can fill with additional information,
190
- * to associate with the request, typically used for logging or tracing.
191
- *
192
- * - A good use case for this, would be to use the info to handle specific cases in any of the shared interceptors.
193
- *
194
- * @example
195
- * ```ts
196
- * const callMainApi = callApi.create({
197
- * baseURL: "https://main-api.com",
198
- * onResponseError: ({ response, options }) => {
199
- * if (options.meta?.userId) {
200
- * console.error(`User ${options.meta.userId} made an error`);
201
- * }
202
- * },
203
- * });
204
- *
205
- * const response = await callMainApi({
206
- * url: "https://example.com/api/data",
207
- * meta: { userId: "123" },
208
- * });
209
- * ```
210
- */
211
- meta?: InferSchemaOutput<TSchema["meta"], TCallApiContext["Meta"]>;
212
- }>;
213
- type InferQueryOption<TSchema extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema["query"], {
214
- /**
215
- * Parameters to be appended to the URL (i.e: /:id)
216
- */
217
- query?: InferSchemaOutput<TSchema["query"], Query>;
218
- }>;
219
- type EmptyString = "";
220
- type EmptyTuple = readonly [];
221
- type StringTuple = readonly string[];
222
- type PossibleParamNamePatterns = `${string}:${string}` | `${string}{${string}}${"" | AnyString}`;
223
- type ExtractRouteParamNames<TCurrentRoute$1, TParamNamesAccumulator extends StringTuple = EmptyTuple> = TCurrentRoute$1 extends PossibleParamNamePatterns ? TCurrentRoute$1 extends `${infer TRoutePrefix}:${infer TParamAndRemainingRoute}` ? TParamAndRemainingRoute extends `${infer TCurrentParam}/${infer TRemainingRoute}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<`${TRoutePrefix}/${TRemainingRoute}`, TParamNamesAccumulator> : ExtractRouteParamNames<`${TRoutePrefix}/${TRemainingRoute}`, [...TParamNamesAccumulator, TCurrentParam]> : TParamAndRemainingRoute extends `${infer TCurrentParam}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<TRoutePrefix, TParamNamesAccumulator> : ExtractRouteParamNames<TRoutePrefix, [...TParamNamesAccumulator, TCurrentParam]> : ExtractRouteParamNames<TRoutePrefix, TParamNamesAccumulator> : TCurrentRoute$1 extends `${infer TRoutePrefix}{${infer TCurrentParam}}${infer TRemainingRoute}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<`${TRoutePrefix}${TRemainingRoute}`, TParamNamesAccumulator> : ExtractRouteParamNames<`${TRoutePrefix}${TRemainingRoute}`, [...TParamNamesAccumulator, TCurrentParam]> : TParamNamesAccumulator : TParamNamesAccumulator;
224
- type ConvertParamNamesToRecord<TParamNames extends StringTuple> = Prettify<TParamNames extends (readonly [infer TFirstParamName extends string, ...infer TRemainingParamNames extends StringTuple]) ? Record<TFirstParamName, AllowedQueryParamValues> & ConvertParamNamesToRecord<TRemainingParamNames> : NonNullable<unknown>>;
225
- type ConvertParamNamesToTuple<TParamNames extends StringTuple> = TParamNames extends readonly [string, ...infer TRemainingParamNames extends StringTuple] ? [AllowedQueryParamValues, ...ConvertParamNamesToTuple<TRemainingParamNames>] : [];
226
- type InferParamsFromRoute<TCurrentRoute$1> = ExtractRouteParamNames<TCurrentRoute$1> extends StringTuple ? ExtractRouteParamNames<TCurrentRoute$1> extends EmptyTuple ? Params : ConvertParamNamesToRecord<ExtractRouteParamNames<TCurrentRoute$1>> | ConvertParamNamesToTuple<ExtractRouteParamNames<TCurrentRoute$1>> : Params;
227
- type MakeParamsOptionRequired<TParamsSchemaOption extends CallApiSchema["params"], TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TObject> = MakeSchemaOptionRequiredIfDefined<TParamsSchemaOption, Params extends InferParamsFromRoute<TCurrentRouteSchemaKey> ? TObject : TCurrentRouteSchemaKey extends Extract<keyof TBaseSchemaRoutes, TCurrentRouteSchemaKey> ? undefined extends InferSchemaOutput<TParamsSchemaOption, null> ? TObject : Required<TObject> : TObject>;
228
- type InferParamsOption<TSchema extends CallApiSchema, TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string> = MakeParamsOptionRequired<TSchema["params"], TBaseSchemaRoutes, TCurrentRouteSchemaKey, {
229
- /**
230
- * Parameters to be appended to the URL (i.e: /:id)
231
- */
232
- params?: InferSchemaOutput<TSchema["params"], InferParamsFromRoute<TCurrentRouteSchemaKey>>;
233
- }>;
234
- type InferExtraOptions<TSchema extends CallApiSchema, TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TCallApiContext extends CallApiContext> = InferMetaOption<TSchema, TCallApiContext> & InferParamsOption<TSchema, TBaseSchemaRoutes, TCurrentRouteSchemaKey> & InferQueryOption<TSchema>;
235
- type InferPluginExtraOptions<TPluginArray extends CallApiPlugin[]> = UnionToIntersection<TPluginArray extends Array<infer TPlugin> ? TPlugin extends CallApiPlugin ? TPlugin["defineExtraOptions"] extends AnyFunction$1<infer TReturnedSchema> ? InferSchemaOutput<TReturnedSchema> : never : never : never>;
236
- type ResultModeOption<TErrorData, TResultMode extends ResultModeType> = TErrorData extends false ? {
237
- resultMode: "onlyData";
238
- } : TErrorData extends false | undefined ? {
239
- resultMode?: "onlyData";
240
- } : {
241
- resultMode?: TResultMode;
242
- };
243
- type ThrowOnErrorUnion = boolean;
244
- type ThrowOnErrorType<TErrorData, TThrowOnError extends ThrowOnErrorUnion> = TThrowOnError | ((context: ErrorContext<{
245
- ErrorData: TErrorData;
246
- }>) => TThrowOnError);
247
- type ThrowOnErrorOption<TErrorData, TThrowOnError extends ThrowOnErrorUnion> = TErrorData extends false ? {
248
- throwOnError: true;
249
- } : TErrorData extends false | undefined ? {
250
- throwOnError?: true;
251
- } : {
252
- throwOnError?: ThrowOnErrorType<TErrorData, TThrowOnError>;
253
- };
254
- //#endregion
255
105
  //#region src/types/standard-schema.d.ts
256
106
  /**
257
107
  * The Standard Schema interface.
@@ -356,6 +206,7 @@ declare namespace StandardSchemaV1 {
356
206
  type ResultVariant = "infer-input" | "infer-output";
357
207
  type InferSchemaResult<TSchema, TFallbackResult, TResultVariant extends ResultVariant> = undefined extends TSchema ? TFallbackResult : TSchema extends StandardSchemaV1 ? TResultVariant extends "infer-input" ? StandardSchemaV1.InferInput<TSchema> : StandardSchemaV1.InferOutput<TSchema> : TSchema extends AnyFunction$1<infer TResult> ? Awaited<TResult> : TFallbackResult;
358
208
  type InferSchemaOutput<TSchema, TFallbackResult = unknown> = InferSchemaResult<TSchema, TFallbackResult, "infer-output">;
209
+ type BooleanObject = { [Key in keyof CallApiSchema]: boolean };
359
210
  interface CallApiSchemaConfig {
360
211
  /**
361
212
  * The base url of the schema. By default it's the baseURL of the callApi instance.
@@ -364,14 +215,14 @@ interface CallApiSchemaConfig {
364
215
  /**
365
216
  * Disables runtime validation for the schema.
366
217
  */
367
- disableRuntimeValidation?: boolean;
218
+ disableRuntimeValidation?: boolean | BooleanObject;
368
219
  /**
369
220
  * If `true`, the original input value will be used instead of the transformed/validated output.
370
221
  *
371
222
  * This is useful when you want to validate the input but don't want any transformations
372
223
  * applied by the validation schema (e.g., type coercion, default values, etc).
373
224
  */
374
- disableValidationOutputApplication?: boolean;
225
+ disableValidationOutputApplication?: boolean | BooleanObject;
375
226
  /**
376
227
  * Optional url prefix that will be substituted for the `baseURL` of the schemaConfig at runtime.
377
228
  *
@@ -556,6 +407,156 @@ interface URLOptions {
556
407
  query?: Query;
557
408
  }
558
409
  //#endregion
410
+ //#region src/types/conditional-types.d.ts
411
+ /**
412
+ * @description Makes a type partial if the output type of TSchema is not provided or has undefined in the union, otherwise makes it required
413
+ */
414
+ type MakeSchemaOptionRequiredIfDefined<TSchemaOption extends CallApiSchema[keyof CallApiSchema], TObject> = undefined extends InferSchemaOutput<TSchemaOption, undefined> ? TObject : Required<TObject>;
415
+ type ApplyURLBasedConfig<TSchemaConfig extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = TSchemaConfig["prefix"] extends string ? `${TSchemaConfig["prefix"]}${TSchemaRouteKeys}` : TSchemaConfig["baseURL"] extends string ? `${TSchemaConfig["baseURL"]}${TSchemaRouteKeys}` : TSchemaRouteKeys;
416
+ type ApplyStrictConfig<TSchemaConfig extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = TSchemaConfig["strict"] extends true ? TSchemaRouteKeys :
417
+ // eslint-disable-next-line perfectionist/sort-union-types -- Don't sort union types
418
+ TSchemaRouteKeys | Exclude<InitURLOrURLObject, RouteKeyMethodsURLUnion>;
419
+ type ApplySchemaConfiguration<TSchemaConfig extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = ApplyStrictConfig<TSchemaConfig, ApplyURLBasedConfig<TSchemaConfig, TSchemaRouteKeys>>;
420
+ type InferAllRouteKeys<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TSchemaConfig extends CallApiSchemaConfig> = ApplySchemaConfiguration<TSchemaConfig, Exclude<Extract<keyof TBaseSchemaRoutes, string>, FallBackRouteSchemaKey>>;
421
+ type InferInitURL<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TSchemaConfig extends CallApiSchemaConfig> = keyof TBaseSchemaRoutes extends never ? InitURLOrURLObject : InferAllRouteKeys<TBaseSchemaRoutes, TSchemaConfig>;
422
+ type GetCurrentRouteSchema<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TComputedFallBackRouteSchema = TBaseSchemaRoutes[FallBackRouteSchemaKey], TComputedCurrentRouteSchema = TBaseSchemaRoutes[TCurrentRouteSchemaKey], TComputedRouteSchema extends CallApiSchema = NonNullable<Omit<TComputedFallBackRouteSchema, keyof TComputedCurrentRouteSchema> & TComputedCurrentRouteSchema>> = TComputedRouteSchema extends CallApiSchema ? Writeable<TComputedRouteSchema, "deep"> : CallApiSchema;
423
+ type JsonPrimitive = boolean | number | string | null | undefined;
424
+ type SerializableObject = Record<PropertyKey, unknown>;
425
+ type SerializableArray = Array<JsonPrimitive | SerializableObject> | ReadonlyArray<JsonPrimitive | SerializableObject>;
426
+ type Body = UnmaskType<Exclude<RequestInit["body"], undefined> | SerializableArray | SerializableObject>;
427
+ type InferBodyOption<TSchema extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema["body"], {
428
+ /**
429
+ * Body of the request, can be a object or any other supported body type.
430
+ */
431
+ body?: InferSchemaOutput<TSchema["body"], Body>;
432
+ }>;
433
+ type MethodUnion = UnmaskType<"CONNECT" | "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT" | "TRACE" | AnyString>;
434
+ type InferMethodFromURL<TInitURL> = string extends TInitURL ? MethodUnion : TInitURL extends `@${infer TMethod extends RouteKeyMethods}/${string}` ? Uppercase<TMethod> : MethodUnion;
435
+ type InferMethodOption<TSchema extends CallApiSchema, TInitURL> = MakeSchemaOptionRequiredIfDefined<TSchema["method"], {
436
+ /**
437
+ * HTTP method for the request.
438
+ * @default "GET"
439
+ */
440
+ method?: InferSchemaOutput<TSchema["method"], InferMethodFromURL<TInitURL>>;
441
+ }>;
442
+ type HeadersOption = UnmaskType<Headers | Record<"Authorization", CommonAuthorizationHeaders | undefined> | Record<"Content-Type", CommonContentTypes | undefined> | Record<CommonRequestHeaders, string | undefined> | Record<string, string | undefined> | Array<[string, string]>>;
443
+ type InferHeadersOption<TSchema extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema["headers"], {
444
+ /**
445
+ * Headers to be used in the request.
446
+ */
447
+ headers?: InferSchemaOutput<TSchema["headers"], HeadersOption> | ((context: {
448
+ baseHeaders: Extract<HeadersOption, Record<string, unknown>>;
449
+ }) => InferSchemaOutput<TSchema["headers"], HeadersOption>);
450
+ }>;
451
+ type InferRequestOptions<TSchema extends CallApiSchema, TInitURL extends InferInitURL<BaseCallApiSchemaRoutes, CallApiSchemaConfig>> = InferBodyOption<TSchema> & InferHeadersOption<TSchema> & InferMethodOption<TSchema, TInitURL>;
452
+ type InferMetaOption<TSchema extends CallApiSchema, TCallApiContext extends CallApiContext> = MakeSchemaOptionRequiredIfDefined<TSchema["meta"], {
453
+ /**
454
+ * - An optional field you can fill with additional information,
455
+ * to associate with the request, typically used for logging or tracing.
456
+ *
457
+ * - A good use case for this, would be to use the info to handle specific cases in any of the shared interceptors.
458
+ *
459
+ * @example
460
+ * ```ts
461
+ * const callMainApi = callApi.create({
462
+ * baseURL: "https://main-api.com",
463
+ * onResponseError: ({ response, options }) => {
464
+ * if (options.meta?.userId) {
465
+ * console.error(`User ${options.meta.userId} made an error`);
466
+ * }
467
+ * },
468
+ * });
469
+ *
470
+ * const response = await callMainApi({
471
+ * url: "https://example.com/api/data",
472
+ * meta: { userId: "123" },
473
+ * });
474
+ * ```
475
+ */
476
+ meta?: InferSchemaOutput<TSchema["meta"], TCallApiContext["Meta"]>;
477
+ }>;
478
+ type InferQueryOption<TSchema extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema["query"], {
479
+ /**
480
+ * Parameters to be appended to the URL (i.e: /:id)
481
+ */
482
+ query?: InferSchemaOutput<TSchema["query"], Query>;
483
+ }>;
484
+ type EmptyString = "";
485
+ type EmptyTuple = readonly [];
486
+ type StringTuple = readonly string[];
487
+ type PossibleParamNamePatterns = `${string}:${string}` | `${string}{${string}}${"" | AnyString}`;
488
+ type ExtractRouteParamNames<TCurrentRoute, TParamNamesAccumulator extends StringTuple = EmptyTuple> = TCurrentRoute extends PossibleParamNamePatterns ? TCurrentRoute extends `${infer TRoutePrefix}:${infer TParamAndRemainingRoute}` ? TParamAndRemainingRoute extends `${infer TCurrentParam}/${infer TRemainingRoute}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<`${TRoutePrefix}/${TRemainingRoute}`, TParamNamesAccumulator> : ExtractRouteParamNames<`${TRoutePrefix}/${TRemainingRoute}`, [...TParamNamesAccumulator, TCurrentParam]> : TParamAndRemainingRoute extends `${infer TCurrentParam}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<TRoutePrefix, TParamNamesAccumulator> : ExtractRouteParamNames<TRoutePrefix, [...TParamNamesAccumulator, TCurrentParam]> : ExtractRouteParamNames<TRoutePrefix, TParamNamesAccumulator> : TCurrentRoute extends `${infer TRoutePrefix}{${infer TCurrentParam}}${infer TRemainingRoute}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<`${TRoutePrefix}${TRemainingRoute}`, TParamNamesAccumulator> : ExtractRouteParamNames<`${TRoutePrefix}${TRemainingRoute}`, [...TParamNamesAccumulator, TCurrentParam]> : TParamNamesAccumulator : TParamNamesAccumulator;
489
+ type ConvertParamNamesToRecord<TParamNames extends StringTuple> = Prettify<TParamNames extends (readonly [infer TFirstParamName extends string, ...infer TRemainingParamNames extends StringTuple]) ? Record<TFirstParamName, AllowedQueryParamValues> & ConvertParamNamesToRecord<TRemainingParamNames> : NonNullable<unknown>>;
490
+ type ConvertParamNamesToTuple<TParamNames extends StringTuple> = TParamNames extends readonly [string, ...infer TRemainingParamNames extends StringTuple] ? [AllowedQueryParamValues, ...ConvertParamNamesToTuple<TRemainingParamNames>] : [];
491
+ type InferParamsFromRoute<TCurrentRoute> = ExtractRouteParamNames<TCurrentRoute> extends StringTuple ? ExtractRouteParamNames<TCurrentRoute> extends EmptyTuple ? Params : ConvertParamNamesToRecord<ExtractRouteParamNames<TCurrentRoute>> | ConvertParamNamesToTuple<ExtractRouteParamNames<TCurrentRoute>> : Params;
492
+ type MakeParamsOptionRequired<TParamsSchemaOption extends CallApiSchema["params"], TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TObject> = MakeSchemaOptionRequiredIfDefined<TParamsSchemaOption, Params extends InferParamsFromRoute<TCurrentRouteSchemaKey> ? TObject : TCurrentRouteSchemaKey extends Extract<keyof TBaseSchemaRoutes, TCurrentRouteSchemaKey> ? undefined extends InferSchemaOutput<TParamsSchemaOption, null> ? TObject : Required<TObject> : TObject>;
493
+ type InferParamsOption<TSchema extends CallApiSchema, TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string> = MakeParamsOptionRequired<TSchema["params"], TBaseSchemaRoutes, TCurrentRouteSchemaKey, {
494
+ /**
495
+ * Parameters to be appended to the URL (i.e: /:id)
496
+ */
497
+ params?: InferSchemaOutput<TSchema["params"], InferParamsFromRoute<TCurrentRouteSchemaKey>>;
498
+ }>;
499
+ type InferExtraOptions<TSchema extends CallApiSchema, TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TCallApiContext extends CallApiContext> = InferMetaOption<TSchema, TCallApiContext> & InferParamsOption<TSchema, TBaseSchemaRoutes, TCurrentRouteSchemaKey> & InferQueryOption<TSchema>;
500
+ type InferPluginExtraOptions<TPluginArray extends CallApiPlugin[]> = UnionToIntersection<TPluginArray extends Array<infer TPlugin> ? TPlugin extends CallApiPlugin ? TPlugin["defineExtraOptions"] extends AnyFunction$1<infer TReturnedSchema> ? InferSchemaOutput<TReturnedSchema> : never : never : never>;
501
+ type ResultModeOption<TErrorData, TResultMode extends ResultModeType> = TErrorData extends false ? {
502
+ resultMode: "onlyData";
503
+ } : TErrorData extends false | undefined ? {
504
+ resultMode?: "onlyData";
505
+ } : {
506
+ resultMode?: TResultMode;
507
+ };
508
+ type ThrowOnErrorUnion = boolean;
509
+ type ThrowOnErrorType<TErrorData, TThrowOnError extends ThrowOnErrorUnion> = TThrowOnError | ((context: ErrorContext<{
510
+ ErrorData: TErrorData;
511
+ }>) => TThrowOnError);
512
+ type ThrowOnErrorOption<TErrorData, TThrowOnError extends ThrowOnErrorUnion> = TErrorData extends false ? {
513
+ throwOnError: true;
514
+ } : TErrorData extends false | undefined ? {
515
+ throwOnError?: true;
516
+ } : {
517
+ throwOnError?: ThrowOnErrorType<TErrorData, TThrowOnError>;
518
+ };
519
+ //#endregion
520
+ //#region src/middlewares.d.ts
521
+ type FetchImpl = UnmaskType<(input: string | Request | URL, init?: RequestInit) => Promise<Response>>;
522
+ interface Middlewares<TCallApiContext extends NoInfer<CallApiContext> = DefaultCallApiContext> {
523
+ /**
524
+ * Wraps the fetch implementation to intercept requests at the network layer.
525
+ *
526
+ * Takes a context object containing the current fetch function and returns a new fetch function.
527
+ * Use it to cache responses, add logging, handle offline mode, or short-circuit requests etc.
528
+ * Multiple middleware compose in order: plugins → base config → per-request.
529
+ *
530
+ * Unlike `customFetchImpl`, middleware can call through to the original fetch.
531
+ *
532
+ * @example
533
+ * ```ts
534
+ * // Cache responses
535
+ * const cache = new Map();
536
+ *
537
+ * fetchMiddleware: (ctx) => async (input, init) => {
538
+ * const key = input.toString();
539
+ * if (cache.has(key)) return cache.get(key).clone();
540
+ *
541
+ * const response = await ctx.fetchImpl(input, init);
542
+ * cache.set(key, response.clone());
543
+ * return response;
544
+ * }
545
+ *
546
+ * // Handle offline
547
+ * fetchMiddleware: (ctx) => async (input, init) => {
548
+ * if (!navigator.onLine) {
549
+ * return new Response('{"error": "offline"}', { status: 503 });
550
+ * }
551
+ * return ctx.fetchImpl(input, init);
552
+ * }
553
+ * ```
554
+ */
555
+ fetchMiddleware?: (context: RequestContext<TCallApiContext> & {
556
+ fetchImpl: FetchImpl;
557
+ }) => FetchImpl;
558
+ }
559
+ //#endregion
559
560
  //#region src/plugins.d.ts
560
561
  type PluginSetupContext<TCallApiContext extends CallApiContext = DefaultCallApiContext> = RequestContext<TCallApiContext> & {
561
562
  initURL: string;
@@ -1762,20 +1763,13 @@ type CallApiResultErrorVariant<TErrorData> = {
1762
1763
  error: PossibleJavaScriptOrValidationError;
1763
1764
  response: Response | null;
1764
1765
  };
1765
- type CallApiSuccessOrErrorVariant<TData, TError> = CallApiResultErrorVariant<TError> | CallApiResultSuccessVariant<TData>;
1766
- type ResultModeMapWithoutException<TData, TErrorData, TComputedResult extends CallApiSuccessOrErrorVariant<TData, TErrorData> = CallApiSuccessOrErrorVariant<TData, TErrorData>> = UnmaskType<{
1766
+ type CallApiResultSuccessOrErrorVariant<TData, TError> = CallApiResultErrorVariant<TError> | CallApiResultSuccessVariant<TData>;
1767
+ type ResultModeMap<TData = DefaultDataType, TErrorData = DefaultDataType, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TComputedResultWithoutException extends CallApiResultSuccessOrErrorVariant<TData, TErrorData> = CallApiResultSuccessOrErrorVariant<TData, TErrorData>, TComputedResultWithException extends CallApiResultSuccessVariant<TData> = CallApiResultSuccessVariant<TData>, TComputedResult extends (TThrowOnError extends true ? TComputedResultWithException : TComputedResultWithoutException) = (TThrowOnError extends true ? TComputedResultWithException : TComputedResultWithoutException)> = UnmaskType<{
1767
1768
  all: TComputedResult;
1768
1769
  onlyData: TComputedResult["data"];
1769
1770
  onlyResponse: TComputedResult["response"];
1770
- withoutResponse: DistributiveOmit<TComputedResult, "response">;
1771
+ withoutResponse: Prettify<DistributiveOmit<TComputedResult, "response">>;
1771
1772
  }>;
1772
- type ResultModeMapWithException<TData, TComputedResult extends CallApiResultSuccessVariant<TData> = CallApiResultSuccessVariant<TData>> = {
1773
- all: TComputedResult;
1774
- onlyData: TComputedResult["data"];
1775
- onlyResponse: TComputedResult["response"];
1776
- withoutResponse: DistributiveOmit<TComputedResult, "response">;
1777
- };
1778
- type ResultModeMap<TData = DefaultDataType, TErrorData = DefaultDataType, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError> = TThrowOnError extends true ? ResultModeMapWithException<TData> : ResultModeMapWithoutException<TData, TErrorData>;
1779
1773
  type ResultModePlaceholder = null;
1780
1774
  type ResultModeUnion = keyof ResultModeMap;
1781
1775
  type ResultModeType = ResultModePlaceholder | ResultModeUnion;
@@ -1854,4 +1848,4 @@ declare const loggerPlugin: (options?: LoggerOptions) => {
1854
1848
  };
1855
1849
  //#endregion
1856
1850
  export { defaultConsoleObject as n, loggerPlugin as r, LoggerOptions as t };
1857
- //# sourceMappingURL=index-4Ly8sBk-.d.ts.map
1851
+ //# sourceMappingURL=index-Do3FVEkv.d.ts.map
package/dist/index.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- import { n as defaultConsoleObject, r as loggerPlugin, t as LoggerOptions } from "./index-4Ly8sBk-.js";
1
+ import { n as defaultConsoleObject, r as loggerPlugin, t as LoggerOptions } from "./index-Do3FVEkv.js";
2
2
  export { LoggerOptions, defaultConsoleObject, loggerPlugin };
@@ -1,2 +1,2 @@
1
- import { n as defaultConsoleObject, r as loggerPlugin, t as LoggerOptions } from "../../index-4Ly8sBk-.js";
1
+ import { n as defaultConsoleObject, r as loggerPlugin, t as LoggerOptions } from "../../index-Do3FVEkv.js";
2
2
  export { LoggerOptions, defaultConsoleObject, loggerPlugin };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@zayne-labs/callapi-plugins",
3
3
  "type": "module",
4
- "version": "4.0.30",
4
+ "version": "4.0.32",
5
5
  "description": "A collection of plugins for callapi",
6
6
  "author": "Ryan Zayne",
7
7
  "license": "MIT",
@@ -24,7 +24,7 @@
24
24
  "peerDependencies": {
25
25
  "@zayne-labs/toolkit-type-helpers": ">=0.11.17",
26
26
  "consola": "3.x.x",
27
- "@zayne-labs/callapi": "1.11.30"
27
+ "@zayne-labs/callapi": "1.11.32"
28
28
  },
29
29
  "devDependencies": {
30
30
  "@arethetypeswrong/cli": "0.18.2",
@@ -38,10 +38,10 @@
38
38
  "cross-env": "^10.1.0",
39
39
  "publint": "^0.3.15",
40
40
  "size-limit": "12.0.0",
41
- "tsdown": "0.17.0-beta.4",
41
+ "tsdown": "0.17.0",
42
42
  "typescript": "5.9.3",
43
- "vitest": "^4.0.14",
44
- "@zayne-labs/callapi": "1.11.30"
43
+ "vitest": "^4.0.15",
44
+ "@zayne-labs/callapi": "1.11.32"
45
45
  },
46
46
  "publishConfig": {
47
47
  "access": "public",