@tagadapay/node-sdk 0.1.0 → 0.2.1

package/dist/resources/Plugins.d.ts

@@ -1,14 +1,42 @@
 import { BaseResource } from './BaseResource.js';
 import type { RequestOptions } from '../types/common.js';
-import type { PluginDeployParams, PluginDeployResult, PluginInstantiateParams, PluginInstantiateResult, PluginMountParams, PluginMountResult, PluginUnmountParams } from '../types/plugins.js';
+import type { PluginDeployParams, PluginDeployResult, PluginInstantiateParams, PluginInstantiateResult, PluginMountParams, PluginMountResult, PluginUnmountParams, PluginInstance, PluginInstanceListResult, PluginDeploymentDetails, PluginListResult, PluginMountPointListResult, PluginDetails, DeployDirectoryParams, DeployDirectoryResult, ConfigureSplitParams, ConfigureSplitResult } from '../types/plugins.js';
 /**
  * Plugins V2 — deploy HTML/JS/CSS pages, instantiate them for stores,
  * and mount them to custom domains or aliases.
- *
- * This is the mechanism Tagada uses to serve checkout pages, landing pages,
- * upsell pages, and any custom storefront on your own domains.
  */
 export declare class Plugins extends BaseResource {
+    /**
+     * Deploy a local build directory to TagadaPay's CDN in one call.
+     *
+     * Handles everything automatically: file collection, MIME type detection,
+     * base64 encoding, instantiation, and mounting to a CDN hostname.
+     * Builds up to ~3.5 MB are uploaded inline; larger builds are automatically
+     * zipped and uploaded via Vercel Blob (up to 50 MB).
+     *
+     * @example
+     * ```ts
+     * const result = await tagada.plugins.deployDirectory({
+     *   directory: './dist',
+     *   storeId: 'store_xxx',
+     *   name: 'my-store',
+     * });
+     * console.log(result.url); // https://my-store--store_xxx.cdn.tagadapay.com/
+     * ```
+     */
+    deployDirectory(params: DeployDirectoryParams, opts?: RequestOptions): Promise<DeployDirectoryResult>;
+    /**
+     * Create a ZIP archive from raw file buffers using only Node.js built-ins.
+     * Uses the STORE method (no compression) for speed — the files are already
+     * minified JS/CSS/images, so deflate savings are minimal.
+     */
+    private _createZipBuffer;
+    /**
+     * Upload a ZIP buffer to Vercel Blob using the two-step client upload protocol.
+     * Step 1: POST to generate-upload-token to get a signed clientToken.
+     * Step 2: PUT the ZIP to the Vercel Blob API with that token.
+     */
+    private _uploadZipToBlob;
     /**
      * Deploy a plugin with inline assets (HTML, JS, CSS as base64) or
      * from a ZIP URL. Returns a deploymentId used for instantiation and mounting.
@@ -16,38 +44,68 @@ export declare class Plugins extends BaseResource {
     deploy(params: PluginDeployParams, opts?: RequestOptions): Promise<PluginDeployResult>;
     /**
      * Create an instance of a deployed plugin for a specific store.
-     * Instances allow per-store configuration of the same deployment.
      */
     instantiate(params: PluginInstantiateParams, opts?: RequestOptions): Promise<PluginInstantiateResult>;
+    /**
+     * List all instances for a store.
+     * Optionally filter by deploymentId.
+     */
+    listInstances(storeId: string, deploymentId?: string, opts?: RequestOptions): Promise<PluginInstanceListResult>;
+    /**
+     * Retrieve a single instance by ID.
+     */
+    retrieveInstance(instanceId: string, opts?: RequestOptions): Promise<PluginInstance>;
+    /**
+     * Retrieve deployment details (version, pages, instances).
+     * Does not require storeId — deployments are global.
+     */
+    retrieveDeployment(deploymentId: string, opts?: RequestOptions): Promise<PluginDeploymentDetails>;
     /**
      * Mount a plugin deployment/instance to a custom domain or alias.
-     * The domain must be verified in your account's custom domains.
      */
     mount(params: PluginMountParams, opts?: RequestOptions): Promise<PluginMountResult>;
     /**
      * Unmount a plugin from a domain or alias.
      */
-    unmount(params: PluginUnmountParams, opts?: RequestOptions): Promise<unknown>;
+    unmount(params: PluginUnmountParams, opts?: RequestOptions): Promise<{
+        success: boolean;
+        message: string;
+    }>;
     /**
-     * List all plugins for a store.
+     * Configure A/B split testing on an existing route.
+     *
+     * @example Weighted 50/50 split
+     * ```ts
+     * await tagada.plugins.configureSplit({
+     *   routeId: 'route_xxx',
+     *   storeId: 'store_xxx',
+     *   splitConfig: {
+     *     type: 'weighted',
+     *     instances: [
+     *       { instanceId: 'inst_a', deploymentId: 'dep_a', weight: 50 },
+     *       { instanceId: 'inst_b', deploymentId: 'dep_b', weight: 50 },
+     *     ],
+     *   },
+     * });
+     * ```
      */
-    list(storeId: string, opts?: RequestOptions): Promise<unknown>;
+    configureSplit(params: ConfigureSplitParams, opts?: RequestOptions): Promise<ConfigureSplitResult>;
     /**
-     * List all instances for a store.
+     * List all plugins for a store.
      */
-    listInstances(storeId: string, opts?: RequestOptions): Promise<unknown>;
+    list(storeId: string, opts?: RequestOptions): Promise<PluginListResult>;
     /**
      * List mount points for a store.
      */
-    listMountPoints(storeId: string, opts?: RequestOptions): Promise<unknown>;
+    listMountPoints(storeId: string, opts?: RequestOptions): Promise<PluginMountPointListResult>;
     /**
-     * Get detailed info about a specific deployment.
+     * Get detailed info about a plugin.
      */
-    deploymentDetails(deploymentId: string, storeId: string, opts?: RequestOptions): Promise<unknown>;
+    details(pluginId: string, storeId: string, opts?: RequestOptions): Promise<PluginDetails>;
     /**
-     * Get detailed info about a plugin.
+     * @deprecated Use retrieveDeployment() instead — it doesn't require storeId.
      */
-    details(pluginId: string, storeId: string, opts?: RequestOptions): Promise<unknown>;
+    deploymentDetails(deploymentId: string, storeId: string, opts?: RequestOptions): Promise<PluginDeploymentDetails>;
     /**
      * Delete a plugin and all its deployments.
      */

package/dist/resources/Plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Plugins.d.ts","sourceRoot":"","sources":["../../src/resources/Plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IACvC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI5F;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,uBAAuB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAI3G;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzF;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAInF;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7E;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/E;;OAEG;IACG,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvG;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzF;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrF;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;CAGvG"}
+{"version":3,"file":"Plugins.d.ts","sourceRoot":"","sources":["../../src/resources/Plugins.ts"],"names":[],"mappings":"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"}

package/dist/resources/Plugins.js

@@ -1,12 +1,260 @@
 import { BaseResource } from './BaseResource.js';
+const CONTENT_TYPES = {
+    '.html': 'text/html',
+    '.js': 'application/javascript',
+    '.mjs': 'application/javascript',
+    '.css': 'text/css',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.ico': 'image/x-icon',
+    '.json': 'application/json',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.eot': 'application/vnd.ms-fontobject',
+    '.map': 'application/json',
+    '.txt': 'text/plain',
+    '.xml': 'application/xml',
+    '.webmanifest': 'application/manifest+json',
+};
+const INLINE_SIZE_LIMIT = 3.5 * 1024 * 1024; // 3.5 MB raw — base64 expands ~33%
+const VERCEL_BLOB_API = 'https://vercel.com/api/blob';
+const CRC_TABLE = new Uint32Array(256);
+for (let i = 0; i < 256; i++) {
+    let c = i;
+    for (let j = 0; j < 8; j++)
+        c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+    CRC_TABLE[i] = c;
+}
+function crc32(buf) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < buf.length; i++)
+        crc = CRC_TABLE[(crc ^ buf[i]) & 0xff] ^ (crc >>> 8);
+    return (crc ^ 0xffffffff) >>> 0;
+}
 /**
  * Plugins V2 — deploy HTML/JS/CSS pages, instantiate them for stores,
  * and mount them to custom domains or aliases.
- *
- * This is the mechanism Tagada uses to serve checkout pages, landing pages,
- * upsell pages, and any custom storefront on your own domains.
  */
 export class Plugins extends BaseResource {
+    // ─── High-Level Helpers ─────────────────────────────────────────────
+    /**
+     * Deploy a local build directory to TagadaPay's CDN in one call.
+     *
+     * Handles everything automatically: file collection, MIME type detection,
+     * base64 encoding, instantiation, and mounting to a CDN hostname.
+     * Builds up to ~3.5 MB are uploaded inline; larger builds are automatically
+     * zipped and uploaded via Vercel Blob (up to 50 MB).
+     *
+     * @example
+     * ```ts
+     * const result = await tagada.plugins.deployDirectory({
+     *   directory: './dist',
+     *   storeId: 'store_xxx',
+     *   name: 'my-store',
+     * });
+     * console.log(result.url); // https://my-store--store_xxx.cdn.tagadapay.com/
+     * ```
+     */
+    async deployDirectory(params, opts) {
+        const { directory, storeId, name, version = '1.0.0', overwrite = true } = params;
+        const { readFileSync, readdirSync, statSync } = await import('fs');
+        const { join, relative, extname, resolve } = await import('path');
+        const collectRawFiles = (dir, base) => {
+            const files = [];
+            for (const entry of readdirSync(dir)) {
+                const full = join(dir, entry);
+                if (statSync(full).isDirectory()) {
+                    files.push(...collectRawFiles(full, base));
+                }
+                else {
+                    const ext = extname(full).toLowerCase();
+                    files.push({
+                        relPath: '/' + relative(base, full).replace(/\\/g, '/'),
+                        content: readFileSync(full),
+                        contentType: CONTENT_TYPES[ext] || 'application/octet-stream',
+                    });
+                }
+            }
+            return files;
+        };
+        const absDir = resolve(directory);
+        const rawFiles = collectRawFiles(absDir, absDir);
+        const totalSize = rawFiles.reduce((sum, f) => sum + f.content.length, 0);
+        const deployOpts = { timeout: 180000, ...opts };
+        let deployResult;
+        if (totalSize <= INLINE_SIZE_LIMIT) {
+            const inlineAssets = rawFiles.map(f => ({
+                path: f.relPath,
+                content: f.content.toString('base64'),
+                contentType: f.contentType,
+            }));
+            deployResult = await this.deploy({
+                storeId,
+                manifest: { name, version, pages: [{ id: 'main', path: '/', name: 'Store' }] },
+                inlineAssets,
+                overwrite,
+            }, deployOpts);
+        }
+        else {
+            const zipBuffer = await this._createZipBuffer(rawFiles);
+            const blobUrl = await this._uploadZipToBlob(zipBuffer, name);
+            deployResult = await this.deploy({
+                storeId,
+                manifest: { name, version, pages: [{ id: 'main', path: '/', name: 'Store' }] },
+                zipUrl: blobUrl,
+                overwrite,
+            }, deployOpts);
+        }
+        const instanceResult = await this.instantiate({
+            deploymentId: deployResult.deploymentId,
+            storeId,
+            config: {},
+        }, opts);
+        const hostname = params.hostname || `${name}--${storeId}.cdn.tagadapay.com`;
+        await this.mount({
+            deploymentId: deployResult.deploymentId,
+            deploymentInstanceId: instanceResult.instanceId,
+            storeId,
+            hostname,
+            basePath: '/',
+            matcher: '/',
+        }, opts);
+        return {
+            pluginId: deployResult.pluginId,
+            deploymentId: deployResult.deploymentId,
+            instanceId: instanceResult.instanceId,
+            version: deployResult.version,
+            hostname,
+            url: `https://${hostname}/`,
+            uploadedFiles: deployResult.uploadedFiles,
+        };
+    }
+    // ─── Private: ZIP + Blob Upload ────────────────────────────────────
+    /**
+     * Create a ZIP archive from raw file buffers using only Node.js built-ins.
+     * Uses the STORE method (no compression) for speed — the files are already
+     * minified JS/CSS/images, so deflate savings are minimal.
+     */
+    async _createZipBuffer(files) {
+        const entries = [];
+        const parts = [];
+        let offset = 0;
+        for (const file of files) {
+            const pathStr = file.relPath.startsWith('/') ? file.relPath.slice(1) : file.relPath;
+            const nameBytes = Buffer.from(pathStr, 'utf-8');
+            const content = file.content;
+            const checksum = crc32(content);
+            const localHeader = Buffer.alloc(30 + nameBytes.length);
+            localHeader.writeUInt32LE(0x04034b50, 0); // local file header signature
+            localHeader.writeUInt16LE(20, 4); // version needed to extract (2.0)
+            localHeader.writeUInt16LE(0, 6); // general purpose bit flag
+            localHeader.writeUInt16LE(0, 8); // compression method: stored
+            localHeader.writeUInt16LE(0, 10); // last mod file time
+            localHeader.writeUInt16LE(0, 12); // last mod file date
+            localHeader.writeUInt32LE(checksum, 14); // crc-32
+            localHeader.writeUInt32LE(content.length, 18); // compressed size
+            localHeader.writeUInt32LE(content.length, 22); // uncompressed size
+            localHeader.writeUInt16LE(nameBytes.length, 26); // file name length
+            localHeader.writeUInt16LE(0, 28); // extra field length
+            nameBytes.copy(localHeader, 30);
+            entries.push({ name: nameBytes, content, crc: checksum, localHeaderOffset: offset });
+            parts.push(localHeader, content);
+            offset += localHeader.length + content.length;
+        }
+        const centralDirOffset = offset;
+        for (const entry of entries) {
+            const cdHeader = Buffer.alloc(46 + entry.name.length);
+            cdHeader.writeUInt32LE(0x02014b50, 0); // central directory file header signature
+            cdHeader.writeUInt16LE(20, 4); // version made by
+            cdHeader.writeUInt16LE(20, 6); // version needed to extract
+            cdHeader.writeUInt16LE(0, 8); // general purpose bit flag
+            cdHeader.writeUInt16LE(0, 10); // compression method: stored
+            cdHeader.writeUInt16LE(0, 12); // last mod file time
+            cdHeader.writeUInt16LE(0, 14); // last mod file date
+            cdHeader.writeUInt32LE(entry.crc, 16); // crc-32
+            cdHeader.writeUInt32LE(entry.content.length, 20); // compressed size
+            cdHeader.writeUInt32LE(entry.content.length, 24); // uncompressed size
+            cdHeader.writeUInt16LE(entry.name.length, 28); // file name length
+            cdHeader.writeUInt16LE(0, 30); // extra field length
+            cdHeader.writeUInt16LE(0, 32); // file comment length
+            cdHeader.writeUInt16LE(0, 34); // disk number start
+            cdHeader.writeUInt16LE(0, 36); // internal file attributes
+            cdHeader.writeUInt32LE(0, 38); // external file attributes
+            cdHeader.writeUInt32LE(entry.localHeaderOffset, 42); // relative offset of local header
+            entry.name.copy(cdHeader, 46);
+            parts.push(cdHeader);
+            offset += cdHeader.length;
+        }
+        const centralDirSize = offset - centralDirOffset;
+        const eocd = Buffer.alloc(22);
+        eocd.writeUInt32LE(0x06054b50, 0); // end of central directory signature
+        eocd.writeUInt16LE(0, 4); // disk number
+        eocd.writeUInt16LE(0, 6); // disk with central dir
+        eocd.writeUInt16LE(entries.length, 8); // entries on this disk
+        eocd.writeUInt16LE(entries.length, 10); // total entries
+        eocd.writeUInt32LE(centralDirSize, 12); // size of central directory
+        eocd.writeUInt32LE(centralDirOffset, 16); // offset of central directory
+        eocd.writeUInt16LE(0, 20); // comment length
+        parts.push(eocd);
+        return Buffer.concat(parts);
+    }
+    /**
+     * Upload a ZIP buffer to Vercel Blob using the two-step client upload protocol.
+     * Step 1: POST to generate-upload-token to get a signed clientToken.
+     * Step 2: PUT the ZIP to the Vercel Blob API with that token.
+     */
+    async _uploadZipToBlob(zipBuffer, pluginName) {
+        const apiKey = this.client.apiKey;
+        const baseUrl = this.client.baseUrl;
+        const filename = `${pluginName}-${Date.now()}.zip`;
+        const tokenUrl = `${baseUrl}/plugins/generate-upload-token`;
+        const tokenRes = await fetch(tokenUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                type: 'blob.generate-client-token',
+                payload: {
+                    pathname: filename,
+                    clientPayload: JSON.stringify({ apiKey, pluginId: pluginName }),
+                    multipart: false,
+                },
+            }),
+        });
+        if (!tokenRes.ok) {
+            const errText = await tokenRes.text().catch(() => '');
+            throw new Error(`Failed to get upload token (HTTP ${tokenRes.status}): ${errText}`);
+        }
+        const { clientToken } = (await tokenRes.json());
+        if (!clientToken?.startsWith('vercel_blob_client_')) {
+            throw new Error('Invalid upload token received from server');
+        }
+        const params = new URLSearchParams({ pathname: filename });
+        const putRes = await fetch(`${VERCEL_BLOB_API}?${params.toString()}`, {
+            method: 'PUT',
+            headers: {
+                authorization: `Bearer ${clientToken}`,
+                'x-vercel-blob-access': 'public',
+                'x-content-type': 'application/zip',
+                'x-api-version': '12',
+            },
+            body: zipBuffer,
+        });
+        if (!putRes.ok) {
+            const errBody = await putRes.text().catch(() => '');
+            throw new Error(`Blob upload failed (HTTP ${putRes.status}): ${errBody}`);
+        }
+        const blob = (await putRes.json());
+        if (!blob.url) {
+            throw new Error('Blob upload succeeded but no URL returned');
+        }
+        return blob.url;
+    }
+    // ─── Deploy ──────────────────────────────────────────────────────────
     /**
      * Deploy a plugin with inline assets (HTML, JS, CSS as base64) or
      * from a ZIP URL. Returns a deploymentId used for instantiation and mounting.
@@ -14,16 +262,37 @@ export class Plugins extends BaseResource {
     async deploy(params, opts) {
         return this._post('/plugins/v2/deploy', params, opts);
     }
+    // ─── Instances ───────────────────────────────────────────────────────
     /**
      * Create an instance of a deployed plugin for a specific store.
-     * Instances allow per-store configuration of the same deployment.
      */
     async instantiate(params, opts) {
         return this._post('/plugins/v2/instantiate', params, opts);
     }
