@luanxdd/meowgallery 0.0.0-stage → 0.4.0

package/README.md

@@ -1,3 +1,100 @@
-# Temporary Holding Version
+# MeowGallery
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Publicações, imagens, vídeos e áudio em uma interface pequena e organizada.
+TypeScript, ESM, Node.js 22+ e navegadores modernos. Sem dependências de produção.
+
+## Instalar
+
+Após publicar esta versão: `npm install @luanxdd/meowgallery@^0.4.0`.
+Antes da publicação, instale o arquivo `luanxdd-meowgallery-0.4.0.tgz` incluído no ZIP.
+
+## Uma publicação
+
+```typescript
+import { MeowGallery } from "@luanxdd/meowgallery";
+
+const gallery = new MeowGallery({
+  baseUrl: "https://gallery.kairogg.com.br",
+  token: process.env.MEOWGALLERY_KEY!,
+});
+
+const post = await gallery.posts.resolve(url);
+
+console.log(post.author.name, post.caption);
+console.log(post.video?.url);
+```
+
+Reutilize uma instância por configuração de autenticação. `post.items` preserva a ordem original; `post.images` e `post.videos` selecionam tipos; `post.video` é o primeiro vídeo ou `undefined`. `post.audio` contém a faixa separada quando disponível, ou `null`.
+
+## Pronto para bots
+
+```typescript
+import { streamMedia } from "@luanxdd/meowgallery/node";
+
+if (post.video) {
+  const stream = await streamMedia(post.video, {
+    signal: AbortSignal.timeout(60_000),
+  });
+
+  // Passe stream ao método de envio do framework.
+}
+```
+
+O stream começa sem aguardar o arquivo inteiro e sem gravar em disco. O framework pode precisar preparar ou armazenar a mídia por conta própria. Consuma o stream ou encerre com `stream.destroy()`.
+
+Para frameworks que aceitam URL, use `post.video.url`: é o link temporário protegido, não a origem da rede social. Não acrescente a chave da API a esse link.
+
+## Mídia
+
+| Operação | Resultado |
+| --- | --- |
+| `item.url` | Link protegido |
+| `item.expired` | Se o link já expirou |
+| `item.open(options)` | Response com status e cabeçalhos |
+| `item.stream(options)` | Web Stream |
+| `item.toJSON()` | Metadados serializáveis |
+
+`open` e `stream` aceitam `signal` e `range`, como `{ range: "bytes=0-1023" }`. Consuma ou cancele cada corpo. Não há Buffer completo automático.
+
+Para gravar explicitamente no consumidor:
+
+```typescript
+import { saveMedia } from "@luanxdd/meowgallery/node";
+
+if (post.video) {
+  await saveMedia(post.video, "./video.mp4", {
+    maxBytes: 64 * 1024 * 1024,
+  });
+}
+```
+
+A gravação é atômica, não sobrescreve destinos e remove arquivos parciais. Fotos e áudio permanecem separados; não há conversão para MP4. Confira `mimeType` ao escolher a extensão.
+
+## Acesso, erros e expiração
+
+`gallery.access.create(input)`, `list()` e `revoke(id)` exigem Owner. Bots precisam dos escopos `captures:read` e `delivery:read`. `sources:authenticated` permite usar a sessão Instagram configurada. Nunca exponha chaves de bots ou Owner no frontend.
+
+OAuth aceita `token: async () => auth.getAccessToken()`; login e renovação pertencem ao provedor de identidade. A função é chamada antes de cada operação autenticada.
+
+`MeowGalleryError` contém `code`, `status`, `requestId` e `retryAfter`. Operações aceitam `signal: AbortSignal.timeout(30_000)`.
+
+Links expiram. Resolva o post novamente para obter links novos; use `{ refresh: true }` se a origem expirar antes do link. Não há repetição automática de POST nem cache de credenciais na SDK.
+
+## Compatibilidade
+
+`gallery.capture(url)` retorna dados simples. `gallery.download(item)` e os métodos antigos de credenciais permanecem disponíveis.
+
+`gallery.posts.resolve(url)` retorna `Publication`, compatível estruturalmente com `Capture`, com itens `MediaItem`. `post.toJSON()` e `JSON.stringify(post)` produzem dados sem transporte ou token.
+
+`streamMedia(gallery, item)` e `saveMedia(gallery, item, destination)` continuam funcionando.
+
+## Desenvolvimento
+
+```bash
+npm ci
+npm run check
+npm test
+npm pack
+```
+
+`core` contém transporte; `models`, contratos; `resources`, operações e objetos; `node`, adaptação e arquivos. Aliases internos nativos ficam em `package.json#imports`; o consumidor não precisa configurar aliases. A entrada `/node` não deve entrar em bundles de navegador.

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import { Access } from "#resources/access";
+import { MediaLibrary } from "#resources/media";
+import { Posts } from "#resources/posts";
+import type { CaptureOptions, CredentialInput, DeliveryOptions, Media, MeowGalleryOptions, RequestOptions } from "#types";
+export declare class MeowGallery {
+    readonly posts: Posts;
+    readonly media: MediaLibrary;
+    readonly access: Access;
+    constructor(options: MeowGalleryOptions);
+    capture(url: string, options?: CaptureOptions): Promise<import("#types").Capture>;
+    download(media: Media, options?: DeliveryOptions): Promise<Response>;
+    createCredential(input: CredentialInput, options?: RequestOptions): Promise<import("#types").CreatedCredential>;
+    listCredentials(options?: RequestOptions): Promise<import("#types").Credential[]>;
+    revokeCredential(id: string, options?: RequestOptions): Promise<void>;
+}

