@apicity/fireworks 0.1.0-alpha.0

package/dist/src/example.d.ts

@@ -0,0 +1,8 @@
+export interface EndpointExample {
+    source: string;
+    payload: unknown;
+}
+declare const EXAMPLES: Record<string, EndpointExample>;
+export default EXAMPLES;
+export declare function attachExamples<T>(provider: T): T;
+//# sourceMappingURL=example.d.ts.map

package/dist/src/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA0D7C,CAAC;AAEF,eAAe,QAAQ,CAAC;AAOxB,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA6ChD"}

package/dist/src/example.js

@@ -0,0 +1,143 @@
+// Auto-generated by `pnpm run gen:examples` — do not edit by hand.
+// Source: tests/recordings/<provider>_*/<test>_*/recording.har
+//
+// Each entry is the green-path payload for one endpoint, mined from a real
+// integration-test recording. `attachExamples` walks the provider tree and
+// hangs the matching entry off each endpoint function as `.example`.
+const EXAMPLES = {
+    "POST inference.v1.chat.completions": {
+        "source": "fireworks/chat-hello",
+        "payload": {
+            "model": "accounts/fireworks/models/llama-v3p3-70b-instruct",
+            "messages": [
+                {
+                    "role": "user",
+                    "content": "Say hello in one sentence."
+                }
+            ],
+            "temperature": 0,
+            "max_tokens": 64
+        }
+    },
+    "POST inference.v1.completions": {
+        "source": "fireworks/completions-hello",
+        "payload": {
+            "model": "accounts/fireworks/models/llama-v3p3-70b-instruct",
+            "prompt": "The capital of France is",
+            "max_tokens": 32,
+            "temperature": 0
+        }
+    },
+    "POST inference.v1.embeddings": {
+        "source": "fireworks/embeddings-hello",
+        "payload": {
+            "model": "nomic-ai/nomic-embed-text-v1.5",
+            "input": "Hello world"
+        }
+    },
+    "POST inference.v1.messages": {
+        "source": "fireworks/messages-hello",
+        "payload": {
+            "model": "accounts/fireworks/models/llama-v3p3-70b-instruct",
+            "messages": [
+                {
+                    "role": "user",
+                    "content": "Say hello in one sentence."
+                }
+            ],
+            "max_tokens": 64
+        }
+    },
+    "POST inference.v1.rerank": {
+        "source": "fireworks/rerank-basic",
+        "payload": {
+            "model": "fireworks/qwen3-reranker-8b",
+            "query": "What is the capital of France?",
+            "documents": [
+                "Berlin is the capital of Germany.",
+                "Paris is the capital and largest city of France.",
+                "Madrid is the capital of Spain."
+            ],
+            "top_n": 2,
+            "return_documents": true
+        }
+    }
+};
+export default EXAMPLES;
+// Walks each "<METHOD> <dotPath>" key onto the provider's tree. Tries the
+// standard `provider.<method>.<dotPath>` shape first, then a few fallbacks
+// to cover providers with non-standard layouts (fal's `.run.` namespace,
+// kie's sub-providers, `free`'s flat root). Returns the same provider for
+// drop-in use as `return attachExamples({ ... });`.
+export function attachExamples(provider) {
+    const root = provider;
+    const HTTP_KEYS = new Set(["post", "get", "put", "delete", "patch", "head"]);
+    for (const [key, example] of Object.entries(EXAMPLES)) {
+        const sp = key.indexOf(" ");
+        if (sp < 0)
+            continue;
+        const method = key.slice(0, sp).toLowerCase();
+        const segs = key.slice(sp + 1).split(".");
+        const candidates = [
+            root[method],
+            root[method]?.run,
+            root,
+        ];
+        if (segs.length > 1) {
+            const sub = root[segs[0]];
+            if (sub && typeof sub === "object") {
+                const subMethod = sub[method];
+                if (subMethod)
+                    candidates.push({ __nested: subMethod, __segs: segs.slice(1) });
+            }
+        }
+        let attached = false;
+        for (const c of candidates) {
+            const fn = walkToFn(c, segs);
+            if (fn) {
+                Object.assign(fn, { example });
+                attached = true;
+                break;
+            }
+        }
+        if (attached)
+            continue;
+        for (const k of Object.keys(root)) {
+            if (HTTP_KEYS.has(k))
+                continue;
+            if (!segs.includes(k))
+                continue;
+            const sub = root[k];
+            if (!sub || typeof sub !== "object")
+                continue;
+            const subMethod = sub[method];
+            if (!subMethod)
+                continue;
+            const fn = walkToFn(subMethod, segs);
+            if (fn) {
+                Object.assign(fn, { example });
+                break;
+            }
+        }
+    }
+    return provider;
+}
+function walkToFn(start, segs) {
+    if (start && typeof start === "object" && "__nested" in start) {
+        const wrapper = start;
+        return walkToFn(wrapper.__nested, wrapper.__segs);
+    }
+    let cur = start;
+    for (const seg of segs) {
+        if (cur === null || cur === undefined)
+            return null;
+        const t = typeof cur;
+        if (t !== "object" && t !== "function")
+            return null;
+        cur = cur[seg];
+    }
+    return typeof cur === "function"
+        ? cur
+        : null;
+}
+//# sourceMappingURL=example.js.map

package/dist/src/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"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"}

package/dist/src/fireworks.d.ts

@@ -0,0 +1,3 @@
+import { FireworksOptions, FireworksProvider } from "./types";
+export declare function fireworks(opts: FireworksOptions): FireworksProvider;
+//# sourceMappingURL=fireworks.d.ts.map

package/dist/src/fireworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fireworks.d.ts","sourceRoot":"","sources":["../../src/fireworks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAgJhB,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAkEjB,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CA0/FnE"}