@datablock-dev/sdk 1.0.0

package/README.md

@@ -0,0 +1,78 @@
+# @datablock/sdk
+
+Official Datablock SDK for Node.js.
+
+## Installation
+
+```bash
+npm install @datablock/sdk
+```
+
+## Usage
+
+```typescript
+import { Datablock } from "@datablock/sdk";
+
+const client = new Datablock({
+  apiKey: "your-api-key",
+  projectId: "your-project-id",
+});
+
+// Send to a single recipient
+const result = await client.email.send({
+  credentialId: "your-credential-id",
+  to: "recipient@example.com",
+  subject: "Hello from Datablock",
+  html: "<h1>Hello!</h1><p>This is a test email.</p>",
+});
+
+console.log(result.data.messageId);
+
+// Send to multiple recipients (up to 50)
+await client.email.send({
+  credentialId: "your-credential-id",
+  to: ["alice@example.com", "bob@example.com"],
+  subject: "Team Update",
+  text: "Plain text email body",
+  replyTo: "noreply@yourdomain.com",
+});
+```
+
+## Configuration
+
+| Option      | Required | Default                      | Description                |
+| ----------- | -------- | ---------------------------- | -------------------------- |
+| `apiKey`    | Yes      | —                            | Your Datablock API key     |
+| `projectId` | Yes      | —                            | Your Datablock project ID  |
+| `baseUrl`   | No       | `https://api.datablock.dev`  | API base URL override      |
+
+## Email
+
+### `client.email.send(params)`
+
+| Parameter      | Type                 | Required | Description                          |
+| -------------- | -------------------- | -------- | ------------------------------------ |
+| `credentialId` | `string`             | Yes      | SMTP credential ID                   |
+| `to`           | `string \| string[]` | Yes      | Recipient(s), max 50                 |
+| `subject`      | `string`             | Yes      | Email subject line                   |
+| `html`         | `string`             | No*      | HTML body                            |
+| `text`         | `string`             | No*      | Plain text body                      |
+| `replyTo`      | `string \| string[]` | No       | Reply-to address(es), max 5          |
+
+\* At least one of `html` or `text` must be provided.
+
+## Error Handling
+
+```typescript
+import { Datablock, DatablockError } from "@datablock/sdk";
+
+try {
+  await client.email.send({ ... });
+} catch (err) {
+  if (err instanceof DatablockError) {
+    console.error(err.code);    // e.g. "INSUFFICIENT_SCOPE"
+    console.error(err.status);  // e.g. 403
+    console.error(err.message); // Human-readable message
+  }
+}
+```

package/dist/index.d.mts

@@ -0,0 +1,41 @@
+interface DatablockConfig {
+    apiKey: string;
+    projectId: string;
+    baseUrl?: string;
+}
+interface SendEmailParams {
+    credentialId: string;
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    replyTo?: string | string[];
+}
+interface SendEmailResponse {
+    success: true;
+    data: {
+        messageId: string;
+    };
+}
+declare class DatablockError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(status: number, code: string, message: string);
+}
+declare class EmailService {
+    private readonly client;
+    constructor(client: Datablock);
+    send(params: SendEmailParams): Promise<SendEmailResponse>;
+}
+declare class Datablock {
+    /** @internal */
+    readonly apiKey: string;
+    /** @internal */
+    readonly projectId: string;
+    /** @internal */
+    readonly baseUrl: string;
+    readonly email: EmailService;
+    constructor(config: DatablockConfig);
+}
+
+export { Datablock, type DatablockConfig, DatablockError, type SendEmailParams, type SendEmailResponse, Datablock as default };

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+interface DatablockConfig {
+    apiKey: string;
+    projectId: string;
+    baseUrl?: string;
+}
+interface SendEmailParams {
+    credentialId: string;
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    replyTo?: string | string[];
+}
+interface SendEmailResponse {
+    success: true;
+    data: {
+        messageId: string;
+    };
+}
+declare class DatablockError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(status: number, code: string, message: string);
+}
+declare class EmailService {
+    private readonly client;
+    constructor(client: Datablock);
+    send(params: SendEmailParams): Promise<SendEmailResponse>;
+}
+declare class Datablock {
+    /** @internal */
+    readonly apiKey: string;
+    /** @internal */
+    readonly projectId: string;
+    /** @internal */
+    readonly baseUrl: string;
+    readonly email: EmailService;
+    constructor(config: DatablockConfig);
+}
+
+export { Datablock, type DatablockConfig, DatablockError, type SendEmailParams, type SendEmailResponse, Datablock as default };

