@luanxdd/socialkit 1.0.0

package/LICENSE

@@ -0,0 +1 @@
+MIT License

package/README.md

@@ -0,0 +1,65 @@
+# @luanxdd/socialkit
+
+A SDK oficial do SocialKit para TypeScript e JavaScript.
+
+```bash
+pnpm add @luanxdd/socialkit
+```
+
+## Uso
+
+```ts
+import { SocialKit } from "@luanxdd/socialkit"
+
+const social = new SocialKit({
+  endpoint: "https://social.example.com",
+  token: process.env.SOCIALKIT_TOKEN!,
+})
+
+const post = await social.resolve("https://x.com/user/status/123456789", {
+  timeout: 30_000,
+})
+
+post.platform       // "x"
+post.caption        // string | undefined
+post.author?.avatar // URL privada e temporária
+post.media[0]?.url  // URL pronta para consumo
+```
+
+`resolve` espera o necessário e devolve um `Post`; filas, polling e campos internos não vazam para o caminho comum.
+
+## Cancelamento
+
+```ts
+const controller = new AbortController()
+
+const post = await social.resolve(url, {
+  timeout: 15_000,
+  signal: controller.signal,
+})
+```
+
+## Resoluções avançadas
+
+```ts
+const resolution = await social.resolutions.create(url, { wait: 0 })
+const current = await social.resolutions.get(resolution.id)
+const recent = await social.resolutions.list({ limit: 20 })
+await social.resolutions.cancel(resolution.id)
+```
+
+## Erros
+
+```ts
+import { SocialKitError } from "@luanxdd/socialkit"
+
+try {
+  await social.resolve(url)
+} catch (error) {
+  if (error instanceof SocialKitError) {
+    console.error(error.status, error.code, error.requestId)
+  }
+}
+```
+
+O endpoint precisa usar HTTPS, exceto em `localhost`. Tokens têm o prefixo `so_live_` e nunca devem ir para código client-side.

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import { Resolutions } from "./resolutions.js";
+import type { Post, ResolveOptions, SocialKitOptions } from "./types/index.js";
+export declare class SocialKit {
+    readonly resolutions: Resolutions;
+    constructor(options: SocialKitOptions);
+    resolve(url: string, options?: ResolveOptions): Promise<Post>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EACV,IAAI,EACJ,cAAc,EACd,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AAEzB,qBAAa,SAAS;IACpB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IAEjC,YACE,OAAO,EAAE,gBAAgB,EAK1B;IAEK,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyFf;CACF"}

package/dist/client.js

@@ -0,0 +1,61 @@
+import { SocialKitError } from "./errors.js";
+import { Resolutions } from "./resolutions.js";
+import { Transport } from "./transport.js";
+export class SocialKit {
+    resolutions;
+    constructor(options) {
+        this.resolutions = new Resolutions(new Transport(options));
+    }
+    async resolve(url, options = {}) {
+        const timeout = options.timeout ?? 30_000;
+        const deadline = Date.now() + timeout;
+        let resolution = await this.resolutions.create(url, {
+            wait: Math.min(20, Math.max(0, Math.floor(timeout / 1_000))),
+            ...(options.signal
+                ? {
+                    signal: options.signal,
+                }
+                : {}),
+        });
+        while ([
+            "queued",
+            "processing",
+        ].includes(resolution.status) &&
+            Date.now() < deadline) {
+            await pause(Math.min(400, Math.max(0, deadline - Date.now())), options.signal);
+            resolution =
+                await this.resolutions.get(resolution.id, options.signal);
+        }
+        if (resolution.status === "completed" &&
+            resolution.post) {
+            return resolution.post;
+        }
+        if (resolution.status === "failed") {
+            throw new SocialKitError(422, resolution.error ??
+                "resolution_failed", "The post could not be resolved.", null);
+        }
+        if (resolution.status === "cancelled") {
+            throw new SocialKitError(409, "resolution_cancelled", "The resolution was cancelled.", null);
+        }
+        throw new SocialKitError(408, "resolution_timeout", "The post is still being resolved.", null);
+    }
+}
+const pause = async (duration, signal) => {
+    if (duration <= 0) {
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, duration);
+        signal?.addEventListener("abort", onAbort, {
+            once: true,
+        });
+    });
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+export declare class SocialKitError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId: string | null;
+    constructor(status: number, code: string, message: string, requestId: string | null);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IAErC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAJnC,YACW,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM,GAAG,IAAI,EAKlC;CACF"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+export class SocialKitError extends Error {
+    status;
+    code;
+    requestId;
+    constructor(status, code, message, requestId) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+        this.name = "SocialKitError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAE5B,MAAM;IACN,IAAI;IAEJ,SAAS;IAJpB,YACW,MAAc,EACd,IAAY,EACrB,OAAe,EACN,SAAwB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAA;sBALL,MAAM;oBACN,IAAI;yBAEJ,SAAS;QAIlB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SocialKit } from "./client.js";
+export { SocialKitError } from "./errors.js";
+export { Resolutions } from "./resolutions.js";
+export type * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,mBAAmB,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SocialKit } from "./client.js";
+export { SocialKitError } from "./errors.js";
+export { Resolutions } from "./resolutions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/resolutions.d.ts

