@tanstack/ai-fal 0.9.12 → 0.9.14

package/dist/esm/image/image-provider-options.js

@@ -1,23 +1,18 @@
+//#region src/image/image-provider-options.ts
 function mapSizeToFalFormat(size) {
-  if (!size) return void 0;
-  if (typeof size === "string") {
-    if (size.includes("_")) {
-      const [first, second] = size.split("_");
-      if (first && first.includes(":")) {
-        return {
-          aspect_ratio: first,
-          resolution: second
-        };
-      }
-    } else if (size.includes(":")) {
-      return { aspect_ratio: size };
-    }
-  }
-  return {
-    image_size: size
-  };
+	if (!size) return void 0;
+	if (typeof size === "string") {
+		if (size.includes("_")) {
+			const [first, second] = size.split("_");
+			if (first && first.includes(":")) return {
+				aspect_ratio: first,
+				resolution: second
+			};
+		} else if (size.includes(":")) return { aspect_ratio: size };
+	}
+	return { image_size: size };
 }
-export {
-  mapSizeToFalFormat
-};
-//# sourceMappingURL=image-provider-options.js.map
+//#endregion
+export { mapSizeToFalFormat };
+
+//# sourceMappingURL=image-provider-options.js.map

package/dist/esm/image/image-provider-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-provider-options.js","sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["import type { FalModelImageSize, FalModelImageSizeInput } from '../model-meta'\n\nexport function mapSizeToFalFormat<TModel extends string>(\n  size: FalModelImageSize<TModel> | undefined,\n): FalModelImageSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_4K\"     → { aspect_ratio, resolution }\n  // \"16:9\"        → { aspect_ratio }\n  // \"4K\"          → { resolution }    (no colon, no underscore, model has `resolution`)\n  // \"square_hd\"   → { image_size }    (no colon, no resolution field on model)\n  if (typeof size === 'string') {\n    if (size.includes('_')) {\n      const [first, second] = size.split('_')\n      if (first && first.includes(':')) {\n        return {\n          aspect_ratio: first,\n          resolution: second,\n        } as FalModelImageSizeInput<TModel>\n      }\n    } else if (size.includes(':')) {\n      return { aspect_ratio: size } as FalModelImageSizeInput<TModel>\n    }\n  }\n\n  return {\n    image_size: size,\n  } as FalModelImageSizeInput<TModel>\n}\n"],"names":[],"mappings":"AAEO,SAAS,mBACd,MAC4C;AAC5C,MAAI,CAAC,KAAM,QAAO;AAMlB,MAAI,OAAO,SAAS,UAAU;AAC5B,QAAI,KAAK,SAAS,GAAG,GAAG;AACtB,YAAM,CAAC,OAAO,MAAM,IAAI,KAAK,MAAM,GAAG;AACtC,UAAI,SAAS,MAAM,SAAS,GAAG,GAAG;AAChC,eAAO;AAAA,UACL,cAAc;AAAA,UACd,YAAY;AAAA,QAAA;AAAA,MAEhB;AAAA,IACF,WAAW,KAAK,SAAS,GAAG,GAAG;AAC7B,aAAO,EAAE,cAAc,KAAA;AAAA,IACzB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,YAAY;AAAA,EAAA;AAEhB;"}
+{"version":3,"file":"image-provider-options.js","names":[],"sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["import type { FalModelImageSize, FalModelImageSizeInput } from '../model-meta'\n\nexport function mapSizeToFalFormat<TModel extends string>(\n  size: FalModelImageSize<TModel> | undefined,\n): FalModelImageSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_4K\"     → { aspect_ratio, resolution }\n  // \"16:9\"        → { aspect_ratio }\n  // \"4K\"          → { resolution }    (no colon, no underscore, model has `resolution`)\n  // \"square_hd\"   → { image_size }    (no colon, no resolution field on model)\n  if (typeof size === 'string') {\n    if (size.includes('_')) {\n      const [first, second] = size.split('_')\n      if (first && first.includes(':')) {\n        return {\n          aspect_ratio: first,\n          resolution: second,\n        } as FalModelImageSizeInput<TModel>\n      }\n    } else if (size.includes(':')) {\n      return { aspect_ratio: size } as FalModelImageSizeInput<TModel>\n    }\n  }\n\n  return {\n    image_size: size,\n  } as FalModelImageSizeInput<TModel>\n}\n"],"mappings":";AAEA,SAAgB,mBACd,MAC4C;CAC5C,IAAI,CAAC,MAAM,OAAO,KAAA;CAMlB,IAAI,OAAO,SAAS;MACd,KAAK,SAAS,GAAG,GAAG;GACtB,MAAM,CAAC,OAAO,UAAU,KAAK,MAAM,GAAG;GACtC,IAAI,SAAS,MAAM,SAAS,GAAG,GAC7B,OAAO;IACL,cAAc;IACd,YAAY;GACd;EAEJ,OAAO,IAAI,KAAK,SAAS,GAAG,GAC1B,OAAO,EAAE,cAAc,KAAK;CAAA;CAIhC,OAAO,EACL,YAAY,KACd;AACF"}

package/dist/esm/index.js

@@ -1,22 +1,7 @@
+import { configureFalClient, generateId, getFalApiKeyFromEnv } from "./utils/client.js";
 import { FalImageAdapter, falImage } from "./adapters/image.js";
 import { FalVideoAdapter, falVideo } from "./adapters/video.js";
 import { FalSpeechAdapter, falSpeech } from "./adapters/speech.js";
 import { FalTranscriptionAdapter, falTranscription } from "./adapters/transcription.js";
 import { FalAudioAdapter, falAudio } from "./adapters/audio.js";
-import { configureFalClient, generateId, getFalApiKeyFromEnv } from "./utils/client.js";
-export {
-  FalAudioAdapter,
-  FalImageAdapter,
-  FalSpeechAdapter,
-  FalTranscriptionAdapter,
-  FalVideoAdapter,
-  configureFalClient,
-  falAudio,
-  falImage,
-  falSpeech,
-  falTranscription,
-  falVideo,
-  generateId,
-  getFalApiKeyFromEnv
-};
-//# sourceMappingURL=index.js.map
+export { FalAudioAdapter, FalImageAdapter, FalSpeechAdapter, FalTranscriptionAdapter, FalVideoAdapter, configureFalClient, falAudio, falImage, falSpeech, falTranscription, falVideo, generateId, getFalApiKeyFromEnv };

package/dist/esm/utils/billing.js

