@medalsocial/sdk 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Medal Social
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+## Medal Social SDK (TypeScript)
+
+Simple, typed client for the Medal Social API. Supports authentication via Client ID/Secret (Basic) today and Bearer token. Provides convenience methods for common create actions.
+
+### Install
+
+```bash
+corepack enable
+pnpm add @medalsocial/sdk
+```
+
+### Quick start
+
+```ts
+import MedalSocialClient from '@medalsocial/sdk';
+
+const client = new MedalSocialClient({
+  auth: { kind: 'basic', clientId: process.env.MEDAL_CLIENT_ID!, clientSecret: process.env.MEDAL_CLIENT_SECRET! },
+  // or: auth: { kind: 'bearer', token: process.env.MEDAL_API_TOKEN! },
+  // optional: baseUrl: 'https://api.medalsocial.com',
+});
+
+// Create lead(s)
+await client.createLead([
+  {
+    name: 'Alex Example',
+    email: 'lead.test@example.com',
+    company: '',
+    source: 'website',
+  },
+]);
+
+// Create a note
+await client.createNote({
+  name: 'Test Testnes',
+  email: 'test@medalsocial.com',
+  company: 'Medal Social Test company',
+  phone: '+47 99887766',
+  content: 'Hei jeg skal gjerne sende to konteinere til USA.',
+  metadata: { Budsjett: '$100,000' },
+});
+
+// Record cookie consent
+await client.createCookieConsent({
+  domain: 'example.com',
+  consentStatus: 'partial',
+  consentTimestamp: '2025-06-04T10:30:00Z',
+  ipAddress: '88.151.164.19',
+  userAgent: 'Mozilla/5.0',
+  cookiePreferences: {
+    necessary: {
+      allowed: true,
+      cookieRecords: [
+        { cookie: 'session_id', duration: 'Session', description: 'Essential for user authentication and session management' },
+      ],
+    },
+    analytics: { allowed: false },
+    marketing: { allowed: true },
+    functional: { allowed: true },
+  },
+});
+
+// Create event signup
+await client.createEventSignup({
+  contact: {
+    name: 'Test Testnes',
+    email: 'test@medalsocial.com',
+    company: 'Medal Social Test company',
+  },
+  event: {
+    externalId: 'eksadaasdasd',
+    name: 'Product saus asd',
+    description: 'Learn about our new product asd',
+    time: '2025-06-15T14:00:00Z',
+    location: 'Online',
+    thumbnail: 'https://medalsocialdevstorage.blob.core.windows.net/images/d05bad9e-bc52-4f8e-8191-d6944d34055c.jpg',
+  },
+});
+```
+
+### API
+
+- `new MedalSocialClient(options)`
+  - **auth** (required):
+    - `{ kind: 'basic', clientId: string, clientSecret: string }`
+    - `{ kind: 'bearer', token: string }`
+  - **baseUrl** (optional): string. Defaults to `https://api.medalsocial.com`.
+  - **timeoutMs** (optional): number. Defaults to 30000.
+  - **userAgent** (optional): string.
+  - **fetch** (optional): custom fetch implementation to override transport.
+
+- `createLead(items: { name, email, company?, source? }[])` -> `{ status, data, headers }`
+- `createNote(input)` -> `{ status, data, headers }`
+- `createCookieConsent(input)` -> `{ status, data, headers }`
+- `createEventSignup(input)` -> `{ status, data, headers }`
+- `sendTransactionalEmail(input)` -> `{ status, data, headers }`
+
+Responses throw on non-2xx with an error containing `status` and `details` (parsed body when available).
+
+### Runtime support
+
+- Node 20+ and modern browsers. The client uses `fetch`; in Node 20+ `fetch` is built-in. For older environments, provide a global `fetch` polyfill.
+
+### Docs
+
+- API Reference (TypeDoc): published automatically from the `prod` branch via GitHub Pages.
+- Local: `pnpm docs` then open `docs/index.html`.
+
+### Contributing
+
+PRs welcome! Use pnpm. Useful scripts:
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+pnpm docs
+```
+
+### License
+
+MIT
+
+

package/dist/index.d.mts

@@ -0,0 +1,108 @@
+type AuthOptions = {
+    kind: "basic";
+    clientId: string;
+    clientSecret: string;
+} | {
+    kind: "bearer";
+    token: string;
+};
+interface ClientOptions {
+    baseUrl?: string;
+    auth: AuthOptions;
+    timeoutMs?: number;
+    userAgent?: string;
+}
+interface LeadItem {
+    name: string;
+    email: string;
+    company?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+interface ContactNoteInput {
+    contactId: string;
+    note: string;
+    [key: string]: unknown;
+}
+interface NoteInput {
+    name: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    phone?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CookieRecord {
+    cookie: string;
+    duration: string;
+    description: string;
+}
+interface CookieCategoryConsent {
+    allowed: boolean;
+    cookieRecords?: CookieRecord[];
+}
+interface CookieConsentInput {
+    domain: string;
+    consentStatus: "granted" | "denied" | "partial" | string;
+    consentTimestamp: string;
+    ipAddress?: string;
+    userAgent?: string;
+    cookiePreferences: {
+        necessary?: CookieCategoryConsent;
+        analytics?: CookieCategoryConsent;
+        marketing?: CookieCategoryConsent;
+        functional?: CookieCategoryConsent;
+        [key: string]: CookieCategoryConsent | undefined;
+    };
+}
+interface EventSignupInput {
+    contact: {
+        name: string;
+        email: string;
+        company?: string;
+    };
+    event: {
+        externalId: string;
+        name: string;
+        description?: string;
+        time: string;
+        location?: string;
+        thumbnail?: string;
+    };
+}
+interface ApiResponse<T> {
+    status: number;
+    data: T;
+    headers: Record<string, string>;
+}
+interface TransactionalEmailInput {
+    to: string;
+    slug: string;
+    additionalData?: Record<string, unknown>;
+}
+declare class MedalSocialClient {
+    private readonly baseUrl;
+    private readonly auth;
+    private readonly timeoutMs;
+    private readonly userAgent;
+    constructor(options: ClientOptions);
+    /** Create one or more leads */
+    createLead<T = unknown>(items: LeadItem[]): Promise<ApiResponse<T>>;
+    /** Create a note attached to a contact by id */
+    createContactNote<T = unknown>(input: ContactNoteInput): Promise<ApiResponse<T>>;
+    /** Record a user’s cookie consent preferences */
+    createCookieConsent<T = unknown>(input: CookieConsentInput): Promise<ApiResponse<T>>;
+    /** Create an event signup with contact and event details */
+    createEventSignup<T = unknown>(input: EventSignupInput): Promise<ApiResponse<T>>;
+    /** Create a free-form note for inbound messages */
+    createNote<T = unknown>(input: NoteInput): Promise<ApiResponse<T>>;
+    /** Send a transactional email by template slug */
+    sendTransactionalEmail<T = unknown>(input: TransactionalEmailInput): Promise<ApiResponse<T>>;
+    private post;
+    private fetchWithAuth;
+    private handleResponse;
+}
+
+export { type ApiResponse, type AuthOptions, type ClientOptions, type ContactNoteInput, type CookieCategoryConsent, type CookieConsentInput, type CookieRecord, type EventSignupInput, type LeadItem, MedalSocialClient, type NoteInput, type TransactionalEmailInput, MedalSocialClient as default };

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+type AuthOptions = {
+    kind: "basic";
+    clientId: string;
+    clientSecret: string;
+} | {
+    kind: "bearer";
+    token: string;
+};
+interface ClientOptions {
+    baseUrl?: string;
+    auth: AuthOptions;
+    timeoutMs?: number;
+    userAgent?: string;
+}
+interface LeadItem {
+    name: string;
+    email: string;
+    company?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+interface ContactNoteInput {
+    contactId: string;
+    note: string;
+    [key: string]: unknown;
+}
+interface NoteInput {
+    name: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    phone?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
+interface CookieRecord {
+    cookie: string;
+    duration: string;
+    description: string;
+}
+interface CookieCategoryConsent {
+    allowed: boolean;
+    cookieRecords?: CookieRecord[];
+}
+interface CookieConsentInput {
+    domain: string;
+    consentStatus: "granted" | "denied" | "partial" | string;
+    consentTimestamp: string;
+    ipAddress?: string;
+    userAgent?: string;
+    cookiePreferences: {
+        necessary?: CookieCategoryConsent;
+        analytics?: CookieCategoryConsent;
+        marketing?: CookieCategoryConsent;
+        functional?: CookieCategoryConsent;
+        [key: string]: CookieCategoryConsent | undefined;
+    };
+}
+interface EventSignupInput {
+    contact: {
+        name: string;
+        email: string;
+        company?: string;
+    };
+    event: {
+        externalId: string;
+        name: string;
+        description?: string;
+        time: string;
+        location?: string;
+        thumbnail?: string;
+    };
+}
+interface ApiResponse<T> {
+    status: number;
+    data: T;
+    headers: Record<string, string>;
+}
+interface TransactionalEmailInput {
+    to: string;
+    slug: string;
+    additionalData?: Record<string, unknown>;
+}
+declare class MedalSocialClient {
+    private readonly baseUrl;
+    private readonly auth;
+    private readonly timeoutMs;
+    private readonly userAgent;
+    constructor(options: ClientOptions);
+    /** Create one or more leads */
+    createLead<T = unknown>(items: LeadItem[]): Promise<ApiResponse<T>>;
+    /** Create a note attached to a contact by id */
+    createContactNote<T = unknown>(input: ContactNoteInput): Promise<ApiResponse<T>>;
+    /** Record a user’s cookie consent preferences */
+    createCookieConsent<T = unknown>(input: CookieConsentInput): Promise<ApiResponse<T>>;
+    /** Create an event signup with contact and event details */
+    createEventSignup<T = unknown>(input: EventSignupInput): Promise<ApiResponse<T>>;
+    /** Create a free-form note for inbound messages */
+    createNote<T = unknown>(input: NoteInput): Promise<ApiResponse<T>>;
+    /** Send a transactional email by template slug */
+    sendTransactionalEmail<T = unknown>(input: TransactionalEmailInput): Promise<ApiResponse<T>>;
+    private post;
+    private fetchWithAuth;
+    private handleResponse;
+}
+
+export { type ApiResponse, type AuthOptions, type ClientOptions, type ContactNoteInput, type CookieCategoryConsent, type CookieConsentInput, type CookieRecord, type EventSignupInput, type LeadItem, MedalSocialClient, type NoteInput, type TransactionalEmailInput, MedalSocialClient as default };

package/dist/index.js

@@ -0,0 +1,141 @@
+"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, {
+  MedalSocialClient: () => MedalSocialClient,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var MedalSocialClient = class {
+  baseUrl;
+  auth;
+  timeoutMs;
+  userAgent;
+  constructor(options) {
+    this.baseUrl = (options.baseUrl ?? "https://api.medalsocial.com").replace(/\/$/, "");
+    this.auth = options.auth;
+    this.timeoutMs = options.timeoutMs ?? 3e4;
+    this.userAgent = options.userAgent ?? "medal-social-sdk/0.1.0 (+https://github.com/Medal-Social/MedalSocial.git)";
+  }
+  // Public endpoints
+  /** Create one or more leads */
+  async createLead(items) {
+    return this.post("/v1/leads", items);
+  }
+  /** Create a note attached to a contact by id */
+  async createContactNote(input) {
+    return this.post("/v1/contacts/notes", input);
+  }
+  /** Record a user’s cookie consent preferences */
+  async createCookieConsent(input) {
+    return this.post("/v1/cookie-consent", input);
+  }
+  /** Create an event signup with contact and event details */
+  async createEventSignup(input) {
+    return this.post("/v1/event-signup", input);
+  }
+  /** Create a free-form note for inbound messages */
+  async createNote(input) {
+    return this.post("/v1/notes", input);
+  }
+  /** Send a transactional email by template slug */
+  async sendTransactionalEmail(input) {
+    return this.post("/v1/send-transactional-email", input);
+  }
+  // Internal HTTP helpers
+  async post(path, body) {
+    const maxAttempts = 3;
+    let attempt = 0;
+    while (attempt < maxAttempts) {
+      attempt++;
+      const res = await this.fetchWithAuth(path, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      if (res.status === 429 || res.status >= 500 && res.status <= 599) {
+        if (attempt < maxAttempts) {
+          const retryAfter = res.headers.get("retry-after");
+          let delayMs = 0;
+          if (retryAfter) {
+            const seconds = Number(retryAfter);
+            delayMs = Number.isFinite(seconds) ? seconds * 1e3 : 0;
+          }
+          if (delayMs <= 0) {
+            delayMs = 250 * attempt;
+          }
+          await new Promise((r) => setTimeout(r, delayMs));
+          continue;
+        }
+      }
+      return this.handleResponse(res);
+    }
+    throw new Error("Request failed after retries");
+  }
+  async fetchWithAuth(path, init) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = new Headers(init.headers);
+    try {
+      headers.set("user-agent", this.userAgent);
+    } catch {
+    }
+    if (this.auth.kind === "bearer") {
+      headers.set("authorization", `Bearer ${this.auth.token}`);
+    } else if (this.auth.kind === "basic") {
+      headers.set("Client-Id", this.auth.clientId);
+      headers.set("Client-Secret", this.auth.clientSecret);
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(url, { ...init, headers, signal: controller.signal });
+      return res;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async handleResponse(res) {
+    const text = await res.text();
+    let parsed = void 0;
+    try {
+      parsed = text ? JSON.parse(text) : void 0;
+    } catch {
+      parsed = text;
+    }
+    const headers = {};
+    res.headers.forEach((v, k) => {
+      headers[k] = v;
+    });
+    if (!res.ok) {
+      const error = new Error(`HTTP ${res.status}: ${res.statusText}`);
+      error.status = res.status;
+      error.details = parsed;
+      throw error;
+    }
+    return { status: res.status, data: parsed, headers };
+  }
+};
+var index_default = MedalSocialClient;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MedalSocialClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type AuthOptions =\n  | { kind: \"basic\"; clientId: string; clientSecret: string }\n  | { kind: \"bearer\"; token: string };\n\nexport interface ClientOptions {\n  baseUrl?: string;\n  auth: AuthOptions;\n  timeoutMs?: number;\n  userAgent?: string;\n}\n\nexport interface LeadItem {\n  name: string;\n  email: string;\n  company?: string;\n  source?: string;\n  [key: string]: unknown;\n}\n\nexport interface ContactNoteInput {\n  contactId: string;\n  note: string;\n  [key: string]: unknown;\n}\n\nexport interface NoteInput {\n  name: string;\n  email: string;\n  firstName?: string;\n  lastName?: string;\n  company?: string;\n  phone?: string;\n  content?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CookieRecord {\n  cookie: string;\n  duration: string;\n  description: string;\n}\n\nexport interface CookieCategoryConsent {\n  allowed: boolean;\n  cookieRecords?: CookieRecord[];\n}\n\nexport interface CookieConsentInput {\n  domain: string;\n  consentStatus: \"granted\" | \"denied\" | \"partial\" | string;\n  consentTimestamp: string; // ISO-8601\n  ipAddress?: string;\n  userAgent?: string;\n  cookiePreferences: {\n    necessary?: CookieCategoryConsent;\n    analytics?: CookieCategoryConsent;\n    marketing?: CookieCategoryConsent;\n    functional?: CookieCategoryConsent;\n    [key: string]: CookieCategoryConsent | undefined;\n  };\n}\n\nexport interface EventSignupInput {\n  contact: {\n    name: string;\n    email: string;\n    company?: string;\n  };\n  event: {\n    externalId: string;\n    name: string;\n    description?: string;\n    time: string; // ISO-8601\n    location?: string;\n    thumbnail?: string;\n  };\n}\n\nexport interface ApiResponse<T> {\n  status: number;\n  data: T;\n  headers: Record<string, string>;\n}\n\nexport interface TransactionalEmailInput {\n  to: string;\n  slug: string;\n  additionalData?: Record<string, unknown>;\n}\n\nexport class MedalSocialClient {\n  private readonly baseUrl: string;\n  private readonly auth: AuthOptions;\n  private readonly timeoutMs: number;\n  private readonly userAgent: string;\n\n  constructor(options: ClientOptions) {\n    this.baseUrl = (options.baseUrl ?? \"https://api.medalsocial.com\").replace(/\\/$/, \"\");\n    this.auth = options.auth;\n    this.timeoutMs = options.timeoutMs ?? 30000;\n    this.userAgent =\n      options.userAgent ??\n      \"medal-social-sdk/0.1.0 (+https://github.com/Medal-Social/MedalSocial.git)\";\n  }\n\n  // Public endpoints\n  /** Create one or more leads */\n  async createLead<T = unknown>(items: LeadItem[]): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/leads\", items);\n  }\n\n  /** Create a note attached to a contact by id */\n  async createContactNote<T = unknown>(input: ContactNoteInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/contacts/notes\", input);\n  }\n\n  /** Record a user’s cookie consent preferences */\n  async createCookieConsent<T = unknown>(input: CookieConsentInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/cookie-consent\", input);\n  }\n\n  /** Create an event signup with contact and event details */\n  async createEventSignup<T = unknown>(input: EventSignupInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/event-signup\", input);\n  }\n\n  /** Create a free-form note for inbound messages */\n  async createNote<T = unknown>(input: NoteInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/notes\", input);\n  }\n\n  /** Send a transactional email by template slug */\n  async sendTransactionalEmail<T = unknown>(\n    input: TransactionalEmailInput,\n  ): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/send-transactional-email\", input);\n  }\n\n  // Internal HTTP helpers\n  private async post<T>(path: string, body: unknown): Promise<ApiResponse<T>> {\n    const maxAttempts = 3;\n    let attempt = 0;\n\n    while (attempt < maxAttempts) {\n      attempt++;\n      const res = await this.fetchWithAuth(path, {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify(body),\n      });\n\n      // Retry on 429/5xx with basic backoff and Retry-After support\n      if (res.status === 429 || (res.status >= 500 && res.status <= 599)) {\n        if (attempt < maxAttempts) {\n          const retryAfter = res.headers.get(\"retry-after\");\n          let delayMs = 0;\n          if (retryAfter) {\n            const seconds = Number(retryAfter);\n            delayMs = Number.isFinite(seconds) ? seconds * 1000 : 0;\n          }\n          if (delayMs <= 0) {\n            delayMs = 250 * attempt; // linear backoff\n          }\n          await new Promise((r) => setTimeout(r, delayMs));\n          continue;\n        }\n      }\n\n      return this.handleResponse<T>(res);\n    }\n\n    throw new Error(\"Request failed after retries\");\n  }\n\n  private async fetchWithAuth(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const headers = new Headers(init.headers);\n    try {\n      headers.set(\"user-agent\", this.userAgent);\n    } catch {\n      // Some environments (e.g., browsers) disallow setting user-agent; ignore.\n    }\n\n    if (this.auth.kind === \"bearer\") {\n      headers.set(\"authorization\", `Bearer ${this.auth.token}`);\n    } else if (this.auth.kind === \"basic\") {\n      // Medal Social API expects explicit headers for client credentials\n      headers.set(\"Client-Id\", this.auth.clientId);\n      headers.set(\"Client-Secret\", this.auth.clientSecret);\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      const res = await fetch(url, { ...init, headers, signal: controller.signal });\n      return res;\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n\n  private async handleResponse<T>(res: Response): Promise<ApiResponse<T>> {\n    const text = await res.text();\n    let parsed: unknown = undefined;\n    try {\n      parsed = text ? JSON.parse(text) : undefined;\n    } catch {\n      parsed = text as unknown;\n    }\n\n    const headers: Record<string, string> = {};\n    res.headers.forEach((v, k) => {\n      headers[k] = v;\n    });\n\n    if (!res.ok) {\n      const error = new Error(`HTTP ${res.status}: ${res.statusText}`) as Error & {\n        status?: number;\n        details?: unknown;\n      };\n      error.status = res.status;\n      error.details = parsed;\n      throw error;\n    }\n\n    return { status: res.status, data: parsed as T, headers };\n  }\n}\n\nexport default MedalSocialClient;\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,116 @@
+// src/index.ts
+var MedalSocialClient = class {
+  baseUrl;
+  auth;
+  timeoutMs;
+  userAgent;
+  constructor(options) {
+    this.baseUrl = (options.baseUrl ?? "https://api.medalsocial.com").replace(/\/$/, "");
+    this.auth = options.auth;
+    this.timeoutMs = options.timeoutMs ?? 3e4;
+    this.userAgent = options.userAgent ?? "medal-social-sdk/0.1.0 (+https://github.com/Medal-Social/MedalSocial.git)";
+  }
+  // Public endpoints
+  /** Create one or more leads */
+  async createLead(items) {
+    return this.post("/v1/leads", items);
+  }
+  /** Create a note attached to a contact by id */
+  async createContactNote(input) {
+    return this.post("/v1/contacts/notes", input);
+  }
+  /** Record a user’s cookie consent preferences */
+  async createCookieConsent(input) {
+    return this.post("/v1/cookie-consent", input);
+  }
+  /** Create an event signup with contact and event details */
+  async createEventSignup(input) {
+    return this.post("/v1/event-signup", input);
+  }
+  /** Create a free-form note for inbound messages */
+  async createNote(input) {
+    return this.post("/v1/notes", input);
+  }
+  /** Send a transactional email by template slug */
+  async sendTransactionalEmail(input) {
+    return this.post("/v1/send-transactional-email", input);
+  }
+  // Internal HTTP helpers
+  async post(path, body) {
+    const maxAttempts = 3;
+    let attempt = 0;
+    while (attempt < maxAttempts) {
+      attempt++;
+      const res = await this.fetchWithAuth(path, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      if (res.status === 429 || res.status >= 500 && res.status <= 599) {
+        if (attempt < maxAttempts) {
+          const retryAfter = res.headers.get("retry-after");
+          let delayMs = 0;
+          if (retryAfter) {
+            const seconds = Number(retryAfter);
+            delayMs = Number.isFinite(seconds) ? seconds * 1e3 : 0;
+          }
+          if (delayMs <= 0) {
+            delayMs = 250 * attempt;
+          }
+          await new Promise((r) => setTimeout(r, delayMs));
+          continue;
+        }
+      }
+      return this.handleResponse(res);
+    }
+    throw new Error("Request failed after retries");
+  }
+  async fetchWithAuth(path, init) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = new Headers(init.headers);
+    try {
+      headers.set("user-agent", this.userAgent);
+    } catch {
+    }
+    if (this.auth.kind === "bearer") {
+      headers.set("authorization", `Bearer ${this.auth.token}`);
+    } else if (this.auth.kind === "basic") {
+      headers.set("Client-Id", this.auth.clientId);
+      headers.set("Client-Secret", this.auth.clientSecret);
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(url, { ...init, headers, signal: controller.signal });
+      return res;
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async handleResponse(res) {
+    const text = await res.text();
+    let parsed = void 0;
+    try {
+      parsed = text ? JSON.parse(text) : void 0;
+    } catch {
+      parsed = text;
+    }
+    const headers = {};
+    res.headers.forEach((v, k) => {
+      headers[k] = v;
+    });
+    if (!res.ok) {
+      const error = new Error(`HTTP ${res.status}: ${res.statusText}`);
+      error.status = res.status;
+      error.details = parsed;
+      throw error;
+    }
+    return { status: res.status, data: parsed, headers };
+  }
+};
+var index_default = MedalSocialClient;
+export {
+  MedalSocialClient,
+  index_default as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type AuthOptions =\n  | { kind: \"basic\"; clientId: string; clientSecret: string }\n  | { kind: \"bearer\"; token: string };\n\nexport interface ClientOptions {\n  baseUrl?: string;\n  auth: AuthOptions;\n  timeoutMs?: number;\n  userAgent?: string;\n}\n\nexport interface LeadItem {\n  name: string;\n  email: string;\n  company?: string;\n  source?: string;\n  [key: string]: unknown;\n}\n\nexport interface ContactNoteInput {\n  contactId: string;\n  note: string;\n  [key: string]: unknown;\n}\n\nexport interface NoteInput {\n  name: string;\n  email: string;\n  firstName?: string;\n  lastName?: string;\n  company?: string;\n  phone?: string;\n  content?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CookieRecord {\n  cookie: string;\n  duration: string;\n  description: string;\n}\n\nexport interface CookieCategoryConsent {\n  allowed: boolean;\n  cookieRecords?: CookieRecord[];\n}\n\nexport interface CookieConsentInput {\n  domain: string;\n  consentStatus: \"granted\" | \"denied\" | \"partial\" | string;\n  consentTimestamp: string; // ISO-8601\n  ipAddress?: string;\n  userAgent?: string;\n  cookiePreferences: {\n    necessary?: CookieCategoryConsent;\n    analytics?: CookieCategoryConsent;\n    marketing?: CookieCategoryConsent;\n    functional?: CookieCategoryConsent;\n    [key: string]: CookieCategoryConsent | undefined;\n  };\n}\n\nexport interface EventSignupInput {\n  contact: {\n    name: string;\n    email: string;\n    company?: string;\n  };\n  event: {\n    externalId: string;\n    name: string;\n    description?: string;\n    time: string; // ISO-8601\n    location?: string;\n    thumbnail?: string;\n  };\n}\n\nexport interface ApiResponse<T> {\n  status: number;\n  data: T;\n  headers: Record<string, string>;\n}\n\nexport interface TransactionalEmailInput {\n  to: string;\n  slug: string;\n  additionalData?: Record<string, unknown>;\n}\n\nexport class MedalSocialClient {\n  private readonly baseUrl: string;\n  private readonly auth: AuthOptions;\n  private readonly timeoutMs: number;\n  private readonly userAgent: string;\n\n  constructor(options: ClientOptions) {\n    this.baseUrl = (options.baseUrl ?? \"https://api.medalsocial.com\").replace(/\\/$/, \"\");\n    this.auth = options.auth;\n    this.timeoutMs = options.timeoutMs ?? 30000;\n    this.userAgent =\n      options.userAgent ??\n      \"medal-social-sdk/0.1.0 (+https://github.com/Medal-Social/MedalSocial.git)\";\n  }\n\n  // Public endpoints\n  /** Create one or more leads */\n  async createLead<T = unknown>(items: LeadItem[]): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/leads\", items);\n  }\n\n  /** Create a note attached to a contact by id */\n  async createContactNote<T = unknown>(input: ContactNoteInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/contacts/notes\", input);\n  }\n\n  /** Record a user’s cookie consent preferences */\n  async createCookieConsent<T = unknown>(input: CookieConsentInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/cookie-consent\", input);\n  }\n\n  /** Create an event signup with contact and event details */\n  async createEventSignup<T = unknown>(input: EventSignupInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/event-signup\", input);\n  }\n\n  /** Create a free-form note for inbound messages */\n  async createNote<T = unknown>(input: NoteInput): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/notes\", input);\n  }\n\n  /** Send a transactional email by template slug */\n  async sendTransactionalEmail<T = unknown>(\n    input: TransactionalEmailInput,\n  ): Promise<ApiResponse<T>> {\n    return this.post<T>(\"/v1/send-transactional-email\", input);\n  }\n\n  // Internal HTTP helpers\n  private async post<T>(path: string, body: unknown): Promise<ApiResponse<T>> {\n    const maxAttempts = 3;\n    let attempt = 0;\n\n    while (attempt < maxAttempts) {\n      attempt++;\n      const res = await this.fetchWithAuth(path, {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify(body),\n      });\n\n      // Retry on 429/5xx with basic backoff and Retry-After support\n      if (res.status === 429 || (res.status >= 500 && res.status <= 599)) {\n        if (attempt < maxAttempts) {\n          const retryAfter = res.headers.get(\"retry-after\");\n          let delayMs = 0;\n          if (retryAfter) {\n            const seconds = Number(retryAfter);\n            delayMs = Number.isFinite(seconds) ? seconds * 1000 : 0;\n          }\n          if (delayMs <= 0) {\n            delayMs = 250 * attempt; // linear backoff\n          }\n          await new Promise((r) => setTimeout(r, delayMs));\n          continue;\n        }\n      }\n\n      return this.handleResponse<T>(res);\n    }\n\n    throw new Error(\"Request failed after retries\");\n  }\n\n  private async fetchWithAuth(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const headers = new Headers(init.headers);\n    try {\n      headers.set(\"user-agent\", this.userAgent);\n    } catch {\n      // Some environments (e.g., browsers) disallow setting user-agent; ignore.\n    }\n\n    if (this.auth.kind === \"bearer\") {\n      headers.set(\"authorization\", `Bearer ${this.auth.token}`);\n    } else if (this.auth.kind === \"basic\") {\n      // Medal Social API expects explicit headers for client credentials\n      headers.set(\"Client-Id\", this.auth.clientId);\n      headers.set(\"Client-Secret\", this.auth.clientSecret);\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      const res = await fetch(url, { ...init, headers, signal: controller.signal });\n      return res;\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n\n  private async handleResponse<T>(res: Response): Promise<ApiResponse<T>> {\n    const text = await res.text();\n    let parsed: unknown = undefined;\n    try {\n      parsed = text ? JSON.parse(text) : undefined;\n    } catch {\n      parsed = text as unknown;\n    }\n\n    const headers: Record<string, string> = {};\n    res.headers.forEach((v, k) => {\n      headers[k] = v;\n    });\n\n    if (!res.ok) {\n      const error = new Error(`HTTP ${res.status}: ${res.statusText}`) as Error & {\n        status?: number;\n        details?: unknown;\n      };\n      error.status = res.status;\n      error.details = parsed;\n      throw error;\n    }\n\n    return { status: res.status, data: parsed as T, headers };\n  }\n}\n\nexport default MedalSocialClient;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@medalsocial/sdk",
+  "version": "0.1.1",
+  "description": "TypeScript client for Medal Social API (create leads, notes, cookie consents, event signups)",
+  "license": "MIT",
+  "author": "Medal Social / Ali Aljumaili",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Medal-Social/MedalSocial.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Medal-Social/MedalSocial/issues"
+  },
+  "homepage": "https://github.com/Medal-Social/MedalSocial#readme",
+  "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"
+    }
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "medal",
+    "social",
+    "sdk",
+    "api",
+    "typescript",
+    "client"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.3.2",
+    "@vitest/coverage-v8": "^2.0.5",
+    "typedoc": "^0.26.6",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5",
+    "@biomejs/biome": "^1.8.3",
+    "@commitlint/cli": "^19.4.0",
+    "@commitlint/config-conventional": "^19.4.0",
+    "husky": "^9.1.6"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --dts --format esm,cjs --sourcemap",
+    "dev": "tsup src/index.ts --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "docs": "typedoc",
+    "lint": "biome check .",
+    "format": "biome format ."
+  }
+}