@@ -0,0 +1,14 @@
+import type { Transport } from "./transport.js";
+import type { CreateResolutionOptions, Resolution } from "./types/index.js";
+export declare class Resolutions {
+    private readonly transport;
+    constructor(transport: Transport);
+    create(url: string, options?: CreateResolutionOptions): Promise<Resolution>;
+    get(id: string, signal?: AbortSignal): Promise<Resolution>;
+    list(options?: Readonly<{
+        limit?: number;
+        signal?: AbortSignal;
+    }>): Promise<readonly Resolution[]>;
+    cancel(id: string, signal?: AbortSignal): Promise<void>;
+}
+//# sourceMappingURL=resolutions.d.ts.map

package/dist/resolutions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolutions.d.ts","sourceRoot":"","sources":["../src/resolutions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EACV,uBAAuB,EAGvB,UAAU,EAEX,MAAM,kBAAkB,CAAA;AAkDzB,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAD5B,YACmB,SAAS,EAAE,SAAS,EACnC;IAEE,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,CAAC,CA2BrB;IAEK,GAAG,CACP,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAgBrB;IAEK,IAAI,CACR,OAAO,GAAE,QAAQ,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,WAAW,CAAA;KACrB,CAAM,GACN,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAqBhC;IAEK,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAYf;CACF"}

package/dist/resolutions.js

@@ -0,0 +1,148 @@
+export class Resolutions {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async create(url, options = {}) {
+        const response = await this.transport.request("/v1/resolutions", {
+            method: "POST",
+            body: JSON.stringify({
+                url,
+                ...(options.wait !== undefined
+                    ? {
+                        wait: options.wait,
+                    }
+                    : {}),
+            }),
+            ...(options.signal
+                ? {
+                    signal: options.signal,
+                }
+                : {}),
+        });
+        return mapResolution(response.data);
+    }
+    async get(id, signal) {
+        const response = await this.transport.request(`/v1/resolutions/${encodeURIComponent(id)}`, signal
+            ? {
+                signal,
+            }
+            : {});
+        return mapResolution(response.data);
+    }
+    async list(options = {}) {
+        const limit = options.limit ?? 20;
+        const response = await this.transport.request(`/v1/resolutions?limit=${limit}`, options.signal
+            ? {
+                signal: options.signal,
+            }
+            : {});
+        return response.data.map(mapResolution);
+    }
+    async cancel(id, signal) {
+        await this.transport.request(`/v1/resolutions/${encodeURIComponent(id)}`, {
+            method: "DELETE",
+            ...(signal
+                ? {
+                    signal,
+                }
+                : {}),
+        });
+    }
+}
+const mapResolution = (value) => ({
+    id: value.id,
+    status: value.status,
+    platform: value.platform,
+    url: value.source_url,
+    progress: value.progress,
+    ...(value.result
+        ? {
+            post: mapPost(value.result),
+        }
+        : {}),
+    ...(value.error_code
+        ? {
+            error: value.error_code,
+        }
+        : {}),
+    attempts: value.attempt_count,
+    createdAt: new Date(value.created_at),
+    updatedAt: new Date(value.updated_at),
+    ...(value.completed_at
+        ? {
+            completedAt: new Date(value.completed_at),
+        }
+        : {}),
+    ...(value.expires_at
+        ? {
+            expiresAt: new Date(value.expires_at),
+        }
+        : {}),
+});
+const mapPost = (value) => ({
+    platform: value.platform,
+    id: value.id,
+    url: value.source_url,
+    kind: value.type,
+    ...(value.text
+        ? {
+            caption: value.text,
+        }
+        : {}),
+    ...(value.author
+        ? {
+            author: {
+                ...(value.author.name
+                    ? {
+                        name: value.author.name,
+                    }
+                    : {}),
+                ...(value.author.username
+                    ? {
+                        username: value.author.username,
+                    }
+                    : {}),
+                ...(value.author.avatar_url
+                    ? {
+                        avatar: value.author.avatar_url,
+                    }
+                    : {}),
+            },
+        }
+        : {}),
+    media: value.media.flatMap((item) => item.url
+        ? [
+            {
+                kind: item.type,
+                url: item.url,
+                ...(item.thumbnail_url
+                    ? {
+                        preview: item.thumbnail_url,
+                    }
+                    : {}),
+                ...(item.width !== undefined
+                    ? {
+                        width: item.width,
+                    }
+                    : {}),
+                ...(item.height !== undefined
+                    ? {
+                        height: item.height,
+                    }
+                    : {}),
+                ...(item.duration !== undefined
+                    ? {
+                        duration: item.duration,
+                    }
+                    : {}),
+            },
+        ]
+        : []),
+    ...(value.metrics
+        ? {
+            stats: value.metrics,
+        }
+        : {}),
+});
+//# sourceMappingURL=resolutions.js.map