+    /**
+     * List all instances for a store.
+     * Optionally filter by deploymentId.
+     */
+    async listInstances(storeId, deploymentId, opts) {
+        return this._get(`/plugins/v2/instances/${encodeURIComponent(storeId)}`, deploymentId ? { deploymentId } : undefined, opts);
+    }
+    /**
+     * Retrieve a single instance by ID.
+     */
+    async retrieveInstance(instanceId, opts) {
+        return this._get(`/plugins/v2/instances/detail/${encodeURIComponent(instanceId)}`, undefined, opts);
+    }
+    // ─── Deployments ─────────────────────────────────────────────────────
+    /**
+     * Retrieve deployment details (version, pages, instances).
+     * Does not require storeId — deployments are global.
+     */
+    async retrieveDeployment(deploymentId, opts) {
+        return this._get(`/plugins/v2/deployments/${encodeURIComponent(deploymentId)}`, undefined, opts);
+    }
+    // ─── Mounting ────────────────────────────────────────────────────────
     /**
      * Mount a plugin deployment/instance to a custom domain or alias.
-     * The domain must be verified in your account's custom domains.
      */
     async mount(params, opts) {
         return this._post('/plugins/v2/mount', params, opts);
@@ -35,35 +304,53 @@ export class Plugins extends BaseResource {
         return this._post('/plugins/v2/unmount', params, opts);
     }
     /**
-     * List all plugins for a store.
+     * Configure A/B split testing on an existing route.
+     *
+     * @example Weighted 50/50 split
+     * ```ts
+     * await tagada.plugins.configureSplit({
+     *   routeId: 'route_xxx',
+     *   storeId: 'store_xxx',
+     *   splitConfig: {
+     *     type: 'weighted',
+     *     instances: [
+     *       { instanceId: 'inst_a', deploymentId: 'dep_a', weight: 50 },
+     *       { instanceId: 'inst_b', deploymentId: 'dep_b', weight: 50 },
+     *     ],
+     *   },
+     * });
+     * ```
      */
-    async list(storeId, opts) {
-        return this._post('/plugins/v2/list', { storeId }, opts);
+    async configureSplit(params, opts) {
+        return this._post('/plugins/v2/split', params, opts);
     }
+    // ─── Listing ─────────────────────────────────────────────────────────
     /**
-     * List all instances for a store.
+     * List all plugins for a store.
      */
-    async listInstances(storeId, opts) {
-        return this._post('/plugins/v2/instances', { storeId }, opts);
+    async list(storeId, opts) {
+        return this._get(`/plugins/v2/list/${encodeURIComponent(storeId)}`, undefined, opts);
     }
     /**
      * List mount points for a store.
      */
     async listMountPoints(storeId, opts) {
-        return this._post('/plugins/v2/mount-points', { storeId }, opts);
+        return this._get(`/plugins/v2/mount-points/${encodeURIComponent(storeId)}`, undefined, opts);
     }
+    // ─── Details ─────────────────────────────────────────────────────────
     /**
-     * Get detailed info about a specific deployment.
+     * Get detailed info about a plugin.
      */
-    async deploymentDetails(deploymentId, storeId, opts) {
-        return this._post('/plugins/v2/deployment/details', { deploymentId, storeId }, opts);
+    async details(pluginId, storeId, opts) {
+        return this._get(`/plugins/v2/details/${encodeURIComponent(pluginId)}`, { storeId }, opts);
     }
     /**
-     * Get detailed info about a plugin.
+     * @deprecated Use retrieveDeployment() instead — it doesn't require storeId.
      */
-    async details(pluginId, storeId, opts) {
-        return this._post('/plugins/v2/details', { pluginId, storeId }, opts);
+    async deploymentDetails(deploymentId, storeId, opts) {
+        return this._post('/plugins/v2/deployment/details', { deploymentId, storeId }, opts);
     }
+    // ─── Management ──────────────────────────────────────────────────────
     /**
      * Delete a plugin and all its deployments.
      */

package/dist/resources/Plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plugins.js","sourceRoot":"","sources":["../../src/resources/Plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYjD;;;;;;GAMG;AACH,MAAM,OAAO,OAAQ,SAAQ,YAAY;IACvC;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,MAA0B,EAAE,IAAqB;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAqB,oBAAoB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,MAA+B,EAAE,IAAqB;QACtE,OAAO,IAAI,CAAC,KAAK,CAA0B,yBAAyB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACtF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,MAAyB,EAAE,IAAqB;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAoB,mBAAmB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAA2B,EAAE,IAAqB;QAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,IAAqB;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,IAAqB;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,IAAqB;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,YAAoB,EAAE,OAAe,EAAE,IAAqB;QAClF,OAAO,IAAI,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe,EAAE,IAAqB;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAE,IAAqB;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,YAAoB,EAAE,OAAe,EAAE,IAAqB;QACjF,OAAO,IAAI,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACtF,CAAC;CACF"}
+{"version":3,"file":"Plugins.js","sourceRoot":"","sources":["../../src/resources/Plugins.ts"],"names":[],"mappings":"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"}

package/dist/resources/Processors.d.ts

@@ -1,6 +1,6 @@
 import { BaseResource } from './BaseResource.js';
 import type { RequestOptions } from '../types/common.js';
-import type { Processor, ProcessorCreateParams, ProcessorUpdateParams } from '../types/processors.js';
+import type { Processor, ProcessorCreateParams, ProcessorUpdateParams, StripeConnectInitiateParams, StripeConnectInitiateResponse, StripeConnectDisconnectParams, StripeAccountDetails } from '../types/processors.js';
 /**
  * Processors represent the payment gateways/PSPs connected to your Tagada
  * account. Tagada is gateway-agnostic: you can connect Stripe, Adyen, NMI,
@@ -50,5 +50,43 @@ export declare class Processors extends BaseResource {
     del(processorIds: string[], opts?: RequestOptions): Promise<{
         processors: string[];
     }>;
+    /**
+     * Initiate a Stripe Connect OAuth flow. Returns a URL that the merchant
+     * must visit in their browser to authorize TagadaPay to use their Stripe
+     * account.
+     *
+     * After the merchant completes the OAuth flow, Stripe redirects back to
+     * TagadaPay, which saves the connected account credentials on the
+     * processor automatically.
+     *
+     * @example
+     * const { url } = await tagada.processors.initiateStripeConnect({
+     *   processorId: 'processor_abc123',
+     * });
+     * // Redirect the merchant to `url` in their browser
+     */
+    initiateStripeConnect(params: StripeConnectInitiateParams, opts?: RequestOptions): Promise<StripeConnectInitiateResponse>;
+    /**
+     * Disconnect a Stripe Connect account from a processor.
+     * Revokes the OAuth authorization and disables the processor.
+     *
+     * @example
+     * await tagada.processors.disconnectStripe({
+     *   accountId: 'acct_1234567890',
+     *   processorId: 'processor_abc123',
+     * });
+     */
+    disconnectStripe(params: StripeConnectDisconnectParams, opts?: RequestOptions): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Retrieve details about a connected Stripe account (capabilities,
+     * charges enabled, country, etc.).
+     *
+     * @example
+     * const details = await tagada.processors.getStripeAccountDetails('acct_1234567890');
+     * console.log(details.charges_enabled, details.country);
+     */
+    getStripeAccountDetails(accountId: string, opts?: RequestOptions): Promise<StripeAccountDetails>;
 }
 //# sourceMappingURL=Processors.d.ts.map

package/dist/resources/Processors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Processors.d.ts","sourceRoot":"","sources":["../../src/resources/Processors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEtG;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C;;OAEG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAIvE;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9E;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;IAIrG;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;IAIrG;;OAEG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAG5F"}
+{"version":3,"file":"Processors.d.ts","sourceRoot":"","sources":["../../src/resources/Processors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C;;OAEG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAIvE;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9E;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;IAIrG;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;IAIrG;;OAEG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAM3F;;;;;;;;;;;;;;OAcG;IACG,qBAAqB,CACzB,MAAM,EAAE,2BAA2B,EACnC,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,6BAA6B,CAAC;IAQzC;;;;;;;;;OASG;IACG,gBAAgB,CACpB,MAAM,EAAE,6BAA6B,EACrC,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAQhC;;;;;;;OAOG;IACG,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,oBAAoB,CAAC;CAOjC"}

package/dist/resources/Processors.js

@@ -50,5 +50,48 @@ export class Processors extends BaseResource {
     async del(processorIds, opts) {
         return this._post('/processors/delete', { processorIds }, opts);
     }
+    // ── Stripe Connect ───────────────────────────────────────────────────
+    /**
+     * Initiate a Stripe Connect OAuth flow. Returns a URL that the merchant
+     * must visit in their browser to authorize TagadaPay to use their Stripe
+     * account.
+     *
+     * After the merchant completes the OAuth flow, Stripe redirects back to
+     * TagadaPay, which saves the connected account credentials on the
+     * processor automatically.
+     *
+     * @example
+     * const { url } = await tagada.processors.initiateStripeConnect({
+     *   processorId: 'processor_abc123',
+     * });
+     * // Redirect the merchant to `url` in their browser
+     */
+    async initiateStripeConnect(params, opts) {
+        return this._post('/processors/stripe-connect/initiate', params, opts);
+    }
+    /**
+     * Disconnect a Stripe Connect account from a processor.
+     * Revokes the OAuth authorization and disables the processor.
+     *
+     * @example
+     * await tagada.processors.disconnectStripe({
+     *   accountId: 'acct_1234567890',
+     *   processorId: 'processor_abc123',
+     * });
+     */
+    async disconnectStripe(params, opts) {
+        return this._post('/processors/stripe-connect/disconnect', params, opts);
+    }
+    /**
+     * Retrieve details about a connected Stripe account (capabilities,
+     * charges enabled, country, etc.).
+     *
+     * @example
+     * const details = await tagada.processors.getStripeAccountDetails('acct_1234567890');
+     * console.log(details.charges_enabled, details.country);
+     */
+    async getStripeAccountDetails(accountId, opts) {
+        return this._post('/processors/stripe-connect/account', { accountId }, opts);
+    }
 }
 //# sourceMappingURL=Processors.js.map