@amos.com/node 0.1.0

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@amos.com/node",
+  "version": "0.1.0",
+  "description": "Node.js client for the Amos Pay API.",
+  "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",
+    "openapi/schema.ts",
+    "src"
+  ],
+  "scripts": {
+    "biome": "biome check --write",
+    "prebuild": "npm run generate",
+    "build": "tsc",
+    "generate": "git -C ../openapi pull && rm -rf openapi/schema.ts && openapi-typescript ../openapi/amos/openapi.public.yaml --output openapi/schema.ts",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "npm run build && changeset publish"
+  },
+  "keywords": [
+    "amos",
+    "payment processing",
+    "credit cards",
+    "api"
+  ],
+  "author": "Amos",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amos/amos-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/amos/amos-node/issues"
+  },
+  "homepage": "https://github.com/amos/amos-node#readme",
+  "dependencies": {
+    "openapi-fetch": "0.17.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.14",
+    "@changesets/cli": "2.31.0",
+    "@types/node": "25.6.2",
+    "openapi-typescript": "7.13.0",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=24.11.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,54 @@
+import createClient, {
+  type ClientOptions,
+  type Middleware,
+} from "openapi-fetch";
+import type { paths } from "../openapi/schema";
+
+export * from "../openapi/schema";
+
+export const PAY_API_BASE_URL_PRODUCTION = "https://pay.subfi.com";
+export const PAY_API_BASE_URL_SANDBOX = "https://pay-sandbox.subfi.com";
+export const PAY_API_VERSION = "1";
+
+/**
+ * Create a typed `openapi-fetch` client for the SubFi Pay API.
+ *
+ * The returned client exposes `GET`, `POST`, `PUT`, `DELETE`, etc., each
+ * fully typed against the OpenAPI spec — paths, path/query/header params,
+ * request bodies, and response bodies are all checked at compile time.
+ *
+ * Provide credentials and the required `X-Api-Version` header either as
+ * default `headers` here or via `params.header` on each call. Use
+ * `client.use(middleware)` to add per-request behavior such as fresh
+ * idempotency keys.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   createPayApiClient,
+ *   PAY_API_BASE_URL_SANDBOX,
+ *   PAY_API_VERSION,
+ * } from "@subfico/pay-js-sdk/api";
+ *
+ * const pay = createPayApiClient({
+ *   baseUrl: PAY_API_BASE_URL_SANDBOX,
+ *   headers: {
+ *     "X-Api-Key": process.env.SUBFI_API_KEY!,
+ *     "X-Api-Version": PAY_API_VERSION,
+ *   },
+ * });
+ *
+ * const { data, error } = await pay.POST("/customers", {
+ *   params: { header: { "X-Api-Version": PAY_API_VERSION } },
+ *   body: { customer: { email: "alex@example.com" } },
+ * });
+ * ```
+ */
+export function createPayApiClient(options: ClientOptions) {
+  return createClient<paths>(options);
+}
+
+/** A configured SubFi Pay API client returned by {@link createPayApiClient}. */
+export type PayApiClient = ReturnType<typeof createPayApiClient>;
+
+export type { ClientOptions, Middleware };