package/dist/client.js

@@ -0,0 +1,32 @@
+import { Transport } from "#core/transport";
+import { Access } from "#resources/access";
+import { MediaLibrary } from "#resources/media";
+import { Posts } from "#resources/posts";
+export class MeowGallery {
+    posts;
+    media;
+    access;
+    constructor(options) {
+        const transport = new Transport(options);
+        this.media = new MediaLibrary(transport);
+        this.posts = new Posts(transport, this.media);
+        this.access = new Access(transport);
+    }
+    async capture(url, options = {}) {
+        const publication = await this.posts.resolve(url, options);
+        return publication.toJSON();
+    }
+    download(media, options = {}) {
+        return this.media.open(media, options);
+    }
+    createCredential(input, options = {}) {
+        return this.access.create(input, options);
+    }
+    listCredentials(options = {}) {
+        return this.access.list(options);
+    }
+    revokeCredential(id, options = {}) {
+        return this.access.revoke(id, options);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAUzC,MAAM,OAAO,WAAW;IACb,KAAK,CAAQ;IACb,KAAK,CAAe;IACpB,MAAM,CAAS;IAExB,YAAY,OAA2B;QACrC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,OAAO,GAAmB,EAAE;QACrD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE3D,OAAO,WAAW,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,QAAQ,CAAC,KAAY,EAAE,OAAO,GAAoB,EAAE;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB,CAAC,KAAsB,EAAE,OAAO,GAAmB,EAAE;QACnE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,eAAe,CAAC,OAAO,GAAmB,EAAE;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,gBAAgB,CAAC,EAAU,EAAE,OAAO,GAAmB,EAAE;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/core/transport.d.ts

@@ -0,0 +1,9 @@
+import type { Media, MeowGalleryOptions, RequestOptions } from "#types";
+export declare class Transport {
+    #private;
+    constructor(options: MeowGalleryOptions);
+    download(media: Media, options?: RequestOptions & {
+        readonly range?: string;
+    }): Promise<Response>;
+    request<T>(method: string, path: string, body: unknown, options: RequestOptions): Promise<T>;
+}

package/dist/core/transport.js

@@ -0,0 +1,166 @@
+import { MeowGalleryError } from "#error";
+export class Transport {
+    #origin;
+    #token;
+    #fetch;
+    #timeout;
+    constructor(options) {
+        const url = new URL(options.baseUrl);
+        const local = ["localhost", "127.0.0.1"].includes(url.hostname);
+        if ((url.protocol !== "https:" &&
+            !(options.allowLocalHttp && local && url.protocol === "http:")) ||
+            url.username ||
+            url.password ||
+            url.pathname !== "/" ||
+            url.search ||
+            url.hash) {
+            throw new TypeError("baseUrl deve ser uma origem HTTPS válida.");
+        }
+        this.#origin = url.origin;
+        this.#token = options.token;
+        this.#fetch = options.fetch ?? globalThis.fetch;
+        this.#timeout = options.timeoutMs ?? 35_000;
+        if (!Number.isSafeInteger(this.#timeout) ||
+            this.#timeout < 1 ||
+            this.#timeout > 300_000) {
+            throw new TypeError("timeoutMs deve estar entre 1 e 300000.");
+        }
+    }
+    async download(media, options = {}) {
+        const url = new URL(media.delivery.url);
+        if (url.origin !== this.#origin ||
+            !/^\/v1\/delivery\/[A-Za-z0-9_-]+$/.test(url.pathname) ||
+            url.username ||
+            url.password ||
+            url.search ||
+            url.hash) {
+            throw new TypeError("O link de entrega não pertence a esta MeowGallery.");
+        }
+        const expires = Date.parse(media.delivery.expiresAt);
+        if (!Number.isFinite(expires) || expires <= Date.now()) {
+            throw new MeowGalleryError("O link expirou. Solicite a publicação novamente.", { code: "delivery_expired", status: 410 });
+        }
+        const headers = new Headers();
+        if (options.range) {
+            headers.set("Range", options.range);
+        }
+        const response = await this.#send(url.href, {
+            headers,
+            signal: this.#signal(options.signal, 300_000),
+        });
+        if (!response.ok) {
+            throw await this.#failure(response);
+        }
+        return response;
+    }
+    async request(method, path, body, options) {
+        const token = typeof this.#token === "function" ? await this.#token() : this.#token;
+        if (!token || /[\r\n]/.test(token)) {
+            throw new TypeError("Token de autenticação inválido.");
+        }
+        const headers = new Headers({
+            Accept: "application/json",
+            Authorization: `Bearer ${token}`,
+        });
+        const init = {
+            method,
+            headers,
+            signal: this.#signal(options.signal, this.#timeout),
+        };
+        if (body !== undefined) {
+            headers.set("Content-Type", "application/json");
+            init.body = JSON.stringify(body);
+        }
+        const response = await this.#send(`${this.#origin}${path}`, init);
+        if (!response.ok) {
+            throw await this.#failure(response);
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        const envelope = await this.#json(response);
+        if (!envelope || typeof envelope !== "object" || !("data" in envelope)) {
+            throw new MeowGalleryError("Resposta inesperada do serviço.", {
+                code: "invalid_response",
+                status: response.status,
+            });
+        }
+        return envelope.data;
+    }
+    #signal(signal, timeout) {
+        const deadline = AbortSignal.timeout(timeout);
+        return signal ? AbortSignal.any([signal, deadline]) : deadline;
+    }
+    async #send(url, init) {
+        try {
+            return await this.#fetch(url, {
+                ...init,
+                redirect: "error",
+                credentials: "omit",
+                cache: "no-store",
+            });
+        }
+        catch {
+            throw new MeowGalleryError(init.signal?.aborted
+                ? "Solicitação cancelada ou expirada."
+                : "Não foi possível conectar à MeowGallery.", { code: init.signal?.aborted ? "request_aborted" : "network_error" });
+        }
+    }
+    async #failure(response) {
+        const body = (await this.#json(response).catch(() => null));
+        const retryHeader = response.headers.get("retry-after");
+        const retry = retryHeader === null ? NaN : Number(retryHeader);
+        return new MeowGalleryError(typeof body?.error?.message === "string"
+            ? body.error.message
+            : "A solicitação não foi concluída.", {
+            code: typeof body?.error?.code === "string"
+                ? body.error.code
+                : "http_error",
+            status: response.status,
+            requestId: response.headers.get("x-request-id"),
+            retryAfter: Number.isFinite(retry) && retry >= 0 ? retry : null,
+        });
+    }
+    async #json(response) {
+        const reader = response.body?.getReader();
+        if (!reader) {
+            throw new MeowGalleryError("Resposta vazia do serviço.", {
+                code: "invalid_response",
+            });
+        }
+        const chunks = [];
+        let size = 0;
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                size += value.byteLength;
+                if (size > 1_048_576) {
+                    await reader.cancel();
+                    throw new Error("Response limit exceeded");
+                }
+                chunks.push(value);
+            }
+            const joined = new Uint8Array(size);
+            let offset = 0;
+            for (const chunk of chunks) {
+                joined.set(chunk, offset);
+                offset += chunk.byteLength;
+            }
+            return JSON.parse(new TextDecoder().decode(joined));
+        }
+        catch {
+            throw new MeowGalleryError("Resposta inválida ou interrompida do serviço.", {
+                code: "invalid_response",
+                status: response.status,
+                requestId: response.headers.get("x-request-id"),
+            });
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/core/transport.js.map

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

package/dist/error.d.ts

@@ -0,0 +1,12 @@
+export declare class MeowGalleryError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly requestId: string | null;
+    readonly retryAfter: number | null;
+    constructor(message: string, details: {
+        code: string;
+        status?: number;
+        requestId?: string | null;
+        retryAfter?: number | null;
+    });
+}

