@apicity/x 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justin Tanner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,327 @@
+# @apicity/x
+
+[![npm](https://img.shields.io/npm/v/@apicity/x?color=cb0000)](https://www.npmjs.com/package/@apicity/x)
+[![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript&logoColor=white)](tsconfig.json)
+
+X (formerly Twitter) social API provider for posting content (api.x.com).
+
+## Installation
+
+```bash
+npm install @apicity/x
+# or
+pnpm add @apicity/x
+```
+
+## Quick Start
+
+```typescript
+import { x as createX } from "@apicity/x";
+
+const x = createX({ accessToken: process.env.X_ACCESS_TOKEN! });
+```
+
+## Setup
+
+X requires an **OAuth 2.0 user-context access token** to post or upload
+media. App-only Bearer tokens are read-only and rejected by the upload
+and tweets endpoints.
+
+### 1. Configure your X app
+
+Open [console.x.com](https://console.x.com) and make sure your app lives
+in a **Pay Per Use** project — the legacy *Free* project is deprecated
+and v2 endpoints reject its tokens with `client-not-enrolled`. Move the
+app from the Apps list if needed.
+
+Then open the app and click **User authentication settings → Set up**:
+
+- Type of App: **Web App, Automated App or Bot** (this yields a Client Secret)
+- App permissions: **Read and write**
+- Callback URI: `http://127.0.0.1:8765/callback`
+- Website URL: any valid URL
+
+Save and copy the **OAuth 2.0 Client ID** and **Client Secret**.
+
+### 2. Load credits
+
+Pay-per-use bills per write (~$0.015 / post). Open **Billing → Credits**
+and load the minimum (typically $5). Without credits, write endpoints
+return `402 Your enrolled account does not have any credits to fulfill
+this request` — even though authentication itself succeeds.
+
+### 3. Mint an access token
+
+Save the script below as `mint-x-token.mjs` and run it:
+
+```bash
+X_CLIENT_ID=<your-client-id> \
+X_CLIENT_SECRET=<your-client-secret> \
+  node mint-x-token.mjs
+```
+
+It prints an authorize URL — open it, click **Authorize app**, and the
+helper captures the redirect on `127.0.0.1:8765` and prints the access
+token + refresh token. Access tokens last 2 hours; the refresh token
+(via `offline.access` scope) lets you mint a new one without
+re-authorizing.
+
+<details>
+<summary><code>mint-x-token.mjs</code> — zero-dep OAuth 2.0 PKCE helper</summary>
+
+```javascript
+import http from "node:http";
+import crypto from "node:crypto";
+
+const CLIENT_ID = process.env.X_CLIENT_ID;
+const CLIENT_SECRET = process.env.X_CLIENT_SECRET;
+const REDIRECT = "http://127.0.0.1:8765/callback";
+const SCOPES = [
+  "tweet.read",
+  "tweet.write",
+  "media.write",
+  "users.read",
+  "offline.access",
+].join(" ");
+
+if (!CLIENT_ID || !CLIENT_SECRET) {
+  console.error("Set X_CLIENT_ID and X_CLIENT_SECRET");
+  process.exit(1);
+}
+
+const verifier = crypto.randomBytes(32).toString("base64url");
+const challenge = crypto
+  .createHash("sha256")
+  .update(verifier)
+  .digest("base64url");
+const state = crypto.randomBytes(16).toString("hex");
+
+const authURL = new URL("https://x.com/i/oauth2/authorize");
+authURL.searchParams.set("response_type", "code");
+authURL.searchParams.set("client_id", CLIENT_ID);
+authURL.searchParams.set("redirect_uri", REDIRECT);
+authURL.searchParams.set("scope", SCOPES);
+authURL.searchParams.set("state", state);
+authURL.searchParams.set("code_challenge", challenge);
+authURL.searchParams.set("code_challenge_method", "S256");
+
+console.log("Open this URL and click \"Authorize app\":\n" + authURL.toString());
+
+const server = http.createServer(async (req, res) => {
+  const url = new URL(req.url, REDIRECT);
+  if (!url.pathname.startsWith("/callback")) {
+    res.writeHead(404).end();
+    return;
+  }
+  const code = url.searchParams.get("code");
+  if (!code || url.searchParams.get("state") !== state) {
+    res.writeHead(400).end("bad state");
+    server.close();
+    process.exit(1);
+  }
+  const basic = Buffer.from(
+    `${CLIENT_ID}:${CLIENT_SECRET}`
+  ).toString("base64");
+  const tokenRes = await fetch("https://api.x.com/2/oauth2/token", {
+    method: "POST",
+    headers: {
+      Authorization: `Basic ${basic}`,
+      "Content-Type": "application/x-www-form-urlencoded",
+    },
+    body: new URLSearchParams({
+      grant_type: "authorization_code",
+      code,
+      redirect_uri: REDIRECT,
+      code_verifier: verifier,
+    }),
+  });
+  const tok = await tokenRes.json();
+  console.log(JSON.stringify(tok, null, 2));
+  res.writeHead(200).end("Authorized — check your terminal.");
+  server.close();
+});
+
+server.listen(8765, "127.0.0.1");
+```
+
+</details>
+
+### 4. Use the token
+
+```typescript
+import { x as createX } from "@apicity/x";
+
+const x = createX({ accessToken: process.env.X_ACCESS_TOKEN });
+
+await x.post.v2.tweets({
+  text: "hello from @apicity/x",
+});
+```
+
+## Real-world example: post a video
+
+Posting a video on X is a four-call dance — initialize a chunked
+media upload, append the bytes, finalize to kick off transcoding,
+poll until the media is ready, then attach the resulting `media_id`
+to the tweet. The flow below is taken verbatim from
+[`tests/integration/x-post-video.test.ts`](../../../tests/integration/x-post-video.test.ts)
+and replays against
+[`tests/recordings/x_*/post-video_*/recording.har`](../../../tests/recordings/),
+so the response shapes match what X actually returns.
+
+```typescript
+import { readFileSync } from "node:fs";
+import { x as createX } from "@apicity/x";
+
+const x = createX({ accessToken: process.env.X_ACCESS_TOKEN! });
+
+// 1. Initialize a chunked upload — declare the media type, total
+//    byte length, and category up-front. X reserves a media_id we'll
+//    thread through every later call.
+const bytes = readFileSync("./jump.mp4"); // 1,318,021 bytes in the recording
+const init = await x.post.v2.media.upload.initialize({
+  media_type: "video/mp4",
+  total_bytes: bytes.length,
+  media_category: "tweet_video",
+});
+const mediaId = init.data.id;
+// → "2050123807214718976"
+
+// 2. Append the bytes. For files >5MB slice the buffer into
+//    segments and call append once per chunk with segment_index 0..n.
+await x.post.v2.media.upload.append(mediaId, {
+  media: new Blob([bytes], { type: "video/mp4" }),
+  segment_index: 0,
+});
+
+// 3. Finalize. X queues server-side transcoding and returns
+//    processing_info.state = "pending" while the worker is busy.
+const fin = await x.post.v2.media.upload.finalize(mediaId);
+// fin.data.processing_info → { state: "pending", check_after_secs: 1 }
+
+// 4. Poll status until the media is ready. Honor
+//    `check_after_secs` so the loop respects X's pacing hint.
+let state = fin.data.processing_info?.state ?? "succeeded";
+let wait = fin.data.processing_info?.check_after_secs ?? 1;
+while (state === "pending" || state === "in_progress") {
+  await new Promise((r) => setTimeout(r, wait * 1000));
+  const status = await x.get.v2.media.upload(mediaId);
+  state = status.data.processing_info?.state ?? "succeeded";
+  wait = status.data.processing_info?.check_after_secs ?? 1;
+}
+// status.data.processing_info → { state: "succeeded", progress_percent: 100 }
+
+// 5. Post the tweet, attaching the now-ready media id.
+const tweet = await x.post.v2.tweets({
+  text: "jump",
+  media: { media_ids: [mediaId] },
+});
+
+console.log(tweet.data.id);
+// → "2050123819986378933"
+console.log(tweet.data.text);
+// → "jump https://t.co/X8cTIpcy3s"
+//   X auto-appends the attached media's t.co URL to the returned
+//   text — the literal request body just had "jump".
+```
+
+**Notes**
+
+- `media_category` must match the asset: `tweet_video`, `tweet_image`,
+  `tweet_gif`, or `amplify_video` for long-form. Mismatches are rejected
+  at finalize, not initialize.
+- Uploads expire after `data.expires_after_secs` (24h). If you finalize
+  but never reference the `media_id` in a tweet, it is garbage-collected.
+- Errors from any step throw `XError` with `status` and the parsed body
+  attached, so `try { ... } catch (e) { if (e instanceof XError) ... }`
+  gives you the upstream `errors[0].message` or `detail` directly.
+
+## API Reference
+
+5 endpoints across 2 groups. Each method mirrors an upstream URL path.
+
+### media
+
+<details>
+<summary><code>GET</code> <b><code>x.v2.media.upload</code></b></summary>
+
+<code>GET https://api.x.com/2/media/upload{query}</code>
+
+[Upstream docs ↗](https://docs.x.com/x-api/media/get-media-upload-status)
+
+```typescript
+const res = await x.v2.media.upload({ /* ... */ });
+```
+
+Source: [`packages/provider/x/src/x.ts`](src/x.ts)
+
+</details>
+
+<details>
+<summary><code>POST</code> <b><code>x.v2.media.upload.append</code></b></summary>
+
+<code>POST https://api.x.com/2/media/upload/{id}/append</code>
+
+[Upstream docs ↗](https://docs.x.com/x-api/media/append-media-upload)
+
+```typescript
+const res = await x.v2.media.upload.append({ /* ... */ });
+```
+
+Source: [`packages/provider/x/src/x.ts`](src/x.ts)
+
+</details>
+
+<details>
+<summary><code>POST</code> <b><code>x.v2.media.upload.finalize</code></b></summary>
+
+<code>POST https://api.x.com/2/media/upload/{id}/finalize</code>
+
+[Upstream docs ↗](https://docs.x.com/x-api/media/finalize-media-upload)
+
+```typescript
+const res = await x.v2.media.upload.finalize({ /* ... */ });
+```
+
+Source: [`packages/provider/x/src/x.ts`](src/x.ts)
+
+</details>
+
+<details>
+<summary><code>POST</code> <b><code>x.v2.media.upload.initialize</code></b></summary>
+
+<code>POST https://api.x.com/2/media/upload/initialize</code>
+
+[Upstream docs ↗](https://docs.x.com/x-api/media/media-upload-initialize)
+
+```typescript
+const res = await x.v2.media.upload.initialize({ /* ... */ });
+```
+
+Source: [`packages/provider/x/src/x.ts`](src/x.ts)
+
+</details>
+
+### tweets
+
+<details>
+<summary><code>POST</code> <b><code>x.v2.tweets</code></b></summary>
+
+<code>POST https://api.x.com/2/tweets</code>
+
+[Upstream docs ↗](https://docs.x.com/x-api/posts/create-post)
+
+```typescript
+const res = await x.v2.tweets({ /* ... */ });
+```
+
+Source: [`packages/provider/x/src/x.ts`](src/x.ts)
+
+</details>
+
+Part of the [apicity](https://github.com/justintanner/apicity) monorepo.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

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,CAe7C,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,100 @@
+// 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 v2.media.upload.initialize": {
+        "source": "x/media-upload-initialize",
+        "payload": {
+            "media_type": "video/mp4",
+            "total_bytes": 64,
+            "media_category": "tweet_video"
+        }
+    },
+    "POST v2.tweets": {
+        "source": "x/tweets-create",
+        "payload": {
+            "text": "hello from @apicity/x"
+        }
+    }
+};
+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/index.d.ts

@@ -0,0 +1,4 @@
+export { x } from "./x";
+export { XError } from "./types";
+export type { XOptions, XMediaUploadInitializeRequest, XMediaUploadInitializeResponse, XMediaUploadInitializeData, XMediaUploadInitializeMethod, XMediaUploadAppendRequest, XMediaUploadAppendResponse, XMediaUploadAppendMethod, XMediaUploadFinalizeResponse, XMediaUploadFinalizeMethod, XMediaUploadStatusResponse, XMediaUploadStatusMethod, XTweetCreateRequest, XTweetCreateResponse, XTweetCreateMethod, XMediaProcessingInfo, XMediaUploadNamespace, XMediaNamespace, XPostV2Namespace, XPostNamespace, XGetMediaNamespace, XGetV2Namespace, XGetNamespace, XProvider, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,YAAY,EACV,QAAQ,EACR,6BAA6B,EAC7B,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+export { x } from "./x.js";
+export { XError } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,89 @@
+import type { z } from "zod";
+import type { XMediaUploadInitializeRequest, XMediaUploadAppendRequest, XTweetCreateRequest } from "./zod";
+export type { XOptions, XMediaUploadInitializeRequest, XMediaUploadAppendRequest, XTweetCreateRequest, } from "./zod";
+export declare class XError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    readonly code?: string;
+    constructor(message: string, status: number, body?: unknown, code?: string);
+}
+export interface XMediaProcessingInfo {
+    type: string;
+    state: "pending" | "in_progress" | "succeeded" | "failed";
+    progress_percent?: number;
+    check_after_secs?: number;
+    error?: {
+        name?: string;
+        message?: string;
+    };
+}
+export interface XMediaUploadInitializeData {
+    id: string;
+    media_key: string;
+    expires_after_secs: number;
+    size: number;
+    processing_info?: XMediaProcessingInfo;
+}
+export interface XMediaUploadInitializeResponse {
+    data: XMediaUploadInitializeData;
+}
+export interface XMediaUploadAppendResponse {
+    data: {
+        expires_at: number;
+    };
+}
+export type XMediaUploadFinalizeResponse = XMediaUploadInitializeResponse;
+export type XMediaUploadStatusResponse = XMediaUploadInitializeResponse;
+export interface XTweetCreateResponse {
+    data: {
+        id: string;
+        text: string;
+    };
+}
+export interface XMediaUploadInitializeMethod {
+    (req: XMediaUploadInitializeRequest, signal?: AbortSignal): Promise<XMediaUploadInitializeResponse>;
+    schema: z.ZodType<XMediaUploadInitializeRequest>;
+}
+export interface XMediaUploadAppendMethod {
+    (id: string, req: XMediaUploadAppendRequest, signal?: AbortSignal): Promise<XMediaUploadAppendResponse>;
+    schema: z.ZodType<XMediaUploadAppendRequest>;
+}
+export interface XMediaUploadFinalizeMethod {
+    (id: string, signal?: AbortSignal): Promise<XMediaUploadFinalizeResponse>;
+}
+export interface XMediaUploadStatusMethod {
+    (mediaId: string, signal?: AbortSignal): Promise<XMediaUploadStatusResponse>;
+}
+export interface XTweetCreateMethod {
+    (req: XTweetCreateRequest, signal?: AbortSignal): Promise<XTweetCreateResponse>;
+    schema: z.ZodType<XTweetCreateRequest>;
+}
+export interface XMediaUploadNamespace {
+    initialize: XMediaUploadInitializeMethod;
+    append: XMediaUploadAppendMethod;
+    finalize: XMediaUploadFinalizeMethod;
+}
+export interface XMediaNamespace {
+    upload: XMediaUploadNamespace;
+}
+export interface XPostV2Namespace {
+    media: XMediaNamespace;
+    tweets: XTweetCreateMethod;
+}
+export interface XPostNamespace {
+    v2: XPostV2Namespace;
+}
+export interface XGetMediaNamespace {
+    upload: XMediaUploadStatusMethod;
+}
+export interface XGetV2Namespace {
+    media: XGetMediaNamespace;
+}
+export interface XGetNamespace {
+    v2: XGetV2Namespace;
+}
+export interface XProvider {
+    post: XPostNamespace;
+    get: XGetNamespace;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,14 @@
+// -- Error -------------------------------------------------------------------
+export class XError extends Error {
+    status;
+    body;
+    code;
+    constructor(message, status, body, code) {
+        super(message);
+        this.name = "XError";
+        this.status = status;
+        this.body = body ?? null;
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAcA,+EAA+E;AAE/E,MAAM,OAAO,MAAO,SAAQ,KAAK;IACtB,MAAM,CAAS;IACf,IAAI,CAAU;IACd,IAAI,CAAU;IAEvB,YAAY,OAAe,EAAE,MAAc,EAAE,IAAc,EAAE,IAAa;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/src/x.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"x.d.ts","sourceRoot":"","sources":["../../src/x.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EASR,SAAS,EAEV,MAAM,SAAS,CAAC;AAQjB,wBAAgB,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAsP3C"}