@ariary/pay 1.0.0

package/README.md

@@ -0,0 +1,123 @@
+# @ariary/pay
+
+Payment and product SDK for the Ariary API.
+
+## Install
+
+```bash
+yarn add @ariary/pay
+```
+
+## Setup
+
+```ts
+import Ariari from '@ariary/pay'
+
+Ariari.config({
+  projectId: 'your-project-id',
+  secret: 'your-secret',
+})
+```
+
+## Products
+
+Manage products linked to your project.
+
+```ts
+// create
+const product = await Ariari.products.create({ name: 'Forfait Premium', price: 5000, imgUrl: 'https://example.com/img.png' })
+
+// list all
+const products = await Ariari.products.list()
+
+// delete
+await Ariari.products.delete(product.id)
+```
+
+## Create a Payment
+
+`Ariari.create()` returns a `Payment` object with the generated payment URL.
+
+```ts
+// with amount
+const payment = await Ariari.create({ amount: 5000 })
+
+// with product
+const payment = await Ariari.create({ productId: product.id })
+
+// with hooks and metadata
+const payment = await Ariari.create({
+  amount: 10000,
+  name: 'T-shirt bleu',
+  imgUrl: 'https://example.com/img.png',
+  hooks: {
+    success: 'https://example.com/success',
+    failure: 'https://example.com/failure',
+  },
+})
+```
+
+## Track a Payment
+
+```ts
+const payment = await Ariari.create({ amount: 5000 })
+
+// check status
+const info = await payment.status()
+// { id, amount, rest, status, parts, url, ... }
+
+// apply a ticket code
+const result = await payment.pay('Y-1234')
+```
+
+Payment statuses: `pending` | `incomplete` | `paid` | `failed`
+
+A `Status` enum is also exported:
+
+```ts
+import { Status } from '@ariary/pay'
+
+if (info.status === Status.PAID) { ... }
+```
+
+## Retrieve an existing Payment
+
+Store `payment.id` to retrieve it later with `.getPayment()`.
+
+```ts
+const payment = await Ariari.create({ amount: 5000 })
+const paymentId = payment.id // save this
+
+// later
+const payment = Ariari.getPayment(paymentId)
+const info = await payment.status()
+```
+
+## Multiple instances
+
+Use `name` to manage separate Ariari instances with different credentials. `Ariari.config()` returns the instance directly.
+
+```ts
+const shop = Ariari.config({
+  name: 'shop',
+  projectId: 'project-a',
+  secret: 'secret-a',
+})
+
+const billing = Ariari.config({
+  name: 'billing',
+  projectId: 'project-b',
+  secret: 'secret-b',
+})
+
+await shop.create({ amount: 5000 })
+await billing.create({ productId: 'prod-123' })
+```
+
+You can also retrieve a named instance later with `Ariari.get()`.
+
+```ts
+const shop = Ariari.get('shop')
+```
+
+Without `name`, the instance defaults to `"main"` and is used by static methods (`Ariari.create`, `Ariari.products`, `Ariari.getPayment`).

package/dist/index.d.mts