package/dist/error.js

@@ -0,0 +1,15 @@
+export class MeowGalleryError extends Error {
+    code;
+    status;
+    requestId;
+    retryAfter;
+    constructor(message, details) {
+        super(message);
+        this.name = "MeowGalleryError";
+        this.code = details.code;
+        this.status = details.status ?? 0;
+        this.requestId = details.requestId ?? null;
+        this.retryAfter = details.retryAfter ?? null;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAS;IACb,MAAM,CAAS;IACf,SAAS,CAAgB;IACzB,UAAU,CAAgB;IAEnC,YACE,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC/C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { MeowGallery } from "#client";
+export { MeowGalleryError } from "#error";
+export type * from "#types";
+export { Publication } from "#resources/publication";
+export { MediaItem } from "#resources/item";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { MeowGallery } from "#client";
+export { MeowGalleryError } from "#error";
+export { Publication } from "#resources/publication";
+export { MediaItem } from "#resources/item";
+//# 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,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/models/access.d.ts

@@ -0,0 +1,19 @@
+export type Scope = "captures:read" | "delivery:read" | "sources:authenticated";
+export interface CredentialInput {
+    readonly name: string;
+    readonly scopes: readonly Scope[];
+    readonly requestsPerMinute: number;
+    readonly subject?: string;
+}
+export interface Credential {
+    readonly id: string;
+    readonly name: string;
+    readonly scopes: readonly Scope[];
+    readonly requestsPerMinute: number;
+    readonly isAdmin: boolean;
+}
+export interface CreatedCredential extends Omit<CredentialInput, "subject"> {
+    readonly id: string;
+    readonly key: string | null;
+    readonly subject: string | null;
+}

package/dist/models/access.js

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

package/dist/models/access.js.map

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

package/dist/models/media.d.ts

@@ -0,0 +1,16 @@
+export interface Media {
+    readonly id: string;
+    readonly kind: "image" | "video" | "audio";
+    readonly mimeType: string;
+    readonly width: number | null;
+    readonly height: number | null;
+    readonly quality: {
+        readonly selection: "best_available";
+        readonly hd: boolean | null;
+        readonly verified: boolean;
+    };
+    readonly delivery: {
+        readonly url: string;
+        readonly expiresAt: string;
+    };
+}

package/dist/models/media.js

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

package/dist/models/media.js.map

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

package/dist/models/options.d.ts

@@ -0,0 +1,16 @@
+export interface RequestOptions {
+    readonly signal?: AbortSignal;
+}
+export interface MeowGalleryOptions {
+    readonly baseUrl: string;
+    readonly token: string | (() => string | Promise<string>);
+    readonly timeoutMs?: number;
+    readonly allowLocalHttp?: boolean;
+    readonly fetch?: typeof fetch;
+}
+export interface CaptureOptions extends RequestOptions {
+    readonly refresh?: boolean;
+}
+export interface DeliveryOptions extends RequestOptions {
+    readonly range?: string;
+}

package/dist/models/options.js

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

package/dist/models/options.js.map

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

package/dist/models/post.d.ts

@@ -0,0 +1,12 @@
+import type { Media } from "#models/media";
+export interface Capture {
+    readonly id: string;
+    readonly platform: "instagram" | "tiktok";
+    readonly caption: string;
+    readonly author: {
+        readonly username: string;
+        readonly name: string;
+    };
+    readonly items: readonly Media[];
+    readonly audio: Media | null;
+}

package/dist/models/post.js

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

package/dist/models/post.js.map

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

package/dist/node/save.d.ts

@@ -0,0 +1,8 @@
+import type { MeowGallery } from "#client";
+import { MediaItem } from "#resources/item";
+import type { Media, RequestOptions } from "#types";
+export interface SaveOptions extends RequestOptions {
+    readonly maxBytes?: number;
+}
+export declare function saveMedia(media: MediaItem, destination: string, options?: SaveOptions): Promise<string>;
+export declare function saveMedia(client: MeowGallery, media: Media, destination: string, options?: SaveOptions): Promise<string>;

package/dist/node/save.js

@@ -0,0 +1,46 @@
+import { createWriteStream } from "node:fs";
+import { link, mkdtemp, rm } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { MediaItem } from "#resources/item";
+export async function saveMedia(source, mediaOrDestination, destinationOrOptions, legacyOptions = {}) {
+    const destination = source instanceof MediaItem
+        ? mediaOrDestination
+        : destinationOrOptions;
+    const options = source instanceof MediaItem
+        ? destinationOrOptions ?? {}
+        : legacyOptions;
+    const target = resolve(destination);
+    const directory = await mkdtemp(join(dirname(target), ".meowgallery-"));
+    const temporary = join(directory, "media");
+    const limit = options.maxBytes ?? 256 * 1024 * 1024;
+    if (!Number.isSafeInteger(limit) || limit <= 0) {
+        await rm(directory, { recursive: true, force: true });
+        throw new TypeError("maxBytes deve ser um inteiro positivo.");
+    }
+    try {
+        const response = source instanceof MediaItem
+            ? await source.open(options)
+            : await source.download(mediaOrDestination, options);
+        if (!response.body) {
+            throw new Error("O serviço retornou uma mídia vazia.");
+        }
+        let total = 0;
+        const bounded = new Transform({
+            transform(chunk, _encoding, callback) {
+                total += chunk.length;
+                callback(total > limit
+                    ? new Error("A mídia excede o limite de tamanho.")
+                    : null, chunk);
+            },
+        });
+        await pipeline(Readable.fromWeb(response.body), bounded, createWriteStream(temporary, { flags: "wx", mode: 0o600 }), { signal: options.signal });
+        await link(temporary, target);
+        return target;
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=save.js.map

package/dist/node/save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../src/node/save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAoB5C,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA+B,EAC/B,kBAAkC,EAClC,oBAA2C,EAC3C,aAAa,GAAgB,EAAE;IAE/B,MAAM,WAAW,GAAG,MAAM,YAAY,SAAS;QAC7C,CAAC,CAAC,kBAA4B;QAC9B,CAAC,CAAC,oBAA8B,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,YAAY,SAAS;QACzC,CAAC,CAAC,oBAA+C,IAAI,EAAE;QACvD,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,SAAS;YAC1C,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAC5B,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,kBAA2B,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC;YAC5B,SAAS,CAAC,KAAa,EAAE,SAAS,EAAE,QAAQ;gBAC1C,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;gBACtB,QAAQ,CACN,KAAK,GAAG,KAAK;oBACX,CAAC,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC;oBAClD,CAAC,CAAC,IAAI,EACR,KAAK,CACN,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,QAAQ,CACZ,QAAQ,CAAC,OAAO,CACd,QAAQ,CAAC,IAA4D,CACtE,EACD,OAAO,EACP,iBAAiB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAC1D,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;QACF,MAAM,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/node/stream.d.ts

@@ -0,0 +1,6 @@
+import { Readable } from "node:stream";
+import type { MeowGallery } from "#client";
+import { MediaItem } from "#resources/item";
+import type { DeliveryOptions, Media } from "#types";
+export declare function streamMedia(media: MediaItem, options?: DeliveryOptions): Promise<Readable>;
+export declare function streamMedia(client: MeowGallery, media: Media, options?: DeliveryOptions): Promise<Readable>;

package/dist/node/stream.js

@@ -0,0 +1,16 @@
+import { Readable } from "node:stream";
+import { MediaItem } from "#resources/item";
+export async function streamMedia(source, mediaOrOptions = {}, legacyOptions = {}) {
+    const options = source instanceof MediaItem
+        ? mediaOrOptions
+        : legacyOptions;
+    const stream = source instanceof MediaItem
+        ? await source.stream(options)
+        : await source.media.stream(mediaOrOptions, options);
+    return Readable.fromWeb(stream, {
+        objectMode: false,
+        highWaterMark: 64 * 1024,
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+}
+//# sourceMappingURL=stream.js.map

package/dist/node/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/node/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAc5C,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA+B,EAC/B,cAAc,GAA4B,EAAE,EAC5C,aAAa,GAAoB,EAAE;IAEnC,MAAM,OAAO,GAAG,MAAM,YAAY,SAAS;QACzC,CAAC,CAAC,cAAiC;QACnC,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,MAAM,GAAG,MAAM,YAAY,SAAS;QACxC,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9B,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,cAAuB,EAAE,OAAO,CAAC,CAAC;IAEhE,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAoC,EAAE;QAC5D,UAAU,EAAE,KAAK;QACjB,aAAa,EAAE,EAAE,GAAG,IAAI;QACxB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;AACL,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,3 @@
+export { saveMedia } from "#node/save";
+export type { SaveOptions } from "#node/save";
+export { streamMedia } from "#node/stream";

package/dist/node.js

@@ -0,0 +1,3 @@
+export { saveMedia } from "#node/save";
+export { streamMedia } from "#node/stream";
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/resources/access.d.ts

@@ -0,0 +1,9 @@
+import type { Transport } from "#core/transport";
+import type { CreatedCredential, Credential, CredentialInput, RequestOptions } from "#types";
+export declare class Access {
+    #private;
+    constructor(transport: Transport);
+    create(input: CredentialInput, options?: RequestOptions): Promise<CreatedCredential>;
+    list(options?: RequestOptions): Promise<Credential[]>;
+    revoke(id: string, options?: RequestOptions): Promise<void>;
+}

package/dist/resources/access.js

@@ -0,0 +1,19 @@
+export class Access {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    create(input, options = {}) {
+        return this.#transport.request("POST", "/v1/credentials", input, options);
+    }
+    list(options = {}) {
+        return this.#transport.request("GET", "/v1/credentials", undefined, options);
+    }
+    revoke(id, options = {}) {
+        if (!/^[0-9a-f-]{36}$/i.test(id)) {
+            throw new TypeError("Identificador de credencial inválido.");
+        }
+        return this.#transport.request("DELETE", `/v1/credentials/${id}`, undefined, options);
+    }
+}
+//# sourceMappingURL=access.js.map

package/dist/resources/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../../src/resources/access.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,MAAM;IACR,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,MAAM,CACJ,KAAsB,EACtB,OAAO,GAAmB,EAAE;QAE5B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,OAAO,GAAmB,EAAE;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,OAAO,GAAmB,EAAE;QAC7C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAC5B,QAAQ,EACR,mBAAmB,EAAE,EAAE,EACvB,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/item.d.ts

@@ -0,0 +1,25 @@
+import type { MediaLibrary } from "#resources/media";
+import type { DeliveryOptions, Media } from "#types";
+export declare class MediaItem implements Media {
+    #private;
+    constructor(data: Media, library: MediaLibrary);
+    get id(): string;
+    get kind(): "audio" | "image" | "video";
+    get mimeType(): string;
+    get width(): number | null;
+    get height(): number | null;
+    get quality(): {
+        readonly selection: "best_available";
+        readonly hd: boolean | null;
+        readonly verified: boolean;
+    };
+    get delivery(): {
+        readonly url: string;
+        readonly expiresAt: string;
+    };
+    get url(): string;
+    get expired(): boolean;
+    open(options?: DeliveryOptions): Promise<Response>;
+    stream(options?: DeliveryOptions): Promise<ReadableStream<Uint8Array>>;
+    toJSON(): Media;
+}

package/dist/resources/item.js

@@ -0,0 +1,50 @@
+export class MediaItem {
+    #data;
+    #library;
+    constructor(data, library) {
+        this.#data = Object.freeze({
+            ...data,
+            delivery: Object.freeze({ ...data.delivery }),
+            quality: Object.freeze({ ...data.quality }),
+        });
+        this.#library = library;
+    }
+    get id() {
+        return this.#data.id;
+    }
+    get kind() {
+        return this.#data.kind;
+    }
+    get mimeType() {
+        return this.#data.mimeType;
+    }
+    get width() {
+        return this.#data.width;
+    }
+    get height() {
+        return this.#data.height;
+    }
+    get quality() {
+        return this.#data.quality;
+    }
+    get delivery() {
+        return this.#data.delivery;
+    }
+    get url() {
+        return this.delivery.url;
+    }
+    get expired() {
+        const expires = Date.parse(this.delivery.expiresAt);
+        return !Number.isFinite(expires) || expires <= Date.now();
+    }
+    open(options = {}) {
+        return this.#library.open(this, options);
+    }
+    stream(options = {}) {
+        return this.#library.stream(this, options);
+    }
+    toJSON() {
+        return this.#data;
+    }
+}
+//# sourceMappingURL=item.js.map

package/dist/resources/item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.js","sourceRoot":"","sources":["../../src/resources/item.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACX,KAAK,CAAQ;IACb,QAAQ,CAAe;IAEhC,YAAY,IAAW,EAAE,OAAqB;QAC5C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,GAAG,IAAI;YACP,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC,OAAO,GAAoB,EAAE;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,OAAO,GAAoB,EAAE;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/resources/media.d.ts

@@ -0,0 +1,8 @@
+import type { Transport } from "#core/transport";
+import type { DeliveryOptions, Media } from "#types";
+export declare class MediaLibrary {
+    #private;
+    constructor(transport: Transport);
+    open(media: Media, options?: DeliveryOptions): Promise<Response>;
+    stream(media: Media, options?: DeliveryOptions): Promise<ReadableStream<Uint8Array>>;
+}

package/dist/resources/media.js

@@ -0,0 +1,17 @@
+export class MediaLibrary {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    open(media, options = {}) {
+        return this.#transport.download(media, options);
+    }
+    async stream(media, options = {}) {
+        const response = await this.open(media, options);
+        if (!response.body) {
+            throw new Error("O serviço retornou uma mídia vazia.");
+        }
+        return response.body;
+    }
+}
+//# sourceMappingURL=media.js.map

package/dist/resources/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/resources/media.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACd,UAAU,CAAY;IAE/B,YAAY,SAAoB;QAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,KAAY,EAAE,OAAO,GAAoB,EAAE;QAC9C,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAY,EACZ,OAAO,GAAoB,EAAE;QAE7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/resources/posts.d.ts

@@ -0,0 +1,9 @@
+import type { Transport } from "#core/transport";
+import type { MediaLibrary } from "#resources/media";
+import { Publication } from "#resources/publication";
+import type { CaptureOptions } from "#types";
+export declare class Posts {
+    #private;
+    constructor(transport: Transport, media: MediaLibrary);
+    resolve(url: string, options?: CaptureOptions): Promise<Publication>;
+}

package/dist/resources/posts.js

@@ -0,0 +1,14 @@
+import { Publication } from "#resources/publication";
+export class Posts {
+    #transport;
+    #media;
+    constructor(transport, media) {
+        this.#transport = transport;
+        this.#media = media;
+    }
+    async resolve(url, options = {}) {
+        const data = await this.#transport.request("POST", "/v1/captures", options.refresh ? { url, refresh: true } : { url }, options);
+        return new Publication(data, this.#media);
+    }
+}
+//# sourceMappingURL=posts.js.map

package/dist/resources/posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.js","sourceRoot":"","sources":["../../src/resources/posts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,MAAM,OAAO,KAAK;IACP,UAAU,CAAY;IACtB,MAAM,CAAe;IAE9B,YAAY,SAAoB,EAAE,KAAmB;QACnD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,OAAO,GAAmB,EAAE;QACrD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CACxC,MAAM,EACN,cAAc,EACd,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAClD,OAAO,CACR,CAAC;QAEF,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/resources/publication.d.ts

@@ -0,0 +1,20 @@
+import { MediaItem } from "#resources/item";
+import type { MediaLibrary } from "#resources/media";
+import type { Capture } from "#types";
+export declare class Publication implements Capture {
+    #private;
+    readonly items: readonly MediaItem[];
+    readonly images: readonly MediaItem[];
+    readonly videos: readonly MediaItem[];
+    readonly audio: MediaItem | null;
+    constructor(data: Capture, media: MediaLibrary);
+    get id(): string;
+    get platform(): "instagram" | "tiktok";
+    get caption(): string;
+    get author(): {
+        readonly username: string;
+        readonly name: string;
+    };
+    get video(): MediaItem | undefined;
+    toJSON(): Capture;
+}

package/dist/resources/publication.js

@@ -0,0 +1,45 @@
+import { MediaItem } from "#resources/item";
+export class Publication {
+    #data;
+    items;
+    images;
+    videos;
+    audio;
+    constructor(data, media) {
+        this.#data = Object.freeze({
+            ...data,
+            author: Object.freeze({ ...data.author }),
+        });
+        this.items = Object.freeze(data.items.map((item) => new MediaItem(item, media)));
+        this.images = Object.freeze(this.items.filter((item) => item.kind === "image"));
+        this.videos = Object.freeze(this.items.filter((item) => item.kind === "video"));
+        this.audio = data.audio ? new MediaItem(data.audio, media) : null;
+        Object.freeze(this);
+    }
+    get id() {
+        return this.#data.id;
+    }
+    get platform() {
+        return this.#data.platform;
+    }
+    get caption() {
+        return this.#data.caption;
+    }
+    get author() {
+        return this.#data.author;
+    }
+    get video() {
+        return this.videos[0];
+    }
+    toJSON() {
+        return {
+            id: this.id,
+            platform: this.platform,
+            caption: this.caption,
+            author: this.author,
+            items: this.items.map((item) => item.toJSON()),
+            audio: this.audio?.toJSON() ?? null,
+        };
+    }
+}
+//# sourceMappingURL=publication.js.map

package/dist/resources/publication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication.js","sourceRoot":"","sources":["../../src/resources/publication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,WAAW;IACb,KAAK,CAAU;IACf,KAAK,CAAuB;IAC5B,MAAM,CAAuB;IAC7B,MAAM,CAAuB;IAC7B,KAAK,CAAmB;IAEjC,YAAY,IAAa,EAAE,KAAmB;QAC5C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,GAAG,IAAI;YACP,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;SAC1C,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI;SACpC,CAAC;IACJ,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,4 @@
+export type { Media } from "#models/media";
+export type { Capture } from "#models/post";
+export type { Scope, Credential, CredentialInput, CreatedCredential, } from "#models/access";
+export type { RequestOptions, MeowGalleryOptions, CaptureOptions, DeliveryOptions, } from "#models/options";

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@luanxdd/meowgallery",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.0",
+  "description": "Uma interface simples para capturar e entregar mídias com MeowGallery.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "imports": {
+    "#types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    "#error": {
+      "types": "./dist/error.d.ts",
+      "default": "./dist/error.js"
+    },
+    "#client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "#*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "@types/node": "^24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}