@nilovonjs/connect 0.1.1

package/README.md

@@ -0,0 +1,63 @@
+# @nilovonjs/connect
+
+Official TypeScript SDK for Nilovon Connect.
+
+- Homepage: `https://connect.nilovon.com`
+- API host: `https://api.connect.nilovon.com`
+- API reference: `https://api.connect.nilovon.com/v1`
+
+## Installation
+
+```bash
+npm install @nilovonjs/connect
+```
+
+## Quick Start
+
+```ts
+import { createClient } from "@nilovonjs/connect";
+
+const connect = createClient({
+  apiKey: "sk_live_...",
+});
+
+await connect.message.send({
+  channelType: "email",
+  emailDomainId: "dom_...",
+  to: "user@example.com",
+  subject: "Hello from Connect",
+  body: "<p>Your first message</p>",
+});
+```
+
+## Configuration
+
+| Option   | Required | Description               |
+| -------- | -------- | ------------------------- |
+| `apiKey` | Yes      | API key from your dashboard |
+
+## API Surface
+
+- `connect.message`: `send`, `list`, `get`
+- `connect.contact`: `create`, `list`, `get`, `update`, `delete`, `bulkCreate`
+- `connect.template`: `create`, `list`, `get`, `update`, `delete`
+- `connect.webhook`: `create`, `list`, `get`, `update`, `delete`, `test`, `listEvents`
+- `connect.emailDomain`: `list`, `get`, `add`, `verify`, `delete`, `setDefault`
+- `connect.phoneNumber`: `list`, `get`, `searchAvailable`, `purchase`, `release`, `update`
+- `connect.segment`: `create`, `list`, `get`, `update`, `delete`
+
+## Error Handling
+
+The SDK throws `ORPCError` for API errors.
+
+```ts
+import { ORPCError } from "@orpc/client";
+
+try {
+  await connect.contact.get({ id: "nonexistent" });
+} catch (error) {
+  if (error instanceof ORPCError) {
+    console.error(error.code, error.message);
+  }
+}
+```

package/dist/index.cjs