@@ -0,0 +1,105 @@
+type Data = {
+    body?: Record<string, any>;
+    params?: Record<string, any>;
+    public?: boolean;
+};
+type PData = Omit<Data, 'body'>;
+type Config = {
+    projectId: string;
+    secret: string;
+    baseUrl?: string;
+};
+declare const createRequester: (config: Config) => {
+    get: <T = any>(url: string, data?: PData) => Promise<T>;
+    post: <T = any>(url: string, data?: Data) => Promise<T>;
+    patch: <T = any>(url: string, data?: Data) => Promise<T>;
+    put: <T = any>(url: string, data?: Data) => Promise<T>;
+    delete: <T = any>(url: string, data?: PData) => Promise<T>;
+};
+
+declare enum Status {
+    PENDING = "pending",
+    INCOMPLETE = "incomplete",
+    PAID = "paid",
+    FAILED = "failed"
+}
+type Hooks = {
+    success?: string;
+    progress?: string;
+    failure?: string;
+};
+type CreatePaymentData = {
+    amount?: number;
+    productId?: string;
+    name?: string;
+    imgUrl?: string;
+    hooks?: Hooks;
+};
+type PaymentPart = {
+    id: string;
+    amount: number;
+    transactionId: string;
+    date: string;
+};
+type PaymentResponse = {
+    id: string;
+    amount: number;
+    rest: number;
+    productId?: string;
+    name?: string;
+    imgUrl?: string;
+    status: Status;
+    parts: PaymentPart[];
+    createdAt: string;
+    updatedAt: string;
+    url: string;
+};
+type CreateProductData = {
+    name: string;
+    price: number;
+    imgUrl?: string;
+};
+type Product = {
+    id: string;
+    name: string;
+    price: number;
+    imgUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+
+declare class Payment {
+    id: string;
+    private _requester;
+    constructor(id: string, requester: ReturnType<typeof createRequester>);
+    status(): Promise<PaymentResponse>;
+    pay(ticketCode: string): Promise<PaymentResponse>;
+}
+declare class Ariari {
+    private _config;
+    private _requester;
+    private constructor();
+    static config: (nameAndConfig: Config & {
+        name?: string;
+    }) => Ariari;
+    static init: (nameAndConfig: Config & {
+        name?: string;
+    }) => Ariari;
+    static get: (name?: string) => Ariari;
+    create: (data: CreatePaymentData) => Promise<Payment>;
+    getPayment: (id: string) => Payment;
+    products: {
+        create: (data: CreateProductData) => Promise<Product>;
+        list: () => Promise<Product[]>;
+        delete: (id: string) => Promise<void>;
+    };
+    static create: (data: CreatePaymentData) => Promise<Payment>;
+    static getPayment: (id: string) => Payment;
+    static products: {
+        create: (data: CreateProductData) => Promise<Product>;
+        list: () => Promise<Product[]>;
+        delete: (id: string) => Promise<void>;
+    };
+}
+
+export { Status, Ariari as default };

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+type Data = {
+    body?: Record<string, any>;
+    params?: Record<string, any>;
+    public?: boolean;
+};
+type PData = Omit<Data, 'body'>;
+type Config = {
+    projectId: string;
+    secret: string;
+    baseUrl?: string;
+};
+declare const createRequester: (config: Config) => {
+    get: <T = any>(url: string, data?: PData) => Promise<T>;
+    post: <T = any>(url: string, data?: Data) => Promise<T>;
+    patch: <T = any>(url: string, data?: Data) => Promise<T>;
+    put: <T = any>(url: string, data?: Data) => Promise<T>;
+    delete: <T = any>(url: string, data?: PData) => Promise<T>;
+};
+
+declare enum Status {
+    PENDING = "pending",
+    INCOMPLETE = "incomplete",
+    PAID = "paid",
+    FAILED = "failed"
+}
+type Hooks = {
+    success?: string;
+    progress?: string;
+    failure?: string;
+};
+type CreatePaymentData = {
+    amount?: number;
+    productId?: string;
+    name?: string;
+    imgUrl?: string;
+    hooks?: Hooks;
+};
+type PaymentPart = {
+    id: string;
+    amount: number;
+    transactionId: string;
+    date: string;
+};
+type PaymentResponse = {
+    id: string;
+    amount: number;
+    rest: number;
+    productId?: string;
+    name?: string;
+    imgUrl?: string;
+    status: Status;
+    parts: PaymentPart[];
+    createdAt: string;
+    updatedAt: string;
+    url: string;
+};
+type CreateProductData = {
+    name: string;
+    price: number;
+    imgUrl?: string;
+};
+type Product = {
+    id: string;
+    name: string;
+    price: number;
+    imgUrl?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+
+declare class Payment {
+    id: string;
+    private _requester;
+    constructor(id: string, requester: ReturnType<typeof createRequester>);
+    status(): Promise<PaymentResponse>;
+    pay(ticketCode: string): Promise<PaymentResponse>;
+}
+declare class Ariari {
+    private _config;
+    private _requester;
+    private constructor();
+    static config: (nameAndConfig: Config & {
+        name?: string;
+    }) => Ariari;
+    static init: (nameAndConfig: Config & {
+        name?: string;
+    }) => Ariari;
+    static get: (name?: string) => Ariari;
+    create: (data: CreatePaymentData) => Promise<Payment>;
+    getPayment: (id: string) => Payment;
+    products: {
+        create: (data: CreateProductData) => Promise<Product>;
+        list: () => Promise<Product[]>;
+        delete: (id: string) => Promise<void>;
+    };
+    static create: (data: CreatePaymentData) => Promise<Payment>;
+    static getPayment: (id: string) => Payment;
+    static products: {
+        create: (data: CreateProductData) => Promise<Product>;
+        list: () => Promise<Product[]>;
+        delete: (id: string) => Promise<void>;
+    };
+}
+
+export { Status, Ariari as default };

package/dist/index.js

@@ -0,0 +1,132 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Status: () => Status,
+  default: () => src_default
+});
+module.exports = __toCommonJS(src_exports);
+
+// ../common/http.ts
+async function request(verb, endpoint, options, config) {
+  if (!config) throw new Error("Ariari package not configured.");
+  const url = `${config.baseUrl || "https://back.ariari.mg"}${endpoint}`;
+  const headers = { "Content-Type": "application/json" };
+  if (!options.public) {
+    headers["x-project-id"] = config.projectId;
+    headers["x-secret"] = config.secret;
+  }
+  const fetchOptions = { method: verb, headers };
+  if ("body" in options && options.body) {
+    fetchOptions.body = JSON.stringify(options.body);
+  }
+  try {
+    const response = await fetch(url, fetchOptions);
+    const data = await response.json();
+    if (!response.ok) {
+      const message = data?.message || "Unknown error";
+      throw new Error(`[${response.status}] ${message}`);
+    }
+    return data;
+  } catch (error) {
+    if (error instanceof Error) {
+      throw error;
+    }
+    throw new Error("Network error");
+  }
+}
+var createRequester = (config) => ({
+  get: (url, data = {}) => request("GET", url, data, config),
+  post: (url, data = {}) => request("POST", url, data, config),
+  patch: (url, data = {}) => request("PATCH", url, data, config),
+  put: (url, data = {}) => request("PUT", url, data, config),
+  delete: (url, data = {}) => request("DELETE", url, data, config)
+});
+
+// src/types/index.ts
+var Status = /* @__PURE__ */ ((Status2) => {
+  Status2["PENDING"] = "pending";
+  Status2["INCOMPLETE"] = "incomplete";
+  Status2["PAID"] = "paid";
+  Status2["FAILED"] = "failed";
+  return Status2;
+})(Status || {});
+
+// src/index.ts
+var instances = {};
+var Payment = class {
+  constructor(id, requester) {
+    this.id = id;
+    this._requester = requester;
+  }
+  async status() {
+    const res = await this._requester.get(`/api/payments/${this.id}`);
+    return res.data;
+  }
+  async pay(ticketCode) {
+    const res = await this._requester.put(`/api/payments/${this.id}/pay`, { body: { ticketCode } });
+    return res.data;
+  }
+};
+var _Ariari = class _Ariari {
+  constructor({ name = "main", ...config }) {
+    this.create = async (data) => {
+      const res = await this._requester.post("/api/payments", { body: data });
+      return new Payment(res.id, this._requester);
+    };
+    this.getPayment = (id) => new Payment(id, this._requester);
+    this.products = {
+      create: async (data) => {
+        const res = await this._requester.post("/api/products", { body: data });
+        return res.data;
+      },
+      list: async () => {
+        const res = await this._requester.get("/api/products");
+        return res.data;
+      },
+      delete: async (id) => {
+        await this._requester.delete(`/api/products/${id}`);
+      }
+    };
+    this._config = config;
+    this._requester = createRequester(config);
+    instances[name] = this;
+  }
+};
+_Ariari.config = (nameAndConfig) => new _Ariari(nameAndConfig);
+_Ariari.init = _Ariari.config;
+_Ariari.get = (name = "main") => {
+  if (!instances[name]) throw new Error(`The instance of Ariari with the name "${name}" doesn't exist yet. Call Ariari.config(...)`);
+  return instances[name];
+};
+_Ariari.create = async (data) => await _Ariari.get("main")?.create(data);
+_Ariari.getPayment = (id) => _Ariari.get("main")?.getPayment(id);
+_Ariari.products = {
+  create: async (data) => await _Ariari.get("main")?.products.create(data),
+  list: async () => await _Ariari.get("main")?.products.list(),
+  delete: async (id) => await _Ariari.get("main")?.products.delete(id)
+};
+var Ariari = _Ariari;
+var src_default = Ariari;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Status
+});