@@ -1,55 +1,99 @@
-const FAL_BILLABLE_UNITS_HEADER = "x-fal-billable-units";
-const FAL_REQUEST_ID_HEADER = "x-fal-request-id";
-const MAX_PENDING_ENTRIES = 256;
-const billableUnitsByRequestId = /* @__PURE__ */ new Map();
+//#region src/utils/billing.ts
+/**
+* Response header fal sets on a queue *result* fetch carrying the real billed
+* quantity for the generation, denominated in the endpoint's priced unit.
+*/
+var FAL_BILLABLE_UNITS_HEADER = "x-fal-billable-units";
+/**
+* Response header fal sets carrying the request id. The fal client surfaces this
+* same value as `Result.requestId`, so keying captured billable units by it
+* guarantees the adapter's lookup matches the fetch the units came from — no URL
+* parsing or global correlation registry of our own design needed.
+*/
+var FAL_REQUEST_ID_HEADER = "x-fal-request-id";
+/**
+* Upper bound on retained, not-yet-consumed billable-unit entries. Each
+* successful generation reads-and-deletes its entry (see {@link takeBillableUnits}),
+* so this only guards against an unbounded leak when a result fetch records units
+* but the adapter never resolves (e.g. it throws before reading). When the cap is
+* exceeded the oldest entry is evicted (Map preserves insertion order).
+*/
+var MAX_PENDING_ENTRIES = 256;
+var billableUnitsByRequestId = /* @__PURE__ */ new Map();
+/**
+* Parse the `x-fal-billable-units` header value into a finite number. Returns
+* `undefined` for a missing or non-numeric value so callers can skip attaching
+* usage rather than surfacing `NaN`.
+*/
 function parseBillableUnits(value) {
-  if (value == null || value === "") return void 0;
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : void 0;
+	if (value == null || value === "") return void 0;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
 }
+/**
+* Record the billable units carried by a fal result response, keyed by the
+* request id from the same response. Reading headers does not consume the body,
+* so the response can be returned to the fal client untouched.
+*/
 function recordBillableUnitsFromResponse(response) {
-  const units = parseBillableUnits(
-    response.headers.get(FAL_BILLABLE_UNITS_HEADER)
-  );
-  if (units == null) return;
-  const requestId = response.headers.get(FAL_REQUEST_ID_HEADER);
-  if (!requestId) return;
-  if (billableUnitsByRequestId.size >= MAX_PENDING_ENTRIES && !billableUnitsByRequestId.has(requestId)) {
-    const oldest = billableUnitsByRequestId.keys().next().value;
-    if (oldest !== void 0) billableUnitsByRequestId.delete(oldest);
-  }
-  billableUnitsByRequestId.set(requestId, units);
+	const units = parseBillableUnits(response.headers.get(FAL_BILLABLE_UNITS_HEADER));
+	if (units == null) return;
+	const requestId = response.headers.get(FAL_REQUEST_ID_HEADER);
+	if (!requestId) return;
+	if (billableUnitsByRequestId.size >= MAX_PENDING_ENTRIES && !billableUnitsByRequestId.has(requestId)) {
+		const oldest = billableUnitsByRequestId.keys().next().value;
+		if (oldest !== void 0) billableUnitsByRequestId.delete(oldest);
+	}
+	billableUnitsByRequestId.set(requestId, units);
 }
+/**
+* Read and remove the billable units recorded for a request id. Removing on read
+* keeps the registry from growing across the lifetime of the process.
+*/
 function takeBillableUnits(requestId) {
-  if (!requestId) return void 0;
-  const units = billableUnitsByRequestId.get(requestId);
-  if (units !== void 0) billableUnitsByRequestId.delete(requestId);
-  return units;
+	if (!requestId) return void 0;
+	const units = billableUnitsByRequestId.get(requestId);
+	if (units !== void 0) billableUnitsByRequestId.delete(requestId);
+	return units;
 }
+/**
+* Build a {@link TokenUsage} carrying fal's billed quantity. Media generation has
+* no tokens, so the token fields are zero and the real billing signal rides on
+* `unitsBilled` — mirroring how the duration-billed transcription adapters
+* surface `durationSeconds`. Returns `undefined` when no units were captured so
+* callers can omit `usage` entirely.
+*/
 function buildFalUsage(unitsBilled) {
-  if (unitsBilled == null) return void 0;
-  return {
-    promptTokens: 0,
-    completionTokens: 0,
-    totalTokens: 0,
-    unitsBilled
-  };
+	if (unitsBilled == null) return void 0;
+	return {
+		promptTokens: 0,
+		completionTokens: 0,
+		totalTokens: 0,
+		unitsBilled
+	};
 }
+/**
+* Wrap a fetch so every fal request's response is inspected for the
+* `x-fal-billable-units` header before being returned untouched. Installed as
+* fal's `config.fetch`, which (unlike a global `responseHandler`) is honoured for
+* every request — the fal client forces `resultResponseHandler` per queue
+* operation, clobbering any configured response handler.
+*
+* `baseFetch` is the underlying implementation to delegate to (defaults to the
+* global `fetch`). Injecting it keeps usage capture working when a caller
+* supplies a custom fetch — a proxy, instrumentation, or a test mock — without
+* mutating any global.
+*/
 function createBillingFetch(baseFetch = globalThis.fetch) {
-  return async (input, init) => {
-    const response = await baseFetch(input, init);
-    try {
-      recordBillableUnitsFromResponse(response);
-    } catch {
-    }
-    return response;
-  };
+	return async (input, init) => {
+		const response = await baseFetch(input, init);
+		try {
+			recordBillableUnitsFromResponse(response);
+		} catch {}
+		return response;
+	};
 }
-export {
-  buildFalUsage,
-  createBillingFetch,
-  parseBillableUnits,
-  recordBillableUnitsFromResponse,
-  takeBillableUnits
-};
-//# sourceMappingURL=billing.js.map
+//#endregion
+export { buildFalUsage, createBillingFetch, parseBillableUnits, recordBillableUnitsFromResponse, takeBillableUnits };
+
+//# sourceMappingURL=billing.js.map

