@pagci/node 0.1.0

package/dist/esm/types/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/types/token.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/esm/types/token.js

@@ -0,0 +1,4 @@
+// ── Token types ─────────────────────────────────────────────────────
+// Source: cmd/specgen/types.go (CreateAccessTokenRequest, CreateAPIKeyRequest, etc.)
+export {};
+//# sourceMappingURL=token.js.map

package/dist/esm/types/token.js.map

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

package/dist/esm/types/webhook.d.ts

@@ -0,0 +1,102 @@
+import type { Payment } from './payment.js';
+import type { Withdrawal } from './withdrawal.js';
+import type { Balance } from './balance.js';
+import type { ListMeta } from './common.js';
+export declare enum WebhookEventType {
+    PaymentConfirmed = "payment.confirmed",
+    PaymentFailed = "payment.failed",
+    PaymentCancelled = "payment.cancelled",
+    PaymentExpired = "payment.expired",
+    PaymentDispute = "payment.dispute",
+    WithdrawalSettled = "withdrawal.settled",
+    WithdrawalFailed = "withdrawal.failed",
+    RefundCompleted = "refund.completed"
+}
+export type WebhookEnvelope = {
+    event: string;
+    resource_type: 'payment';
+    data: Payment;
+    balances?: Record<string, Balance>;
+    account_balance?: Balance;
+} | {
+    event: string;
+    resource_type: 'withdrawal';
+    data: Withdrawal;
+    balances?: Record<string, Balance>;
+    account_balance?: Balance;
+} | {
+    event: string;
+    resource_type: 'refund';
+    data: unknown;
+    balances?: Record<string, Balance>;
+    account_balance?: Balance;
+};
+export interface WebhookEndpoint {
+    id: string;
+    url: string;
+    events: string[];
+    host: string;
+    host_status: string;
+}
+export interface WebhookEndpointsListResponse {
+    endpoints: WebhookEndpoint[];
+    valid_events: string[];
+}
+export interface WebhookEndpointInput {
+    url: string;
+    events: string[];
+}
+export interface RegisterWebhooksParams {
+    endpoints: WebhookEndpointInput[];
+}
+export interface WebhookDelivery {
+    id: string;
+    event: string;
+    resource_type: string;
+    resource_id: string;
+    status: string;
+    attempts: number;
+    /** ISO 8601 timestamp. */
+    created_at: string;
+    /** ISO 8601 timestamp. */
+    updated_at: string;
+}
+export interface WebhookDeliveryListResponse {
+    data: WebhookDelivery[];
+    meta: ListMeta;
+}
+export interface WebhookTestParams {
+    event: string;
+    resource_type: string;
+    resource_id: string;
+    /** Which endpoint to test. */
+    url: string;
+}
+export interface WebhookTestResponse {
+    event: string;
+    resource_type: string;
+    resource_id: string;
+    url: string;
+    payload_size_bytes: number;
+    status_code?: number;
+    latency_ms?: number;
+    response_body?: string;
+    error?: string;
+}
+export interface WebhookDeliveryListParams {
+    cursor?: string;
+    prev_cursor?: string;
+    page?: number;
+    per_page?: number;
+    sort?: string;
+    status?: string;
+    resource_type?: string;
+    target_status?: string;
+    event?: string;
+    /** Start date (ISO 8601). */
+    from?: string;
+    /** End date (ISO 8601). */
+    to?: string;
+    wallet_id?: string;
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/esm/types/webhook.d.ts.map

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

package/dist/esm/types/webhook.js

@@ -0,0 +1,15 @@
+// ── Webhook types ───────────────────────────────────────────────────
+// Source: cmd/specgen/types.go (WebhookEnvelope, WebhookEndpoint, etc.)
+// ── Webhook events ──────────────────────────────────────────────────
+export var WebhookEventType;
+(function (WebhookEventType) {
+    WebhookEventType["PaymentConfirmed"] = "payment.confirmed";
+    WebhookEventType["PaymentFailed"] = "payment.failed";
+    WebhookEventType["PaymentCancelled"] = "payment.cancelled";
+    WebhookEventType["PaymentExpired"] = "payment.expired";
+    WebhookEventType["PaymentDispute"] = "payment.dispute";
+    WebhookEventType["WithdrawalSettled"] = "withdrawal.settled";
+    WebhookEventType["WithdrawalFailed"] = "withdrawal.failed";
+    WebhookEventType["RefundCompleted"] = "refund.completed";
+})(WebhookEventType || (WebhookEventType = {}));
+//# sourceMappingURL=webhook.js.map

package/dist/esm/types/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/types/webhook.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wEAAwE;AAOxE,uEAAuE;AAEvE,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B,0DAAsC,CAAA;IACtC,oDAAgC,CAAA;IAChC,0DAAsC,CAAA;IACtC,sDAAkC,CAAA;IAClC,sDAAkC,CAAA;IAClC,4DAAwC,CAAA;IACxC,0DAAsC,CAAA;IACtC,wDAAoC,CAAA;AACtC,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B"}

package/dist/esm/types/withdrawal.d.ts

@@ -0,0 +1,89 @@
+/** Receiver bank information on a withdrawal. */
+export interface ReceiverBank {
+    name?: string;
+    code?: string;
+    ispb?: string;
+    account?: string;
+    logo_url?: string;
+}
+/** Receiver (who received the payout). */
+export interface Receiver {
+    name?: string;
+    /** Masked document. */
+    document?: string;
+    pix_key?: string;
+    bank?: ReceiverBank;
+}
+/** PSP liquidator for a withdrawal. */
+export interface WithdrawalLiquidator {
+    id: string;
+    name: string;
+    /** PIX end-to-end ID. */
+    e2e_id?: string;
+}
+/** Full withdrawal detail (GET /withdrawals/:id response). */
+export interface Withdrawal {
+    id: string;
+    wallet_id: string;
+    api_owner: string;
+    /** Originally requested amount in centavos (integer). */
+    requested_amount: number;
+    /** Final amount after fees in centavos (integer). */
+    amount: number;
+    pix_key: string;
+    pix_key_type: string;
+    origin?: string;
+    /** Debt collected in this withdrawal, in centavos (integer). */
+    debt_amount: number;
+    /** Fee charged to user, in centavos (integer). */
+    fee: number;
+    status: string;
+    psp_name?: string;
+    liquidator?: WithdrawalLiquidator | null;
+    receiver?: Receiver | null;
+    /** Change amount returned, in centavos (integer). */
+    change_amount: number;
+    change_payment_id?: string;
+    refund_id?: string;
+    /** Error message if failed. */
+    error?: string;
+    /** ISO 8601 timestamp. */
+    created_at: string;
+    /** ISO 8601 timestamp. */
+    updated_at: string;
+}
+/** Response from creating a withdrawal. */
+export interface CreateWithdrawalResponse {
+    id: string;
+    status: string;
+    /** Amount in centavos (integer). */
+    amount: number;
+}
+/** Parameters for creating a withdrawal. */
+export interface CreateWithdrawalParams {
+    /** Source wallet. */
+    wallet_id: string;
+    /** Amount in centavos (integer). */
+    amount: number;
+    /** PIX key for payout. */
+    pix_key: string;
+    /** PIX key type. */
+    pix_key_type: 'cpf' | 'cnpj' | 'email' | 'phone' | 'random';
+}
+export interface WithdrawalListParams {
+    cursor?: string;
+    prev_cursor?: string;
+    page?: number;
+    per_page?: number;
+    sort?: string;
+    status?: string;
+    wallet_id?: string;
+    pix_key_type?: string;
+    idempotency_key?: string;
+    q?: string;
+    /** Start date (ISO 8601). */
+    from?: string;
+    /** End date (ISO 8601). */
+    to?: string;
+}
+//# sourceMappingURL=withdrawal.d.ts.map

package/dist/esm/types/withdrawal.d.ts.map

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

package/dist/esm/types/withdrawal.js

@@ -0,0 +1,4 @@
+// ── Withdrawal types ────────────────────────────────────────────────
+// Source: cmd/specgen/types.go (WithdrawalView, Receiver, etc.)
+export {};
+//# sourceMappingURL=withdrawal.js.map

package/dist/esm/types/withdrawal.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@pagci/node",
+  "version": "0.1.0",
+  "description": "Official PAGCI Node.js SDK — PIX payments, withdrawals, refunds, and webhooks",
+  "license": "MIT",
+  "author": "PAGCI",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pagci/sdk-node"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:fixup",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:fixup": "echo {\"type\":\"module\"} > dist/esm/package.json && echo {\"type\":\"commonjs\"} > dist/cjs/package.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "dependencies": {}
+}