package/dist/index.js

@@ -0,0 +1,92 @@
+"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, {
+  Datablock: () => Datablock,
+  DatablockError: () => DatablockError,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var DatablockError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.name = "DatablockError";
+    this.code = code;
+    this.status = status;
+  }
+};
+var EmailService = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async send(params) {
+    if (!params.to) throw new Error("to is required");
+    if (!params.subject) throw new Error("subject is required");
+    if (!params.html && !params.text) {
+      throw new Error("Either html or text must be provided");
+    }
+    const url = `${this.client.baseUrl}/v1/projects/${this.client.projectId}/email/send`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.client.apiKey}`
+      },
+      body: JSON.stringify({
+        credentialId: params.credentialId,
+        to: params.to,
+        subject: params.subject,
+        html: params.html,
+        text: params.text,
+        replyTo: params.replyTo
+      })
+    });
+    const body = await res.json();
+    if (!res.ok) {
+      const err = body;
+      throw new DatablockError(
+        res.status,
+        err.error?.code ?? "UNKNOWN",
+        err.error?.message ?? "Unknown error"
+      );
+    }
+    return body;
+  }
+};
+var Datablock = class {
+  constructor(config) {
+    if (!config.apiKey) throw new Error("apiKey is required");
+    if (!config.projectId) throw new Error("projectId is required");
+    this.apiKey = config.apiKey;
+    this.projectId = config.projectId;
+    this.baseUrl = (config.baseUrl ?? "https://api.datablock.dev").replace(
+      /\/$/,
+      ""
+    );
+    this.email = new EmailService(this);
+  }
+};
+var index_default = Datablock;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Datablock,
+  DatablockError
+});

package/dist/index.mjs

@@ -0,0 +1,66 @@
+// src/index.ts
+var DatablockError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.name = "DatablockError";
+    this.code = code;
+    this.status = status;
+  }
+};
+var EmailService = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async send(params) {
+    if (!params.to) throw new Error("to is required");
+    if (!params.subject) throw new Error("subject is required");
+    if (!params.html && !params.text) {
+      throw new Error("Either html or text must be provided");
+    }
+    const url = `${this.client.baseUrl}/v1/projects/${this.client.projectId}/email/send`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.client.apiKey}`
+      },
+      body: JSON.stringify({
+        credentialId: params.credentialId,
+        to: params.to,
+        subject: params.subject,
+        html: params.html,
+        text: params.text,
+        replyTo: params.replyTo
+      })
+    });
+    const body = await res.json();
+    if (!res.ok) {
+      const err = body;
+      throw new DatablockError(
+        res.status,
+        err.error?.code ?? "UNKNOWN",
+        err.error?.message ?? "Unknown error"
+      );
+    }
+    return body;
+  }
+};
+var Datablock = class {
+  constructor(config) {
+    if (!config.apiKey) throw new Error("apiKey is required");
+    if (!config.projectId) throw new Error("projectId is required");
+    this.apiKey = config.apiKey;
+    this.projectId = config.projectId;
+    this.baseUrl = (config.baseUrl ?? "https://api.datablock.dev").replace(
+      /\/$/,
+      ""
+    );
+    this.email = new EmailService(this);
+  }
+};
+var index_default = Datablock;
+export {
+  Datablock,
+  DatablockError,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@datablock-dev/sdk",
+  "version": "1.0.0",
+  "description": "Datablock SDK for Node.js",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "datablock",
+    "sdk"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}