package/dist/esm/utils/billing.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing.js","sources":["../../../src/utils/billing.ts"],"sourcesContent":["import type { TokenUsage } from '@tanstack/ai'\n\n/**\n * Response header fal sets on a queue *result* fetch carrying the real billed\n * quantity for the generation, denominated in the endpoint's priced unit.\n */\nconst FAL_BILLABLE_UNITS_HEADER = 'x-fal-billable-units'\n\n/**\n * Response header fal sets carrying the request id. The fal client surfaces this\n * same value as `Result.requestId`, so keying captured billable units by it\n * guarantees the adapter's lookup matches the fetch the units came from — no URL\n * parsing or global correlation registry of our own design needed.\n */\nconst FAL_REQUEST_ID_HEADER = 'x-fal-request-id'\n\n/**\n * Upper bound on retained, not-yet-consumed billable-unit entries. Each\n * successful generation reads-and-deletes its entry (see {@link takeBillableUnits}),\n * so this only guards against an unbounded leak when a result fetch records units\n * but the adapter never resolves (e.g. it throws before reading). When the cap is\n * exceeded the oldest entry is evicted (Map preserves insertion order).\n */\nconst MAX_PENDING_ENTRIES = 256\n\nconst billableUnitsByRequestId = new Map<string, number>()\n\n/**\n * Parse the `x-fal-billable-units` header value into a finite number. Returns\n * `undefined` for a missing or non-numeric value so callers can skip attaching\n * usage rather than surfacing `NaN`.\n */\nexport function parseBillableUnits(value: string | null): number | undefined {\n  if (value == null || value === '') return undefined\n  const parsed = Number(value)\n  return Number.isFinite(parsed) ? parsed : undefined\n}\n\n/**\n * Record the billable units carried by a fal result response, keyed by the\n * request id from the same response. Reading headers does not consume the body,\n * so the response can be returned to the fal client untouched.\n */\nexport function recordBillableUnitsFromResponse(response: Response): void {\n  const units = parseBillableUnits(\n    response.headers.get(FAL_BILLABLE_UNITS_HEADER),\n  )\n  if (units == null) return\n  const requestId = response.headers.get(FAL_REQUEST_ID_HEADER)\n  if (!requestId) return\n  if (\n    billableUnitsByRequestId.size >= MAX_PENDING_ENTRIES &&\n    !billableUnitsByRequestId.has(requestId)\n  ) {\n    const oldest = billableUnitsByRequestId.keys().next().value\n    if (oldest !== undefined) billableUnitsByRequestId.delete(oldest)\n  }\n  billableUnitsByRequestId.set(requestId, units)\n}\n\n/**\n * Read and remove the billable units recorded for a request id. Removing on read\n * keeps the registry from growing across the lifetime of the process.\n */\nexport function takeBillableUnits(\n  requestId: string | undefined,\n): number | undefined {\n  if (!requestId) return undefined\n  const units = billableUnitsByRequestId.get(requestId)\n  if (units !== undefined) billableUnitsByRequestId.delete(requestId)\n  return units\n}\n\n/**\n * Build a {@link TokenUsage} carrying fal's billed quantity. Media generation has\n * no tokens, so the token fields are zero and the real billing signal rides on\n * `unitsBilled` — mirroring how the duration-billed transcription adapters\n * surface `durationSeconds`. Returns `undefined` when no units were captured so\n * callers can omit `usage` entirely.\n */\nexport function buildFalUsage(\n  unitsBilled: number | undefined,\n): TokenUsage | undefined {\n  if (unitsBilled == null) return undefined\n  return {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    unitsBilled,\n  }\n}\n\n/**\n * Wrap a fetch so every fal request's response is inspected for the\n * `x-fal-billable-units` header before being returned untouched. Installed as\n * fal's `config.fetch`, which (unlike a global `responseHandler`) is honoured for\n * every request — the fal client forces `resultResponseHandler` per queue\n * operation, clobbering any configured response handler.\n *\n * `baseFetch` is the underlying implementation to delegate to (defaults to the\n * global `fetch`). Injecting it keeps usage capture working when a caller\n * supplies a custom fetch — a proxy, instrumentation, or a test mock — without\n * mutating any global.\n */\nexport function createBillingFetch(\n  baseFetch: typeof fetch = globalThis.fetch,\n): typeof fetch {\n  return async (input, init) => {\n    const response = await baseFetch(input, init)\n    try {\n      recordBillableUnitsFromResponse(response)\n    } catch {\n      // Capturing usage must never break the underlying request.\n    }\n    return response\n  }\n}\n"],"names":[],"mappings":"AAMA,MAAM,4BAA4B;AAQlC,MAAM,wBAAwB;AAS9B,MAAM,sBAAsB;AAE5B,MAAM,+CAA+B,IAAA;AAO9B,SAAS,mBAAmB,OAA0C;AAC3E,MAAI,SAAS,QAAQ,UAAU,GAAI,QAAO;AAC1C,QAAM,SAAS,OAAO,KAAK;AAC3B,SAAO,OAAO,SAAS,MAAM,IAAI,SAAS;AAC5C;AAOO,SAAS,gCAAgC,UAA0B;AACxE,QAAM,QAAQ;AAAA,IACZ,SAAS,QAAQ,IAAI,yBAAyB;AAAA,EAAA;AAEhD,MAAI,SAAS,KAAM;AACnB,QAAM,YAAY,SAAS,QAAQ,IAAI,qBAAqB;AAC5D,MAAI,CAAC,UAAW;AAChB,MACE,yBAAyB,QAAQ,uBACjC,CAAC,yBAAyB,IAAI,SAAS,GACvC;AACA,UAAM,SAAS,yBAAyB,KAAA,EAAO,OAAO;AACtD,QAAI,WAAW,OAAW,0BAAyB,OAAO,MAAM;AAAA,EAClE;AACA,2BAAyB,IAAI,WAAW,KAAK;AAC/C;AAMO,SAAS,kBACd,WACoB;AACpB,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,QAAQ,yBAAyB,IAAI,SAAS;AACpD,MAAI,UAAU,OAAW,0BAAyB,OAAO,SAAS;AAClE,SAAO;AACT;AASO,SAAS,cACd,aACwB;AACxB,MAAI,eAAe,KAAM,QAAO;AAChC,SAAO;AAAA,IACL,cAAc;AAAA,IACd,kBAAkB;AAAA,IAClB,aAAa;AAAA,IACb;AAAA,EAAA;AAEJ;AAcO,SAAS,mBACd,YAA0B,WAAW,OACvB;AACd,SAAO,OAAO,OAAO,SAAS;AAC5B,UAAM,WAAW,MAAM,UAAU,OAAO,IAAI;AAC5C,QAAI;AACF,sCAAgC,QAAQ;AAAA,IAC1C,QAAQ;AAAA,IAER;AACA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"billing.js","names":[],"sources":["../../../src/utils/billing.ts"],"sourcesContent":["import type { TokenUsage } from '@tanstack/ai'\n\n/**\n * Response header fal sets on a queue *result* fetch carrying the real billed\n * quantity for the generation, denominated in the endpoint's priced unit.\n */\nconst FAL_BILLABLE_UNITS_HEADER = 'x-fal-billable-units'\n\n/**\n * Response header fal sets carrying the request id. The fal client surfaces this\n * same value as `Result.requestId`, so keying captured billable units by it\n * guarantees the adapter's lookup matches the fetch the units came from — no URL\n * parsing or global correlation registry of our own design needed.\n */\nconst FAL_REQUEST_ID_HEADER = 'x-fal-request-id'\n\n/**\n * Upper bound on retained, not-yet-consumed billable-unit entries. Each\n * successful generation reads-and-deletes its entry (see {@link takeBillableUnits}),\n * so this only guards against an unbounded leak when a result fetch records units\n * but the adapter never resolves (e.g. it throws before reading). When the cap is\n * exceeded the oldest entry is evicted (Map preserves insertion order).\n */\nconst MAX_PENDING_ENTRIES = 256\n\nconst billableUnitsByRequestId = new Map<string, number>()\n\n/**\n * Parse the `x-fal-billable-units` header value into a finite number. Returns\n * `undefined` for a missing or non-numeric value so callers can skip attaching\n * usage rather than surfacing `NaN`.\n */\nexport function parseBillableUnits(value: string | null): number | undefined {\n  if (value == null || value === '') return undefined\n  const parsed = Number(value)\n  return Number.isFinite(parsed) ? parsed : undefined\n}\n\n/**\n * Record the billable units carried by a fal result response, keyed by the\n * request id from the same response. Reading headers does not consume the body,\n * so the response can be returned to the fal client untouched.\n */\nexport function recordBillableUnitsFromResponse(response: Response): void {\n  const units = parseBillableUnits(\n    response.headers.get(FAL_BILLABLE_UNITS_HEADER),\n  )\n  if (units == null) return\n  const requestId = response.headers.get(FAL_REQUEST_ID_HEADER)\n  if (!requestId) return\n  if (\n    billableUnitsByRequestId.size >= MAX_PENDING_ENTRIES &&\n    !billableUnitsByRequestId.has(requestId)\n  ) {\n    const oldest = billableUnitsByRequestId.keys().next().value\n    if (oldest !== undefined) billableUnitsByRequestId.delete(oldest)\n  }\n  billableUnitsByRequestId.set(requestId, units)\n}\n\n/**\n * Read and remove the billable units recorded for a request id. Removing on read\n * keeps the registry from growing across the lifetime of the process.\n */\nexport function takeBillableUnits(\n  requestId: string | undefined,\n): number | undefined {\n  if (!requestId) return undefined\n  const units = billableUnitsByRequestId.get(requestId)\n  if (units !== undefined) billableUnitsByRequestId.delete(requestId)\n  return units\n}\n\n/**\n * Build a {@link TokenUsage} carrying fal's billed quantity. Media generation has\n * no tokens, so the token fields are zero and the real billing signal rides on\n * `unitsBilled` — mirroring how the duration-billed transcription adapters\n * surface `durationSeconds`. Returns `undefined` when no units were captured so\n * callers can omit `usage` entirely.\n */\nexport function buildFalUsage(\n  unitsBilled: number | undefined,\n): TokenUsage | undefined {\n  if (unitsBilled == null) return undefined\n  return {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    unitsBilled,\n  }\n}\n\n/**\n * Wrap a fetch so every fal request's response is inspected for the\n * `x-fal-billable-units` header before being returned untouched. Installed as\n * fal's `config.fetch`, which (unlike a global `responseHandler`) is honoured for\n * every request — the fal client forces `resultResponseHandler` per queue\n * operation, clobbering any configured response handler.\n *\n * `baseFetch` is the underlying implementation to delegate to (defaults to the\n * global `fetch`). Injecting it keeps usage capture working when a caller\n * supplies a custom fetch — a proxy, instrumentation, or a test mock — without\n * mutating any global.\n */\nexport function createBillingFetch(\n  baseFetch: typeof fetch = globalThis.fetch,\n): typeof fetch {\n  return async (input, init) => {\n    const response = await baseFetch(input, init)\n    try {\n      recordBillableUnitsFromResponse(response)\n    } catch {\n      // Capturing usage must never break the underlying request.\n    }\n    return response\n  }\n}\n"],"mappings":";;;;;AAMA,IAAM,4BAA4B;;;;;;;AAQlC,IAAM,wBAAwB;;;;;;;;AAS9B,IAAM,sBAAsB;AAE5B,IAAM,2CAA2B,IAAI,IAAoB;;;;;;AAOzD,SAAgB,mBAAmB,OAA0C;CAC3E,IAAI,SAAS,QAAQ,UAAU,IAAI,OAAO,KAAA;CAC1C,MAAM,SAAS,OAAO,KAAK;CAC3B,OAAO,OAAO,SAAS,MAAM,IAAI,SAAS,KAAA;AAC5C;;;;;;AAOA,SAAgB,gCAAgC,UAA0B;CACxE,MAAM,QAAQ,mBACZ,SAAS,QAAQ,IAAI,yBAAyB,CAChD;CACA,IAAI,SAAS,MAAM;CACnB,MAAM,YAAY,SAAS,QAAQ,IAAI,qBAAqB;CAC5D,IAAI,CAAC,WAAW;CAChB,IACE,yBAAyB,QAAQ,uBACjC,CAAC,yBAAyB,IAAI,SAAS,GACvC;EACA,MAAM,SAAS,yBAAyB,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;EACtD,IAAI,WAAW,KAAA,GAAW,yBAAyB,OAAO,MAAM;CAClE;CACA,yBAAyB,IAAI,WAAW,KAAK;AAC/C;;;;;AAMA,SAAgB,kBACd,WACoB;CACpB,IAAI,CAAC,WAAW,OAAO,KAAA;CACvB,MAAM,QAAQ,yBAAyB,IAAI,SAAS;CACpD,IAAI,UAAU,KAAA,GAAW,yBAAyB,OAAO,SAAS;CAClE,OAAO;AACT;;;;;;;;AASA,SAAgB,cACd,aACwB;CACxB,IAAI,eAAe,MAAM,OAAO,KAAA;CAChC,OAAO;EACL,cAAc;EACd,kBAAkB;EAClB,aAAa;EACb;CACF;AACF;;;;;;;;;;;;;AAcA,SAAgB,mBACd,YAA0B,WAAW,OACvB;CACd,OAAO,OAAO,OAAO,SAAS;EAC5B,MAAM,WAAW,MAAM,UAAU,OAAO,IAAI;EAC5C,IAAI;GACF,gCAAgC,QAAQ;EAC1C,QAAQ,CAER;EACA,OAAO;CACT;AACF"}

package/dist/esm/utils/client.js

@@ -1,101 +1,104 @@
-import { fal } from "@fal-ai/client";
-import { generateId as generateId$1, getApiKeyFromEnv } from "@tanstack/ai-utils";
 import { createBillingFetch } from "./billing.js";
+import { fal } from "@fal-ai/client";
+import { generateId, getApiKeyFromEnv } from "@tanstack/ai-utils";
+//#region src/utils/client.ts
 function getFalApiKeyFromEnv() {
-  return getApiKeyFromEnv("FAL_KEY");
+	return getApiKeyFromEnv("FAL_KEY");
 }
 function configureFalClient(config) {
-  const apiKey = config?.apiKey ?? getFalApiKeyFromEnv();
-  fal.config({
-    credentials: apiKey,
-    // Wrap the (optionally overridden) fetch to read fal's
-    // `x-fal-billable-units` header off every response so adapters can surface
-    // the billed quantity as `result.usage`. See ./billing.ts.
-    fetch: createBillingFetch(config?.fetch),
-    ...config?.proxyUrl ? { proxyUrl: config.proxyUrl } : {}
-  });
+	const apiKey = config?.apiKey ?? getFalApiKeyFromEnv();
+	fal.config({
+		credentials: apiKey,
+		fetch: createBillingFetch(config?.fetch),
+		...config?.proxyUrl ? { proxyUrl: config.proxyUrl } : {}
+	});
 }
-function generateId(prefix) {
-  return generateId$1(prefix);
+function generateId$1(prefix) {
+	return generateId(prefix);
 }
+/**
+* Extract a safe file extension from a URL. Strips query strings, URL
+* fragments, and any trailing slashes, and only returns the extension when
+* it looks like a real one (2-5 alphanumeric chars). Returns undefined
+* otherwise so callers can fall back to a default.
+*/
 function extractUrlExtension(url) {
-  let pathname;
-  try {
-    const parsed = new URL(url);
-    pathname = parsed.pathname;
-  } catch {
-    pathname = url.split("?")[0]?.split("#")[0] ?? url;
-  }
-  const normalized = pathname.replace(/\/+$/, "");
-  if (!normalized.includes("/")) return void 0;
-  const lastSegment = normalized.split("/").pop();
-  if (!lastSegment) return void 0;
-  const extension = lastSegment.split(".").pop();
-  if (!extension || extension === lastSegment) return void 0;
-  return /^[a-z0-9]{2,5}$/i.test(extension) ? extension : void 0;
+	let pathname;
+	try {
+		pathname = new URL(url).pathname;
+	} catch {
+		pathname = url.split("?")[0]?.split("#")[0] ?? url;
+	}
+	const normalized = pathname.replace(/\/+$/, "");
+	if (!normalized.includes("/")) return void 0;
+	const lastSegment = normalized.split("/").pop();
+	if (!lastSegment) return void 0;
+	const extension = lastSegment.split(".").pop();
+	if (!extension || extension === lastSegment) return void 0;
+	return /^[a-z0-9]{2,5}$/i.test(extension) ? extension : void 0;
 }
+/**
+* Derive a reasonable audio content-type. Prefers the explicit MIME (stripped
+* of parameters), then an extension-based lookup for common audio formats,
+* otherwise falls back to audio/mpeg — fal URLs virtually always serve mp3.
+*/
 function deriveAudioContentType(explicitContentType, url) {
-  const stripped = explicitContentType?.split(";")[0]?.trim();
-  if (stripped) return stripped;
-  const ext = extractUrlExtension(url)?.toLowerCase();
-  switch (ext) {
-    case "mp3":
-      return "audio/mpeg";
-    case "wav":
-      return "audio/wav";
-    case "ogg":
-    case "oga":
-      return "audio/ogg";
-    case "flac":
-      return "audio/flac";
-    case "aac":
-      return "audio/aac";
-    case "m4a":
-    case "mp4":
-      return "audio/mp4";
-    case "webm":
-      return "audio/webm";
-    case void 0:
-    default:
-      return "audio/mpeg";
-  }
+	const stripped = explicitContentType?.split(";")[0]?.trim();
+	if (stripped) return stripped;
+	switch (extractUrlExtension(url)?.toLowerCase()) {
+		case "mp3": return "audio/mpeg";
+		case "wav": return "audio/wav";
+		case "ogg":
+		case "oga": return "audio/ogg";
+		case "flac": return "audio/flac";
+		case "aac": return "audio/aac";
+		case "m4a":
+		case "mp4": return "audio/mp4";
+		case "webm": return "audio/webm";
+		case void 0:
+		default: return "audio/mpeg";
+	}
 }
+/**
+* Decode a `data:` URL into a Blob so fal-client can auto-upload it via
+* `fal.storage.upload`. fal's inference API rejects data URLs with a 422
+* "Unsupported data URL", so we convert them before handing them off.
+*
+* Supports both base64 and URL-encoded data URLs. Returns `undefined` for
+* anything that isn't a data URL, so callers can fall through to other
+* handling (http URLs are passed to fal as-is).
+*/
 function dataUrlToBlob(value) {
-  if (!value.startsWith("data:")) return void 0;
-  const commaIndex = value.indexOf(",");
-  if (commaIndex === -1) return void 0;
-  const header = value.slice(5, commaIndex);
-  const payload = value.slice(commaIndex + 1);
-  const isBase64 = /;base64$/i.test(header);
-  const mimeType = header.split(";")[0] || "application/octet-stream";
-  if (isBase64) {
-    const binary = atob(payload);
-    const bytes = new Uint8Array(binary.length);
-    for (let i = 0; i < binary.length; i += 1) {
-      bytes[i] = binary.charCodeAt(i);
-    }
-    return new Blob([bytes], { type: mimeType });
-  }
-  return new Blob([decodeURIComponent(payload)], { type: mimeType });
+	if (!value.startsWith("data:")) return void 0;
+	const commaIndex = value.indexOf(",");
+	if (commaIndex === -1) return void 0;
+	const header = value.slice(5, commaIndex);
+	const payload = value.slice(commaIndex + 1);
+	const isBase64 = /;base64$/i.test(header);
+	const mimeType = header.split(";")[0] || "application/octet-stream";
+	if (isBase64) {
+		const binary = atob(payload);
+		const bytes = new Uint8Array(binary.length);
+		for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
+		return new Blob([bytes], { type: mimeType });
+	}
+	return new Blob([decodeURIComponent(payload)], { type: mimeType });
 }
+/**
+* Convert an ArrayBuffer to base64 in a cross-runtime way.
+*
+* The naive `btoa(String.fromCharCode(...bytes))` form blows up V8's argument
+* limit (~65k) on realistic audio payloads, so we either use `Buffer` (Node /
+* Bun) or walk the byte array in a single loop (browser).
+*/
 function arrayBufferToBase64(bytes) {
-  if (typeof Buffer !== "undefined" && typeof Buffer.from === "function") {
-    return Buffer.from(bytes).toString("base64");
-  }
-  const view = new Uint8Array(bytes);
-  let binary = "";
-  for (const byte of view) {
-    binary += String.fromCharCode(byte);
-  }
-  return btoa(binary);
+	if (typeof Buffer !== "undefined" && typeof Buffer.from === "function") return Buffer.from(bytes).toString("base64");
+	const view = new Uint8Array(bytes);
+	let binary = "";
+	for (const byte of view) binary += String.fromCharCode(byte);
+	return btoa(binary);
 }
-export {
-  arrayBufferToBase64,
-  configureFalClient,
-  dataUrlToBlob,
-  deriveAudioContentType,
-  extractUrlExtension,
-  generateId,
-  getFalApiKeyFromEnv
-};
-//# sourceMappingURL=client.js.map
+//#endregion
+export { arrayBufferToBase64, configureFalClient, dataUrlToBlob, deriveAudioContentType, extractUrlExtension, generateId$1 as generateId, getFalApiKeyFromEnv };
+
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport { createBillingFetch } from './billing'\n\nexport interface FalClientConfig {\n  apiKey: string\n  proxyUrl?: string\n  /**\n   * Override the underlying fetch used for fal requests. The adapter wraps it to\n   * read the `x-fal-billable-units` header (see ./billing.ts), so usage capture\n   * still works. Defaults to the global `fetch`. Useful for proxying,\n   * instrumentation, or pointing requests at a mock in tests.\n   */\n  fetch?: typeof fetch\n}\n\nexport function getFalApiKeyFromEnv(): string {\n  return getApiKeyFromEnv('FAL_KEY')\n}\n\nexport function configureFalClient(config?: FalClientConfig): void {\n  const apiKey = config?.apiKey ?? getFalApiKeyFromEnv()\n  fal.config({\n    credentials: apiKey,\n    // Wrap the (optionally overridden) fetch to read fal's\n    // `x-fal-billable-units` header off every response so adapters can surface\n    // the billed quantity as `result.usage`. See ./billing.ts.\n    fetch: createBillingFetch(config?.fetch),\n    ...(config?.proxyUrl ? { proxyUrl: config.proxyUrl } : {}),\n  })\n}\n\nexport function generateId(prefix: string): string {\n  return _generateId(prefix)\n}\n\n/**\n * Extract a safe file extension from a URL. Strips query strings, URL\n * fragments, and any trailing slashes, and only returns the extension when\n * it looks like a real one (2-5 alphanumeric chars). Returns undefined\n * otherwise so callers can fall back to a default.\n */\nexport function extractUrlExtension(url: string): string | undefined {\n  // Parse via URL when possible so we only look at the pathname and never\n  // mistake a TLD (e.g. the `.com` in `https://x.com/`) for a file extension.\n  let pathname: string\n  try {\n    const parsed = new URL(url)\n    pathname = parsed.pathname\n  } catch {\n    // Fall back to treating the input as a raw path when URL parsing fails\n    // (e.g. the caller passed a bare path). Still strip ?query and #fragment.\n    pathname = url.split('?')[0]?.split('#')[0] ?? url\n  }\n  // Drop trailing slashes so `/path/audio.mp3/` still yields `mp3`.\n  const normalized = pathname.replace(/\\/+$/, '')\n  // Require at least one `/` — otherwise we're looking at an empty pathname\n  // (bare-host URLs like `https://x.com/` land here after stripping the\n  // trailing slash).\n  if (!normalized.includes('/')) return undefined\n  const lastSegment = normalized.split('/').pop()\n  if (!lastSegment) return undefined\n  const extension = lastSegment.split('.').pop()\n  if (!extension || extension === lastSegment) return undefined\n  return /^[a-z0-9]{2,5}$/i.test(extension) ? extension : undefined\n}\n\n/**\n * Derive a reasonable audio content-type. Prefers the explicit MIME (stripped\n * of parameters), then an extension-based lookup for common audio formats,\n * otherwise falls back to audio/mpeg — fal URLs virtually always serve mp3.\n */\nexport function deriveAudioContentType(\n  explicitContentType: string | undefined,\n  url: string,\n): string {\n  const stripped = explicitContentType?.split(';')[0]?.trim()\n  if (stripped) return stripped\n\n  const ext = extractUrlExtension(url)?.toLowerCase()\n  switch (ext) {\n    case 'mp3':\n      return 'audio/mpeg'\n    case 'wav':\n      return 'audio/wav'\n    case 'ogg':\n    case 'oga':\n      return 'audio/ogg'\n    case 'flac':\n      return 'audio/flac'\n    case 'aac':\n      return 'audio/aac'\n    case 'm4a':\n    case 'mp4':\n      return 'audio/mp4'\n    case 'webm':\n      return 'audio/webm'\n    case undefined:\n    default:\n      return 'audio/mpeg'\n  }\n}\n\n/**\n * Decode a `data:` URL into a Blob so fal-client can auto-upload it via\n * `fal.storage.upload`. fal's inference API rejects data URLs with a 422\n * \"Unsupported data URL\", so we convert them before handing them off.\n *\n * Supports both base64 and URL-encoded data URLs. Returns `undefined` for\n * anything that isn't a data URL, so callers can fall through to other\n * handling (http URLs are passed to fal as-is).\n */\nexport function dataUrlToBlob(value: string): Blob | undefined {\n  if (!value.startsWith('data:')) return undefined\n  const commaIndex = value.indexOf(',')\n  if (commaIndex === -1) return undefined\n\n  const header = value.slice(5, commaIndex)\n  const payload = value.slice(commaIndex + 1)\n  const isBase64 = /;base64$/i.test(header)\n  const mimeType = header.split(';')[0] || 'application/octet-stream'\n\n  if (isBase64) {\n    const binary = atob(payload)\n    const bytes = new Uint8Array(binary.length)\n    for (let i = 0; i < binary.length; i += 1) {\n      bytes[i] = binary.charCodeAt(i)\n    }\n    return new Blob([bytes], { type: mimeType })\n  }\n\n  return new Blob([decodeURIComponent(payload)], { type: mimeType })\n}\n\n/**\n * Convert an ArrayBuffer to base64 in a cross-runtime way.\n *\n * The naive `btoa(String.fromCharCode(...bytes))` form blows up V8's argument\n * limit (~65k) on realistic audio payloads, so we either use `Buffer` (Node /\n * Bun) or walk the byte array in a single loop (browser).\n */\nexport function arrayBufferToBase64(bytes: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {\n    return Buffer.from(bytes).toString('base64')\n  }\n  const view = new Uint8Array(bytes)\n  let binary = ''\n  for (const byte of view) {\n    binary += String.fromCharCode(byte)\n  }\n  return btoa(binary)\n}\n"],"names":["_generateId"],"mappings":";;;AAgBO,SAAS,sBAA8B;AAC5C,SAAO,iBAAiB,SAAS;AACnC;AAEO,SAAS,mBAAmB,QAAgC;AACjE,QAAM,SAAS,QAAQ,UAAU,oBAAA;AACjC,MAAI,OAAO;AAAA,IACT,aAAa;AAAA;AAAA;AAAA;AAAA,IAIb,OAAO,mBAAmB,QAAQ,KAAK;AAAA,IACvC,GAAI,QAAQ,WAAW,EAAE,UAAU,OAAO,SAAA,IAAa,CAAA;AAAA,EAAC,CACzD;AACH;AAEO,SAAS,WAAW,QAAwB;AACjD,SAAOA,aAAY,MAAM;AAC3B;AAQO,SAAS,oBAAoB,KAAiC;AAGnE,MAAI;AACJ,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,eAAW,OAAO;AAAA,EACpB,QAAQ;AAGN,eAAW,IAAI,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC,KAAK;AAAA,EACjD;AAEA,QAAM,aAAa,SAAS,QAAQ,QAAQ,EAAE;AAI9C,MAAI,CAAC,WAAW,SAAS,GAAG,EAAG,QAAO;AACtC,QAAM,cAAc,WAAW,MAAM,GAAG,EAAE,IAAA;AAC1C,MAAI,CAAC,YAAa,QAAO;AACzB,QAAM,YAAY,YAAY,MAAM,GAAG,EAAE,IAAA;AACzC,MAAI,CAAC,aAAa,cAAc,YAAa,QAAO;AACpD,SAAO,mBAAmB,KAAK,SAAS,IAAI,YAAY;AAC1D;AAOO,SAAS,uBACd,qBACA,KACQ;AACR,QAAM,WAAW,qBAAqB,MAAM,GAAG,EAAE,CAAC,GAAG,KAAA;AACrD,MAAI,SAAU,QAAO;AAErB,QAAM,MAAM,oBAAoB,GAAG,GAAG,YAAA;AACtC,UAAQ,KAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL;AACE,aAAO;AAAA,EAAA;AAEb;AAWO,SAAS,cAAc,OAAiC;AAC7D,MAAI,CAAC,MAAM,WAAW,OAAO,EAAG,QAAO;AACvC,QAAM,aAAa,MAAM,QAAQ,GAAG;AACpC,MAAI,eAAe,GAAI,QAAO;AAE9B,QAAM,SAAS,MAAM,MAAM,GAAG,UAAU;AACxC,QAAM,UAAU,MAAM,MAAM,aAAa,CAAC;AAC1C,QAAM,WAAW,YAAY,KAAK,MAAM;AACxC,QAAM,WAAW,OAAO,MAAM,GAAG,EAAE,CAAC,KAAK;AAEzC,MAAI,UAAU;AACZ,UAAM,SAAS,KAAK,OAAO;AAC3B,UAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;AAC1C,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACzC,YAAM,CAAC,IAAI,OAAO,WAAW,CAAC;AAAA,IAChC;AACA,WAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,MAAM,UAAU;AAAA,EAC7C;AAEA,SAAO,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,GAAG,EAAE,MAAM,UAAU;AACnE;AASO,SAAS,oBAAoB,OAA4B;AAC9D,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,SAAS,YAAY;AACtE,WAAO,OAAO,KAAK,KAAK,EAAE,SAAS,QAAQ;AAAA,EAC7C;AACA,QAAM,OAAO,IAAI,WAAW,KAAK;AACjC,MAAI,SAAS;AACb,aAAW,QAAQ,MAAM;AACvB,cAAU,OAAO,aAAa,IAAI;AAAA,EACpC;AACA,SAAO,KAAK,MAAM;AACpB;"}
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { generateId as _generateId, getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport { createBillingFetch } from './billing'\n\nexport interface FalClientConfig {\n  apiKey: string\n  proxyUrl?: string\n  /**\n   * Override the underlying fetch used for fal requests. The adapter wraps it to\n   * read the `x-fal-billable-units` header (see ./billing.ts), so usage capture\n   * still works. Defaults to the global `fetch`. Useful for proxying,\n   * instrumentation, or pointing requests at a mock in tests.\n   */\n  fetch?: typeof fetch\n}\n\nexport function getFalApiKeyFromEnv(): string {\n  return getApiKeyFromEnv('FAL_KEY')\n}\n\nexport function configureFalClient(config?: FalClientConfig): void {\n  const apiKey = config?.apiKey ?? getFalApiKeyFromEnv()\n  fal.config({\n    credentials: apiKey,\n    // Wrap the (optionally overridden) fetch to read fal's\n    // `x-fal-billable-units` header off every response so adapters can surface\n    // the billed quantity as `result.usage`. See ./billing.ts.\n    fetch: createBillingFetch(config?.fetch),\n    ...(config?.proxyUrl ? { proxyUrl: config.proxyUrl } : {}),\n  })\n}\n\nexport function generateId(prefix: string): string {\n  return _generateId(prefix)\n}\n\n/**\n * Extract a safe file extension from a URL. Strips query strings, URL\n * fragments, and any trailing slashes, and only returns the extension when\n * it looks like a real one (2-5 alphanumeric chars). Returns undefined\n * otherwise so callers can fall back to a default.\n */\nexport function extractUrlExtension(url: string): string | undefined {\n  // Parse via URL when possible so we only look at the pathname and never\n  // mistake a TLD (e.g. the `.com` in `https://x.com/`) for a file extension.\n  let pathname: string\n  try {\n    const parsed = new URL(url)\n    pathname = parsed.pathname\n  } catch {\n    // Fall back to treating the input as a raw path when URL parsing fails\n    // (e.g. the caller passed a bare path). Still strip ?query and #fragment.\n    pathname = url.split('?')[0]?.split('#')[0] ?? url\n  }\n  // Drop trailing slashes so `/path/audio.mp3/` still yields `mp3`.\n  const normalized = pathname.replace(/\\/+$/, '')\n  // Require at least one `/` — otherwise we're looking at an empty pathname\n  // (bare-host URLs like `https://x.com/` land here after stripping the\n  // trailing slash).\n  if (!normalized.includes('/')) return undefined\n  const lastSegment = normalized.split('/').pop()\n  if (!lastSegment) return undefined\n  const extension = lastSegment.split('.').pop()\n  if (!extension || extension === lastSegment) return undefined\n  return /^[a-z0-9]{2,5}$/i.test(extension) ? extension : undefined\n}\n\n/**\n * Derive a reasonable audio content-type. Prefers the explicit MIME (stripped\n * of parameters), then an extension-based lookup for common audio formats,\n * otherwise falls back to audio/mpeg — fal URLs virtually always serve mp3.\n */\nexport function deriveAudioContentType(\n  explicitContentType: string | undefined,\n  url: string,\n): string {\n  const stripped = explicitContentType?.split(';')[0]?.trim()\n  if (stripped) return stripped\n\n  const ext = extractUrlExtension(url)?.toLowerCase()\n  switch (ext) {\n    case 'mp3':\n      return 'audio/mpeg'\n    case 'wav':\n      return 'audio/wav'\n    case 'ogg':\n    case 'oga':\n      return 'audio/ogg'\n    case 'flac':\n      return 'audio/flac'\n    case 'aac':\n      return 'audio/aac'\n    case 'm4a':\n    case 'mp4':\n      return 'audio/mp4'\n    case 'webm':\n      return 'audio/webm'\n    case undefined:\n    default:\n      return 'audio/mpeg'\n  }\n}\n\n/**\n * Decode a `data:` URL into a Blob so fal-client can auto-upload it via\n * `fal.storage.upload`. fal's inference API rejects data URLs with a 422\n * \"Unsupported data URL\", so we convert them before handing them off.\n *\n * Supports both base64 and URL-encoded data URLs. Returns `undefined` for\n * anything that isn't a data URL, so callers can fall through to other\n * handling (http URLs are passed to fal as-is).\n */\nexport function dataUrlToBlob(value: string): Blob | undefined {\n  if (!value.startsWith('data:')) return undefined\n  const commaIndex = value.indexOf(',')\n  if (commaIndex === -1) return undefined\n\n  const header = value.slice(5, commaIndex)\n  const payload = value.slice(commaIndex + 1)\n  const isBase64 = /;base64$/i.test(header)\n  const mimeType = header.split(';')[0] || 'application/octet-stream'\n\n  if (isBase64) {\n    const binary = atob(payload)\n    const bytes = new Uint8Array(binary.length)\n    for (let i = 0; i < binary.length; i += 1) {\n      bytes[i] = binary.charCodeAt(i)\n    }\n    return new Blob([bytes], { type: mimeType })\n  }\n\n  return new Blob([decodeURIComponent(payload)], { type: mimeType })\n}\n\n/**\n * Convert an ArrayBuffer to base64 in a cross-runtime way.\n *\n * The naive `btoa(String.fromCharCode(...bytes))` form blows up V8's argument\n * limit (~65k) on realistic audio payloads, so we either use `Buffer` (Node /\n * Bun) or walk the byte array in a single loop (browser).\n */\nexport function arrayBufferToBase64(bytes: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {\n    return Buffer.from(bytes).toString('base64')\n  }\n  const view = new Uint8Array(bytes)\n  let binary = ''\n  for (const byte of view) {\n    binary += String.fromCharCode(byte)\n  }\n  return btoa(binary)\n}\n"],"mappings":";;;;AAgBA,SAAgB,sBAA8B;CAC5C,OAAO,iBAAiB,SAAS;AACnC;AAEA,SAAgB,mBAAmB,QAAgC;CACjE,MAAM,SAAS,QAAQ,UAAU,oBAAoB;CACrD,IAAI,OAAO;EACT,aAAa;EAIb,OAAO,mBAAmB,QAAQ,KAAK;EACvC,GAAI,QAAQ,WAAW,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;CAC1D,CAAC;AACH;AAEA,SAAgB,aAAW,QAAwB;CACjD,OAAO,WAAY,MAAM;AAC3B;;;;;;;AAQA,SAAgB,oBAAoB,KAAiC;CAGnE,IAAI;CACJ,IAAI;EAEF,WAAW,IADQ,IAAI,GACZ,CAAA,CAAO;CACpB,QAAQ;EAGN,WAAW,IAAI,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM;CACjD;CAEA,MAAM,aAAa,SAAS,QAAQ,QAAQ,EAAE;CAI9C,IAAI,CAAC,WAAW,SAAS,GAAG,GAAG,OAAO,KAAA;CACtC,MAAM,cAAc,WAAW,MAAM,GAAG,CAAC,CAAC,IAAI;CAC9C,IAAI,CAAC,aAAa,OAAO,KAAA;CACzB,MAAM,YAAY,YAAY,MAAM,GAAG,CAAC,CAAC,IAAI;CAC7C,IAAI,CAAC,aAAa,cAAc,aAAa,OAAO,KAAA;CACpD,OAAO,mBAAmB,KAAK,SAAS,IAAI,YAAY,KAAA;AAC1D;;;;;;AAOA,SAAgB,uBACd,qBACA,KACQ;CACR,MAAM,WAAW,qBAAqB,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK;CAC1D,IAAI,UAAU,OAAO;CAGrB,QADY,oBAAoB,GAAG,CAAC,EAAE,YAAY,GAClD;EACE,KAAK,OACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK;EACL,KAAK,OACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK;EACL,KAAK,OACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,KAAA;EACL,SACE,OAAO;CACX;AACF;;;;;;;;;;AAWA,SAAgB,cAAc,OAAiC;CAC7D,IAAI,CAAC,MAAM,WAAW,OAAO,GAAG,OAAO,KAAA;CACvC,MAAM,aAAa,MAAM,QAAQ,GAAG;CACpC,IAAI,eAAe,IAAI,OAAO,KAAA;CAE9B,MAAM,SAAS,MAAM,MAAM,GAAG,UAAU;CACxC,MAAM,UAAU,MAAM,MAAM,aAAa,CAAC;CAC1C,MAAM,WAAW,YAAY,KAAK,MAAM;CACxC,MAAM,WAAW,OAAO,MAAM,GAAG,CAAC,CAAC,MAAM;CAEzC,IAAI,UAAU;EACZ,MAAM,SAAS,KAAK,OAAO;EAC3B,MAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;EAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GACtC,MAAM,KAAK,OAAO,WAAW,CAAC;EAEhC,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,MAAM,SAAS,CAAC;CAC7C;CAEA,OAAO,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,GAAG,EAAE,MAAM,SAAS,CAAC;AACnE;;;;;;;;AASA,SAAgB,oBAAoB,OAA4B;CAC9D,IAAI,OAAO,WAAW,eAAe,OAAO,OAAO,SAAS,YAC1D,OAAO,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,QAAQ;CAE7C,MAAM,OAAO,IAAI,WAAW,KAAK;CACjC,IAAI,SAAS;CACb,KAAK,MAAM,QAAQ,MACjB,UAAU,OAAO,aAAa,IAAI;CAEpC,OAAO,KAAK,MAAM;AACpB"}

package/dist/esm/video/video-provider-options.js

@@ -1,18 +1,17 @@
+//#region src/video/video-provider-options.ts
 function mapVideoSizeToFalFormat(size) {
-  if (!size) return void 0;
-  if (size.includes("_")) {
-    const [aspect_ratio, resolution] = size.split("_");
-    return {
-      aspect_ratio,
-      resolution
-    };
-  }
-  if (size.includes(":")) {
-    return { aspect_ratio: size };
-  }
-  return { resolution: size };
+	if (!size) return void 0;
+	if (size.includes("_")) {
+		const [aspect_ratio, resolution] = size.split("_");
+		return {
+			aspect_ratio,
+			resolution
+		};
+	}
+	if (size.includes(":")) return { aspect_ratio: size };
+	return { resolution: size };
 }
-export {
-  mapVideoSizeToFalFormat
-};
-//# sourceMappingURL=video-provider-options.js.map
+//#endregion
+export { mapVideoSizeToFalFormat };
+
+//# sourceMappingURL=video-provider-options.js.map

package/dist/esm/video/video-provider-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"video-provider-options.js","sources":["../../../src/video/video-provider-options.ts"],"sourcesContent":["import type { FalModelVideoSize, FalModelVideoSizeInput } from '../model-meta'\n\nexport function mapVideoSizeToFalFormat<TModel extends string>(\n  size: FalModelVideoSize<TModel> | undefined,\n): FalModelVideoSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_720p\" → { aspect_ratio, resolution }\n  // \"16:9\"      → { aspect_ratio }\n  // \"720p\"      → { resolution }\n  if (size.includes('_')) {\n    const [aspect_ratio, resolution] = size.split('_')\n    return {\n      aspect_ratio,\n      resolution,\n    } as FalModelVideoSizeInput<TModel>\n  }\n\n  if (size.includes(':')) {\n    return { aspect_ratio: size } as FalModelVideoSizeInput<TModel>\n  }\n\n  return { resolution: size } as FalModelVideoSizeInput<TModel>\n}\n"],"names":[],"mappings":"AAEO,SAAS,wBACd,MAC4C;AAC5C,MAAI,CAAC,KAAM,QAAO;AAKlB,MAAI,KAAK,SAAS,GAAG,GAAG;AACtB,UAAM,CAAC,cAAc,UAAU,IAAI,KAAK,MAAM,GAAG;AACjD,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAEA,MAAI,KAAK,SAAS,GAAG,GAAG;AACtB,WAAO,EAAE,cAAc,KAAA;AAAA,EACzB;AAEA,SAAO,EAAE,YAAY,KAAA;AACvB;"}
+{"version":3,"file":"video-provider-options.js","names":[],"sources":["../../../src/video/video-provider-options.ts"],"sourcesContent":["import type { FalModelVideoSize, FalModelVideoSizeInput } from '../model-meta'\n\nexport function mapVideoSizeToFalFormat<TModel extends string>(\n  size: FalModelVideoSize<TModel> | undefined,\n): FalModelVideoSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_720p\" → { aspect_ratio, resolution }\n  // \"16:9\"      → { aspect_ratio }\n  // \"720p\"      → { resolution }\n  if (size.includes('_')) {\n    const [aspect_ratio, resolution] = size.split('_')\n    return {\n      aspect_ratio,\n      resolution,\n    } as FalModelVideoSizeInput<TModel>\n  }\n\n  if (size.includes(':')) {\n    return { aspect_ratio: size } as FalModelVideoSizeInput<TModel>\n  }\n\n  return { resolution: size } as FalModelVideoSizeInput<TModel>\n}\n"],"mappings":";AAEA,SAAgB,wBACd,MAC4C;CAC5C,IAAI,CAAC,MAAM,OAAO,KAAA;CAKlB,IAAI,KAAK,SAAS,GAAG,GAAG;EACtB,MAAM,CAAC,cAAc,cAAc,KAAK,MAAM,GAAG;EACjD,OAAO;GACL;GACA;EACF;CACF;CAEA,IAAI,KAAK,SAAS,GAAG,GACnB,OAAO,EAAE,cAAc,KAAK;CAG9B,OAAO,EAAE,YAAY,KAAK;AAC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-fal",
-  "version": "0.9.12",
+  "version": "0.9.14",
   "description": "fal.ai adapter for TanStack AI image, video, audio, speech, and transcription generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -49,22 +49,22 @@
   ],
   "dependencies": {
     "@fal-ai/client": "^1.10.1",
-    "@tanstack/ai-utils": "0.3.1"
+    "@tanstack/ai-utils": "0.4.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
-    "vite": "^7.3.3",
-    "@tanstack/ai": "0.42.0"
+    "vite": "^8.1.4",
+    "@tanstack/ai": "0.43.1"
   },
   "peerDependencies": {
-    "@tanstack/ai": "0.42.0"
+    "@tanstack/ai": "0.43.1"
   },
   "scripts": {
     "build": "vite build",
     "clean": "premove ./build ./dist",
-    "lint:fix": "eslint ./src --fix",
+    "lint:fix": "oxlint src --type-aware --fix",
     "test:build": "publint --strict",
-    "test:eslint": "eslint ./src",
+    "test:oxlint": "oxlint src --type-aware",
     "test:lib": "vitest run",
     "test:lib:dev": "pnpm test:lib --watch",
     "test:types": "tsc"

package/dist/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}