@brotu/ai 0.1.0

package/dist/providers/qwen.models.d.ts

@@ -0,0 +1,88 @@
+import type { AIModelConfig } from "../constants/model.types";
+/**
+ * Qwen Cloud, which is Alibaba's DashScope International underneath — the docs
+ * brand it Qwen Cloud but the host, key format and task envelope are DashScope.
+ * Confirmed live: the same key authenticates chat there and queues video, and a
+ * submitted task returned a playable file.
+ *
+ * These are the native home of the Wan and HappyHorse families, which this SDK
+ * previously reached only through an aggregator.
+ *
+ * Nearly every field below exists because the same endpoint accepts four
+ * incompatible request shapes, discriminated only by the model string.
+ */
+/** How a model wants its reference media passed. */
+export type QwenInputShape = 
+/** `input.media[]` of `{type,url}` — wan2.7, happyhorse, wan3.0. */
+"media"
+/** `input.img_url`, a single string — wan2.6 and earlier. */
+ | "img_url"
+/** `input.first_frame_url` + `last_frame_url`, on a different path. */
+ | "kf2v"
+/** `input.reference_urls[]` of plain strings — wan2.6-r2v. */
+ | "reference_urls";
+/** How a model wants its output size expressed. */
+export type QwenSizing = 
+/** `parameters.resolution` + `parameters.ratio`. */
+"resolution"
+/** `parameters.size`, as "1280*720" with a literal asterisk. */
+ | "size";
+export type QwenMode = "t2v" | "i2v" | "r2v" | "video-edit" | "kf2v";
+export interface QwenVideoBinding {
+    mode: QwenMode;
+    shape: QwenInputShape;
+    sizing: QwenSizing;
+    /** Only kf2v leaves the shared video path. */
+    path?: string;
+    durations?: {
+        min: number;
+        max: number;
+    } | number[];
+    resolutions?: string[];
+    /** True where DashScope stamps a visible mark unless told not to. */
+    watermarkOnByDefault?: boolean;
+}
+export declare const QWEN_VIDEO_MODELS: Record<string, QwenVideoBinding>;
+export declare function videoPathFor(binding: QwenVideoBinding): string;
+/** Which of the three image endpoints a model answers on. */
+export type QwenImagePath = "multimodal" | "image-generation" | "text2image";
+export declare const QWEN_IMAGE_PATHS: Record<QwenImagePath, string>;
+export interface QwenImageBinding {
+    /**
+     * Whether the model answers inline. This is not a preference: sending
+     * `X-DashScope-Async: enable` to a sync-only model returns 429, which reads
+     * as rate limiting and never resolves on retry.
+     */
+    sync: boolean;
+    path: QwenImagePath;
+    /** `messages` is the chat-style body; `prompt` is the legacy flat one. */
+    body: "messages" | "prompt";
+    maxN: number;
+    resolutions?: string[];
+}
+export declare const QWEN_IMAGE_MODELS: Record<string, QwenImageBinding>;
+/**
+ * Speech. Verified live: these answer inline on the multimodal endpoint and hand
+ * back an audio URL with a real `expires_at`, so nothing here is inferred.
+ *
+ * Billing is per character of input text, which the caller knows before asking —
+ * unlike text models, an audio estimate can be exact.
+ */
+export interface QwenVoiceBinding {
+    voices: string[];
+    /** USD per character. Published as $0.15 per 10K characters. */
+    usdPerCharacter: number;
+}
+export declare const QWEN_AUDIO_MODELS: Record<string, QwenVoiceBinding>;
+/**
+ * Text, through the OpenAI-compatible surface rather than the native one.
+ *
+ * Priced per million tokens, and the total depends on how much the model writes
+ * back — so an estimate can report the rate but never the bill. The catalog
+ * carries the rate; `estimateCost` says so rather than guessing a token count.
+ */
+export declare const QWEN_TEXT_MODELS: Record<string, {
+    usdPerMillionOutput: number;
+}>;
+export declare const QWEN_CATALOG: AIModelConfig[];
+//# sourceMappingURL=qwen.models.d.ts.map

