@luanxdd/meowgallery 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,113 @@
-# Temporary Holding Version
+# MeowGallery SDK
 
-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.
+TypeScript 7.0.2, ESM, Node.js 22+ e navegadores modernos com Fetch e AbortSignal. Sem dependências de produção.
+
+## Instalar
+
+O pacote ainda não foi publicado. Instale o arquivo incluído nesta entrega:
+
+```bash
+npm install ./meowgallery-sdk-0.2.0.tgz
+```
+
+## Obter uma publicação
+
+```typescript
+import { MeowGallery } from "@meowgallery/sdk";
+
+const gallery = new MeowGallery({
+  baseUrl: "https://gallery.seudominio.com",
+  token: process.env.MEOWGALLERY_KEY!,
+});
+
+const post = await gallery.capture("https://www.instagram.com/p/CODIGO_REAL/");
+
+console.log(post.author.name);
+console.log(post.caption);
+
+for (const item of post.items) {
+  console.log(item.kind, item.width, item.height, item.delivery.expiresAt);
+}
+```
+
+`items` preserva a ordem do carrossel. `audio` contém a faixa de posts de fotos do TikTok quando disponível. Cada mídia tem um link próprio. URLs de origem e cookies não são retornados.
+
+## Baixar no consumidor Node
+
+```typescript
+import { saveMedia } from "@meowgallery/sdk/node";
+
+const item = post.items[0];
+
+if (item) {
+  await saveMedia(gallery, item, "./publicacao.bin");
+}
+```
+
+A gravação acontece no consumidor. A API apenas repassa o stream. O helper limita bytes, remove arquivos parciais e não sobrescreve arquivos existentes. Escolha a extensão conforme o tipo real da mídia; `.bin` não altera o conteúdo.
+
+Para encaminhar ao seu framework sem salvar:
+
+```typescript
+const response = await gallery.download(post.items[0]!);
+const stream = response.body;
+```
+
+Consuma ou cancele o stream. Um intervalo pode ser solicitado com `gallery.download(item, { range: "bytes=0-1023" })`. A chave da API não é enviada no download: o próprio link é uma credencial temporária.
+
+## Fotos e áudio
+
+Carrosséis preservam a ordem em `post.items`. Quando disponível, `post.audio`
+contém a faixa separada, com seu próprio link temporário.
+
+```typescript
+if (post.audio) {
+  await saveMedia(gallery, post.audio, "./audio.m4a");
+}
+```
+
+Confira `mimeType` para escolher a extensão. A SDK não converte fotos em vídeo
+e não depende de FFmpeg. Na versão 0.2.0 foram removidos `createMotion`,
+`MotionOptions` e o campo `composition`.
+
+## OAuth
+
+```typescript
+const gallery = new MeowGallery({
+  baseUrl: "https://gallery.seudominio.com",
+  token: async () => auth.getAccessToken(),
+});
+```
+
+`auth` representa o SDK do seu provedor de identidade, responsável por login, PKCE e renovação. A função é chamada antes de cada operação autenticada. Não coloque chaves de bot ou Owner no código público do site.
+
+## Cancelamento e erros
+
+```typescript
+import { MeowGalleryError } from "@meowgallery/sdk";
+
+try {
+  const post = await gallery.capture(url, {
+    signal: AbortSignal.timeout(30_000),
+  });
+} catch (error) {
+  if (error instanceof MeowGalleryError) {
+    console.error(error.code, error.message, error.requestId);
+  } else {
+    throw error;
+  }
+}
+```
+
+O erro contém `code`, `status`, `requestId` e `retryAfter`. POSTs não são repetidos automaticamente, para não duplicar emissões de links e consumo de cota. Ao expirar, solicite a publicação novamente. Se a origem expirar antes do link, use `gallery.capture(url, { refresh: true })` para ignorar o cache.
+
+## Desenvolvimento
+
+```bash
+npm ci
+npm run check
+npm test
+npm pack
+```
+
+Os aliases internos estão declarados em `package.json#imports`; o consumidor não precisa configurar `tsconfig.paths`. A entrada `/node` não deve entrar em bundles de navegador.

package/dist/client.d.ts

@@ -0,0 +1,14 @@
+import type { Capture, CreatedCredential, Credential, CredentialInput, Media, MeowGalleryOptions, RequestOptions } from "#types";
+export declare class MeowGallery {
+    #private;
+    constructor(options: MeowGalleryOptions);
+    capture(url: string, options?: RequestOptions & {
+        readonly refresh?: boolean;
+    }): Promise<Capture>;
+    createCredential(input: CredentialInput, options?: RequestOptions): Promise<CreatedCredential>;
+    listCredentials(options?: RequestOptions): Promise<Credential[]>;
+    revokeCredential(id: string, options?: RequestOptions): Promise<void>;
+    download(media: Media, options?: RequestOptions & {
+        readonly range?: string;
+    }): Promise<Response>;
+}

package/dist/client.js

@@ -0,0 +1,181 @@
+import { MeowGalleryError } from "#error";
+export class MeowGallery {
+    #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.");
+        }
+    }
+    capture(url, options = {}) {
+        return this.#request("POST", "/v1/captures", options.refresh ? { url, refresh: true } : { url }, options);
+    }
+    createCredential(input, options = {}) {
+        return this.#request("POST", "/v1/credentials", input, options);
+    }
+    listCredentials(options = {}) {
+        return this.#request("GET", "/v1/credentials", undefined, options);
+    }
+    revokeCredential(id, options = {}) {
+        if (!/^[0-9a-f-]{36}$/i.test(id)) {
+            throw new TypeError("Identificador de credencial inválido.");
+        }
+        return this.#request("DELETE", `/v1/credentials/${id}`, undefined, options);
+    }
+    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=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/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,3 @@
+export { MeowGallery } from "#client";
+export { MeowGalleryError } from "#error";
+export type { Capture, CreatedCredential, Credential, CredentialInput, Media, MeowGalleryOptions, RequestOptions, Scope, } from "#types";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { MeowGallery } from "#client";
+export { MeowGalleryError } from "#error";
+//# 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"}

package/dist/node.d.ts

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

package/dist/node.js

@@ -0,0 +1,37 @@
+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";
+export async function saveMedia(client, media, destination, options = {}) {
+    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 = await client.download(media, 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=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,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;AAShD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAmB,EACnB,KAAY,EACZ,WAAmB,EACnB,OAAO,GAAgB,EAAE;IAEzB,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,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvD,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/types.d.ts

@@ -0,0 +1,56 @@
+export type Scope = "captures:read" | "delivery:read" | "sources:authenticated";
+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;
+    };
+}
+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;
+}
+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;
+}
+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;
+}

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,51 @@
 {
   "name": "@luanxdd/meowgallery",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.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"
+    }
+  },
+  "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": {
+    "@types/node": "^24.0.0",
+    "typescript": "7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}