@@ -0,0 +1,44 @@
+"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 index_exports = {};
+__export(index_exports, {
+  createClient: () => createClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_client = require("@orpc/client");
+var import_fetch = require("@orpc/client/fetch");
+var BASE_URL = "https://api.connect.nilovon.com";
+function createClient(config) {
+  const link = new import_fetch.RPCLink({
+    url: `${BASE_URL}/rpc`,
+    headers: () => ({
+      Authorization: `Bearer ${config.apiKey}`
+    })
+  });
+  return (0, import_client.createORPCClient)(link);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createClient
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export { createClient } from \"./client.js\";\nexport type { ConnectClient, ConnectConfig } from \"./client.js\";\n","import { createORPCClient } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\n\nexport interface ConnectConfig {\n  /** API key from the dashboard (used as Bearer token). */\n  apiKey: string;\n}\n\nconst BASE_URL = \"https://api.connect.nilovon.com\";\n\n/**\n * Create a fully-typed Connect API client.\n *\n * ```ts\n * import { createClient } from \"@nilovonjs/connect\";\n *\n * const client = createClient({ apiKey: \"sk_live_...\" });\n *\n * const { items } = await client.message.list({ limit: 10, offset: 0 });\n * ```\n */\nexport type ConnectClient = ReturnType<typeof createORPCClient>;\n\nexport function createClient(config: ConnectConfig): ConnectClient {\n  const link = new RPCLink({\n    url: `${BASE_URL}/rpc`,\n    headers: () => ({\n      Authorization: `Bearer ${config.apiKey}`,\n    }),\n  });\n\n  return createORPCClient(link);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAiC;AACjC,mBAAwB;AAOxB,IAAM,WAAW;AAeV,SAAS,aAAa,QAAsC;AACjE,QAAM,OAAO,IAAI,qBAAQ;AAAA,IACvB,KAAK,GAAG,QAAQ;AAAA,IAChB,SAAS,OAAO;AAAA,MACd,eAAe,UAAU,OAAO,MAAM;AAAA,IACxC;AAAA,EACF,CAAC;AAED,aAAO,gCAAiB,IAAI;AAC9B;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import { createORPCClient } from '@orpc/client';
+
+interface ConnectConfig {
+    /** API key from the dashboard (used as Bearer token). */
+    apiKey: string;
+}
+/**
+ * Create a fully-typed Connect API client.
+ *
+ * ```ts
+ * import { createClient } from "@nilovonjs/connect";
+ *
+ * const client = createClient({ apiKey: "sk_live_..." });
+ *
+ * const { items } = await client.message.list({ limit: 10, offset: 0 });
+ * ```
+ */
+type ConnectClient = ReturnType<typeof createORPCClient>;
+declare function createClient(config: ConnectConfig): ConnectClient;
+
+export { type ConnectClient, type ConnectConfig, createClient };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { createORPCClient } from '@orpc/client';
+
+interface ConnectConfig {
+    /** API key from the dashboard (used as Bearer token). */
+    apiKey: string;
+}
+/**
+ * Create a fully-typed Connect API client.
+ *
+ * ```ts
+ * import { createClient } from "@nilovonjs/connect";
+ *
+ * const client = createClient({ apiKey: "sk_live_..." });
+ *
+ * const { items } = await client.message.list({ limit: 10, offset: 0 });
+ * ```
+ */
+type ConnectClient = ReturnType<typeof createORPCClient>;
+declare function createClient(config: ConnectConfig): ConnectClient;
+
+export { type ConnectClient, type ConnectConfig, createClient };

package/dist/index.js

@@ -0,0 +1,17 @@
+// src/client.ts
+import { createORPCClient } from "@orpc/client";
+import { RPCLink } from "@orpc/client/fetch";
+var BASE_URL = "https://api.connect.nilovon.com";
+function createClient(config) {
+  const link = new RPCLink({
+    url: `${BASE_URL}/rpc`,
+    headers: () => ({
+      Authorization: `Bearer ${config.apiKey}`
+    })
+  });
+  return createORPCClient(link);
+}
+export {
+  createClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { createORPCClient } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\n\nexport interface ConnectConfig {\n  /** API key from the dashboard (used as Bearer token). */\n  apiKey: string;\n}\n\nconst BASE_URL = \"https://api.connect.nilovon.com\";\n\n/**\n * Create a fully-typed Connect API client.\n *\n * ```ts\n * import { createClient } from \"@nilovonjs/connect\";\n *\n * const client = createClient({ apiKey: \"sk_live_...\" });\n *\n * const { items } = await client.message.list({ limit: 10, offset: 0 });\n * ```\n */\nexport type ConnectClient = ReturnType<typeof createORPCClient>;\n\nexport function createClient(config: ConnectConfig): ConnectClient {\n  const link = new RPCLink({\n    url: `${BASE_URL}/rpc`,\n    headers: () => ({\n      Authorization: `Bearer ${config.apiKey}`,\n    }),\n  });\n\n  return createORPCClient(link);\n}\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,SAAS,eAAe;AAOxB,IAAM,WAAW;AAeV,SAAS,aAAa,QAAsC;AACjE,QAAM,OAAO,IAAI,QAAQ;AAAA,IACvB,KAAK,GAAG,QAAQ;AAAA,IAChB,SAAS,OAAO;AAAA,MACd,eAAe,UAAU,OAAO,MAAM;AAAA,IACxC;AAAA,EACF,CAAC;AAED,SAAO,iBAAiB,IAAI;AAC9B;","names":[]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@nilovonjs/connect",
+  "version": "0.1.1",
+  "description": "TypeScript SDK for the Nilovon Connect API",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@orpc/client": "^1.12.2"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check-types": "tsc --noEmit"
+  }
+}