package/dist/providers/qwen.models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen.models.d.ts","sourceRoot":"","sources":["../../src/providers/qwen.models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;;;;;GAWG;AAEH,oDAAoD;AACpD,MAAM,MAAM,cAAc;AACzB,oEAAoE;AAClE,OAAO;AACT,6DAA6D;GAC3D,SAAS;AACX,uEAAuE;GACrE,MAAM;AACR,8DAA8D;GAC5D,gBAAgB,CAAC;AAEpB,mDAAmD;AACnD,MAAM,MAAM,UAAU;AACrB,oDAAoD;AAClD,YAAY;AACd,gEAAgE;GAC9D,MAAM,CAAC;AAEV,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAQD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAgH9D,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAE9D;AAID,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAE7E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI1D,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAChC;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,0EAA0E;IAC1E,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA8D9D,CAAC;AA0BF;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;CACxB;AAYD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAY9D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAQ3E,CAAC;AAuBH,eAAO,MAAM,YAAY,EAAE,aAAa,EA2EvC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+import type { AIModelConfig } from "./constants/model.types";
+import type { S3StorageConfig } from "./lib/storage";
+export interface ProviderConfig {
+    apiKey: string;
+    /** Defaults to the known base URL for the provider, when there is one. */
+    baseUrl?: string;
+}
+export interface ReferenceVideoInfo {
+    durationSeconds?: number;
+    width?: number;
+    height?: number;
+}
+export interface BrotuAIOptions {
+    /** Provider keys the caller owns. Keys are provider ids used by the catalog. */
+    providers: Record<string, ProviderConfig>;
+    /** Provider used by catalog entries that do not declare one. Defaults to "kie". */
+    defaultProvider?: string;
+    /**
+     * Turn a private reference URL into one the provider can fetch.
+     * ponytail: identity by default — the SDK has no storage of its own.
+     */
+    resolveUrl?: (url: string) => Promise<string>;
+    /**
+     * Read duration/dimensions off a reference video. Only reference-video billing
+     * needs it; without it those models bill at their declared default.
+     * ponytail: undefined by default, wire ffmpeg here if you need exact billing.
+     */
+    probeVideo?: (url: string) => Promise<ReferenceVideoInfo>;
+    /**
+     * An S3-compatible bucket of your own. Configure it and the SDK uploads
+     * references for you and copies finished outputs off the providers' expiring
+     * URLs. `uploadImage` below is derived from it unless you pass your own.
+     */
+    storage?: S3StorageConfig;
+    /**
+     * Store a buffer and return a URL the provider can fetch. Overrides `storage`.
+     * Only reference-image cropping needs it; without either, cropping is skipped.
+     */
+    uploadImage?: (buffer: Buffer, filename: string, mimeType: string) => Promise<string>;
+    /**
+     * Voice used when an ElevenLabs request names none. Their API has no default
+     * voice, and ids are account-specific — `listVoices()` on the adapter finds
+     * yours.
+     */
+    elevenLabsVoiceId?: string;
+    /** Extra models, or overrides of built-in ones, merged by id. */
+    models?: AIModelConfig[];
+}
+/** Resolved per-request routing: which host and key serve this model. */
+export interface ResolvedProvider {
+    id: string;
+    apiKey: string;
+    baseUrl: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1D;;;;OAIG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB"}

package/package.json

@@ -0,0 +1,72 @@
+{
+	"name": "@brotu/ai",
+	"version": "0.1.0",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
+		"./catalog": {
+			"types": "./dist/catalog.d.ts",
+			"import": "./dist/catalog.js",
+			"require": "./dist/catalog.cjs"
+		}
+	},
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"lint": "bunx --bun biome lint src",
+		"format": "bunx --bun biome format --write src",
+		"docs:catalog": "bun run scripts/generate-catalog-doc.ts",
+		"build": "tsup && tsc -p tsconfig.build.json",
+		"typecheck": "tsc --noEmit",
+		"test": "bun test",
+		"gate": "bun run scripts/gate.ts",
+		"prepublishOnly": "bun run gate && bun run build",
+		"docs:json": "bun run scripts/generate-catalog-json.ts",
+		"docs": "bun run docs:catalog && bun run docs:json"
+	},
+	"peerDependencies": {
+		"@aws-sdk/client-s3": "^3",
+		"@aws-sdk/s3-request-presigner": "^3"
+	},
+	"peerDependenciesMeta": {
+		"@aws-sdk/client-s3": {
+			"optional": true
+		},
+		"@aws-sdk/s3-request-presigner": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@aws-sdk/client-s3": "^3.1111.0",
+		"@aws-sdk/s3-request-presigner": "^3.1111.0",
+		"@biomejs/biome": "2.3.11",
+		"@types/bun": "^1.3.9",
+		"@types/node": "^26.2.0",
+		"tsup": "^8.5.1",
+		"typescript": "^7.0.2"
+	},
+	"description": "One TypeScript client for generative video, image, speech and text across native provider APIs.",
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"files": [
+		"dist",
+		"CATALOG.md",
+		"README.md",
+		"LICENSE"
+	],
+	"module": "./dist/index.js",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/brotu/brotu-sdk.git",
+		"directory": "sdks/node"
+	}
+}