package/dist/resolutions.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,7 @@
+import type { SocialKitOptions } from "./types/index.js";
+export declare class Transport {
+    #private;
+    constructor(options: SocialKitOptions);
+    request<T>(path: string, init?: RequestInit): Promise<T>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,qBAAa,SAAS;;IAMpB,YACE,OAAO,EAAE,gBAAgB,EA2C1B;IAEK,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,CAAC,CAAC,CAkFZ;CACF"}

package/dist/transport.js

@@ -0,0 +1,69 @@
+import { SocialKitError } from "./errors.js";
+export class Transport {
+    #endpoint;
+    #token;
+    #timeout;
+    #fetch;
+    constructor(options) {
+        const endpoint = new URL(options.endpoint);
+        const local = [
+            "localhost",
+            "127.0.0.1",
+            "::1",
+        ].includes(endpoint.hostname);
+        if (endpoint.protocol !== "https:" &&
+            !local) {
+            throw new Error("SocialKit requires HTTPS outside localhost.");
+        }
+        if (!/^so_live_[A-Za-z0-9_-]{43}$/.test(options.token)) {
+            throw new Error("Invalid SocialKit token.");
+        }
+        this.#endpoint =
+            options.endpoint.replace(/\/$/, "");
+        this.#token = options.token;
+        this.#timeout =
+            options.timeout ?? 30_000;
+        this.#fetch =
+            options.fetch ?? globalThis.fetch;
+    }
+    async request(path, init = {}) {
+        const headers = new Headers(init.headers);
+        headers.set("authorization", `Bearer ${this.#token}`);
+        if (init.body !== undefined) {
+            headers.set("content-type", "application/json");
+        }
+        const timeout = AbortSignal.timeout(this.#timeout);
+        const signal = init.signal
+            ? AbortSignal.any([
+                init.signal,
+                timeout,
+            ])
+            : timeout;
+        const response = await this.#fetch(`${this.#endpoint}${path}`, {
+            ...init,
+            headers,
+            signal,
+        });
+        if (response.status === 204) {
+            return undefined;
+        }
+        const body = (await response
+            .json()
+            .catch(() => null));
+        if (!response.ok) {
+            const value = typeof body?.error === "object" &&
+                body.error
+                ? body.error
+                : body;
+            throw new SocialKitError(response.status, typeof value?.code === "string"
+                ? value.code
+                : "request_failed", typeof value?.message === "string"
+                ? value.message
+                : "SocialKit request failed.", typeof value?.request_id === "string"
+                ? value.request_id
+                : null);
+        }
+        return body;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAG5C,MAAM,OAAO,SAAS;IACX,SAAS,CAAQ;IACjB,MAAM,CAAQ;IACd,QAAQ,CAAQ;IAChB,MAAM,CAAyB;IAExC,YACE,OAAyB;QAEzB,MAAM,QAAQ,GACZ,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3B,MAAM,KAAK,GAAG;YACZ,WAAW;YACX,WAAW;YACX,KAAK;SACN,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAE7B,IACE,QAAQ,CAAC,QAAQ,KAAK,QAAQ;YAC9B,CAAC,KAAK,EACN,CAAC;YACD,MAAM,IAAI,KAAK,CACb,6CAA6C,CAC9C,CAAA;QACH,CAAC;QAED,IACE,CAAC,6BAA6B,CAAC,IAAI,CACjC,OAAO,CAAC,KAAK,CACd,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0BAA0B,CAC3B,CAAA;QACH,CAAC;QAED,IAAI,CAAC,SAAS;YACZ,OAAO,CAAC,QAAQ,CAAC,OAAO,CACtB,KAAK,EACL,EAAE,CACH,CAAA;QAEH,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAA;QAE3B,IAAI,CAAC,QAAQ;YACX,OAAO,CAAC,OAAO,IAAI,MAAM,CAAA;QAE3B,IAAI,CAAC,MAAM;YACT,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,IAAI,GAAgB,EAAE;QAEtB,MAAM,OAAO,GACX,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAE3B,OAAO,CAAC,GAAG,CACT,eAAe,EACf,UAAU,IAAI,CAAC,MAAM,EAAE,CACxB,CAAA;QAED,IACE,IAAI,CAAC,IAAI,KAAK,SAAS,EACvB,CAAC;YACD,OAAO,CAAC,GAAG,CACT,cAAc,EACd,kBAAkB,CACnB,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GACX,WAAW,CAAC,OAAO,CACjB,IAAI,CAAC,QAAQ,CACd,CAAA;QAEH,MAAM,MAAM,GACV,IAAI,CAAC,MAAM;YACT,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC;gBACd,IAAI,CAAC,MAAM;gBACX,OAAO;aACR,CAAC;YACJ,CAAC,CAAC,OAAO,CAAA;QAEb,MAAM,QAAQ,GACZ,MAAM,IAAI,CAAC,MAAM,CACf,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,EAC1B;YACE,GAAG,IAAI;YACP,OAAO;YACP,MAAM;SACP,CACF,CAAA;QAEH,IACE,QAAQ,CAAC,MAAM,KAAK,GAAG,EACvB,CAAC;YACD,OAAO,SAAc,CAAA;QACvB,CAAC;QAED,MAAM,IAAI,GAAG,CACX,MAAM,QAAQ;aACX,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAGd,CAAA;QAER,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GACT,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ;gBAC/B,IAAI,CAAC,KAAK;gBACR,CAAC,CACG,IAAI,CAAC,KAIN;gBACH,CAAC,CAAC,IAAI,CAAA;YAEV,MAAM,IAAI,cAAc,CACtB,QAAQ,CAAC,MAAM,EACf,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ;gBAC7B,CAAC,CAAC,KAAK,CAAC,IAAI;gBACZ,CAAC,CAAC,gBAAgB,EACpB,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ;gBAChC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,2BAA2B,EAC/B,OAAO,KAAK,EAAE,UAAU,KAAK,QAAQ;gBACnC,CAAC,CAAC,KAAK,CAAC,UAAU;gBAClB,CAAC,CAAC,IAAI,CACT,CAAA;QACH,CAAC;QAED,OAAO,IAAS,CAAA;IAClB,CAAC;CACF"}

package/dist/types/index.d.ts

@@ -0,0 +1,54 @@
+export type Platform = "instagram" | "tiktok" | "x" | "pinterest";
+export type ResolutionStatus = "queued" | "processing" | "completed" | "failed" | "cancelled";
+export type Media = Readonly<{
+    kind: "photo" | "video" | "gif";
+    url: string;
+    preview?: string;
+    width?: number;
+    height?: number;
+    duration?: number;
+}>;
+export type Author = Readonly<{
+    name?: string;
+    username?: string;
+    avatar?: string;
+}>;
+export type Post = Readonly<{
+    platform: Platform;
+    id: string;
+    url: string;
+    kind: string;
+    caption?: string;
+    author?: Author;
+    media: readonly Media[];
+    stats?: Readonly<Record<string, number>>;
+}>;
+export type Resolution = Readonly<{
+    id: string;
+    status: ResolutionStatus;
+    platform: Platform;
+    url: string;
+    progress: number;
+    post?: Post;
+    error?: string;
+    attempts: number;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+    expiresAt?: Date;
+}>;
+export type SocialKitOptions = Readonly<{
+    endpoint: string;
+    token: string;
+    timeout?: number;
+    fetch?: typeof globalThis.fetch;
+}>;
+export type ResolveOptions = Readonly<{
+    timeout?: number;
+    signal?: AbortSignal;
+}>;
+export type CreateResolutionOptions = Readonly<{
+    wait?: number;
+    signal?: AbortSignal;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,QAAQ,GACR,GAAG,GACH,WAAW,CAAA;AAEf,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,WAAW,CAAA;AAEf,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC3B,IAAI,EACA,OAAO,GACP,OAAO,GACP,KAAK,CAAA;IACT,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAC,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAC,CAAA;AAEF,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,KAAK,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,QAAQ,CACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACvB,CAAA;CACF,CAAC,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB,CAAC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC,CAAC,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAC,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@luanxdd/socialkit",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "check": "pnpm typecheck && pnpm test && pnpm build",
+    "pack:check": "pnpm build && npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}