package/dist/index.mjs

@@ -0,0 +1,105 @@
+// ../common/http.ts
+async function request(verb, endpoint, options, config) {
+  if (!config) throw new Error("Ariari package not configured.");
+  const url = `${config.baseUrl || "https://back.ariari.mg"}${endpoint}`;
+  const headers = { "Content-Type": "application/json" };
+  if (!options.public) {
+    headers["x-project-id"] = config.projectId;
+    headers["x-secret"] = config.secret;
+  }
+  const fetchOptions = { method: verb, headers };
+  if ("body" in options && options.body) {
+    fetchOptions.body = JSON.stringify(options.body);
+  }
+  try {
+    const response = await fetch(url, fetchOptions);
+    const data = await response.json();
+    if (!response.ok) {
+      const message = data?.message || "Unknown error";
+      throw new Error(`[${response.status}] ${message}`);
+    }
+    return data;
+  } catch (error) {
+    if (error instanceof Error) {
+      throw error;
+    }
+    throw new Error("Network error");
+  }
+}
+var createRequester = (config) => ({
+  get: (url, data = {}) => request("GET", url, data, config),
+  post: (url, data = {}) => request("POST", url, data, config),
+  patch: (url, data = {}) => request("PATCH", url, data, config),
+  put: (url, data = {}) => request("PUT", url, data, config),
+  delete: (url, data = {}) => request("DELETE", url, data, config)
+});
+
+// src/types/index.ts
+var Status = /* @__PURE__ */ ((Status2) => {
+  Status2["PENDING"] = "pending";
+  Status2["INCOMPLETE"] = "incomplete";
+  Status2["PAID"] = "paid";
+  Status2["FAILED"] = "failed";
+  return Status2;
+})(Status || {});
+
+// src/index.ts
+var instances = {};
+var Payment = class {
+  constructor(id, requester) {
+    this.id = id;
+    this._requester = requester;
+  }
+  async status() {
+    const res = await this._requester.get(`/api/payments/${this.id}`);
+    return res.data;
+  }
+  async pay(ticketCode) {
+    const res = await this._requester.put(`/api/payments/${this.id}/pay`, { body: { ticketCode } });
+    return res.data;
+  }
+};
+var _Ariari = class _Ariari {
+  constructor({ name = "main", ...config }) {
+    this.create = async (data) => {
+      const res = await this._requester.post("/api/payments", { body: data });
+      return new Payment(res.id, this._requester);
+    };
+    this.getPayment = (id) => new Payment(id, this._requester);
+    this.products = {
+      create: async (data) => {
+        const res = await this._requester.post("/api/products", { body: data });
+        return res.data;
+      },
+      list: async () => {
+        const res = await this._requester.get("/api/products");
+        return res.data;
+      },
+      delete: async (id) => {
+        await this._requester.delete(`/api/products/${id}`);
+      }
+    };
+    this._config = config;
+    this._requester = createRequester(config);
+    instances[name] = this;
+  }
+};
+_Ariari.config = (nameAndConfig) => new _Ariari(nameAndConfig);
+_Ariari.init = _Ariari.config;
+_Ariari.get = (name = "main") => {
+  if (!instances[name]) throw new Error(`The instance of Ariari with the name "${name}" doesn't exist yet. Call Ariari.config(...)`);
+  return instances[name];
+};
+_Ariari.create = async (data) => await _Ariari.get("main")?.create(data);
+_Ariari.getPayment = (id) => _Ariari.get("main")?.getPayment(id);
+_Ariari.products = {
+  create: async (data) => await _Ariari.get("main")?.products.create(data),
+  list: async () => await _Ariari.get("main")?.products.list(),
+  delete: async (id) => await _Ariari.get("main")?.products.delete(id)
+};
+var Ariari = _Ariari;
+var src_default = Ariari;
+export {
+  Status,
+  src_default as default
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@ariary/pay",
+  "version": "1.0.0",
+  "description": "Payment SDK pour l'API Ariary",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "node --env-file=.env node_modules/.bin/tsx test.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Ariary",
+  "license": "ISC",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}