@atzentis/crossmedia-sdk 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# @atzentis/crossmedia-sdk
+
+## 1.0.0
+
+### Minor Changes
+
+- [`c9d8b81`](https://github.com/atzentis/crossmedia-sdk/commit/c9d8b81c4294d6d372492fd1486f9879b0f006e9) Thanks [@vassilibo](https://github.com/vassilibo)! - Initial public release of the Atzentis Crossmedia SDK.
+
+  Typed client for cross-network publishing (Instagram, TikTok, YouTube, Facebook, X, LinkedIn) and cross-network analytics.
+
+  - `@atzentis/crossmedia-sdk` — core HTTP client + typed error hierarchy
+  - `@atzentis/crossmedia-react` — provider + hooks
+  - `@atzentis/crossmedia-expo` — React Native / Expo surface
+  - `@atzentis/crossmedia-locales` — i18n locale packs
+
+  Consumed by Cyclus studio P11–P12 (greenfield, no local fallback).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Atzentis
+
+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,22 @@
+# @atzentis/crossmedia-sdk
+
+TypeScript client for the Atzentis Crossmedia publishing API.
+
+## Install
+
+```bash
+pnpm add @atzentis/crossmedia-sdk
+```
+
+## Usage
+
+```typescript
+import { CrossmediaClient } from "@atzentis/crossmedia-sdk";
+
+const client = new CrossmediaClient({
+  baseUrl: "https://api.atzentis.ai",
+  apiKey: "atz_live_...",
+});
+```
+
+See the [repository README](../../README.md) for development setup.

package/dist/index.d.ts

@@ -0,0 +1,274 @@
+import { z } from 'zod';
+
+/**
+ * CrossmediaClient configuration.
+ * Customize the API base URL and behavior.
+ */
+type ClientConfig = {
+    /**
+     * API key for authenticated requests.
+     */
+    readonly apiKey?: string;
+    /**
+     * Tenant identifier (multi-tenant SDKs).
+     */
+    readonly tenantId?: string;
+    /**
+     * Base URL for API requests. Defaults to api.atzentis.ai.
+     */
+    readonly baseUrl?: string;
+    /**
+     * Request timeout in milliseconds. Defaults to 30000 (30 seconds).
+     */
+    readonly timeoutMs?: number;
+    /**
+     * Maximum number of automatic retries on network errors. Defaults to 3.
+     */
+    readonly maxRetries?: number;
+    /**
+     * Override the User-Agent string sent on every request. Defaults to
+     * `@atzentis/crossmedia/${VERSION}`.
+     */
+    readonly userAgent?: string;
+    /**
+     * Custom fetch implementation. Useful for testing (mock fetch) or
+     * Node.js environments before fetch became global.
+     */
+    readonly fetch?: typeof fetch;
+};
+/** HTTP methods supported by HttpClient. */
+type HttpMethod = "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+/** Per-request overrides passed to HttpClient methods. */
+type RequestOptions = {
+    readonly headers?: Record<string, string>;
+    readonly query?: Record<string, unknown>;
+    readonly body?: unknown;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+};
+/**
+ * HTTP request context.
+ * Contains headers, method, and body for a request.
+ */
+type HttpRequest = {
+    readonly method: "GET" | "POST" | "PATCH" | "DELETE" | "PUT" | "HEAD" | "OPTIONS";
+    readonly url: string;
+    readonly headers: Record<string, string>;
+    readonly body?: unknown;
+};
+/**
+ * HTTP response context.
+ * Contains status, headers, and deserialized body.
+ */
+type HttpResponse<T = unknown> = {
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers: Record<string, string>;
+    readonly data: T;
+};
+
+/**
+ * Request interceptor — transform or inspect outgoing requests.
+ */
+type RequestInterceptor = (init: RequestInit) => Promise<RequestInit | undefined> | RequestInit | undefined;
+/**
+ * Response interceptor — inspect responses or handle errors.
+ */
+type ResponseInterceptor = (response: Response) => Promise<void> | void;
+/**
+ * Interceptor manager — maintains a list of interceptors and provides removal.
+ */
+declare class InterceptorManager<T> {
+    readonly handlers: (T | null)[];
+    /**
+     * Add an interceptor and return a function to remove it.
+     */
+    use(handler: T): () => void;
+}
+
+interface HttpClientConfig extends ClientConfig {
+    readonly userAgent: string;
+}
+/**
+ * HttpClient — transport for @atzentis/crossmedia.
+ *
+ * Encapsulates fetch + retry + interceptors. Services depend on this class
+ * (not the public CrossmediaClient) so they remain testable in isolation.
+ * The top-level CrossmediaClient composes an HttpClient instance.
+ */
+declare class HttpClient {
+    readonly baseUrl: string;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly userAgent;
+    private readonly fetchImpl;
+    private readonly requestInterceptors;
+    private readonly responseInterceptors;
+    constructor(config: HttpClientConfig);
+    /** Add a request interceptor (e.g., for auth headers). */
+    interceptRequest(interceptor: RequestInterceptor): {
+        remove: () => void;
+    };
+    /** Add a response interceptor (e.g., for error mapping). */
+    interceptResponse(interceptor: ResponseInterceptor): {
+        remove: () => void;
+    };
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    request<T>(method: HttpMethod, path: string, options?: RequestOptions): Promise<T>;
+    private withBody;
+}
+
+declare const VERSION = "0.1.0";
+/**
+ * Main entry point for @atzentis/crossmedia-sdk.
+ * Service properties are attached in later phases (P02–P05).
+ */
+declare class CrossmediaClient {
+    private readonly http;
+    constructor(config: ClientConfig);
+    /** Internal transport — used by service classes in P02+. */
+    getHttpClient(): HttpClient;
+}
+
+/**
+ * Retry configuration.
+ */
+interface RetryConfig {
+    readonly maxAttempts?: number;
+    readonly initialDelayMs?: number;
+    readonly maxDelayMs?: number;
+    readonly backoffMultiplier?: number;
+}
+/**
+ * Exponential backoff retry strategy.
+ * Retries on network errors or specific HTTP status codes (5xx, 429).
+ */
+declare function retryWithBackoff<T>(fn: () => Promise<T>, config?: RetryConfig): Promise<T>;
+
+/**
+ * Base error class for all Crossmedia SDK errors.
+ * Extend this class to create domain-specific error types.
+ */
+declare class BaseError extends Error {
+    readonly name: string;
+    readonly code: string;
+    readonly statusCode?: number;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: string, statusCode?: number, details?: Record<string, unknown>);
+}
+
+/**
+ * Raised when authentication fails (invalid or missing credentials).
+ * Typically a 401 Unauthorized error.
+ */
+declare class AuthenticationError extends BaseError {
+    readonly name = "AuthenticationError";
+    constructor(message?: string);
+}
+
+/**
+ * Raised when a requested resource is not found.
+ * Typically a 404 Not Found error.
+ */
+declare class NotFoundError extends BaseError {
+    readonly name = "NotFoundError";
+    constructor(resourceType: string, resourceId: string);
+}
+
+/**
+ * Raised when user lacks permission for the requested operation.
+ * Typically a 403 Forbidden error.
+ */
+declare class PermissionError extends BaseError {
+    readonly name = "PermissionError";
+    constructor(message?: string);
+}
+
+/**
+ * Raised when rate limit is exceeded.
+ * Typically a 429 Too Many Requests error.
+ * Includes retry-after timing information.
+ */
+declare class RateLimitError extends BaseError {
+    readonly name = "RateLimitError";
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+}
+
+/**
+ * Raised when request validation fails.
+ * Typically a 400 Bad Request error.
+ */
+declare class ValidationError extends BaseError {
+    readonly name = "ValidationError";
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+
+/** Raised when a network connection cannot be established. */
+declare class ConnectionError extends BaseError {
+    readonly name = "ConnectionError";
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+
+/**
+ * Raised when a network request fails (connection timeout, DNS failure, etc.).
+ * Domain error — not mapped to an HTTP status code.
+ */
+declare class NetworkError extends BaseError {
+    readonly name = "NetworkError";
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+
+/**
+ * Base class for Crossmedia SDK domain services.
+ * Each service receives HttpClient (not CrossmediaClient) for isolated testing.
+ */
+declare class BaseService {
+    protected readonly client: HttpClient;
+    protected readonly resource: string;
+    constructor(client: HttpClient, resource: string);
+    protected path(id?: string): string;
+    protected httpGet<T>(path: string): Promise<T>;
+    protected httpPost<T>(path: string, body?: unknown): Promise<T>;
+    protected httpDelete<T>(path: string): Promise<T>;
+}
+
+/**
+ * Paginated result wrapper.
+ * Indicates whether more results are available and provides next cursor.
+ */
+type PaginatedResult<T> = {
+    readonly items: T[];
+    readonly hasNextPage: boolean;
+    readonly nextCursor?: string;
+};
+/**
+ * Cursor-based pagination parameters.
+ * Use for requesting the next page of results.
+ */
+type CursorPageParams = {
+    readonly cursor?: string;
+    readonly limit?: number;
+};
+
+/**
+ * Pagination schema for list endpoints.
+ * Supports cursor-based pagination with configurable limit.
+ */
+declare const paginationSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodEnum<["start", "middle", "end"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    cursor?: "start" | "middle" | "end" | undefined;
+}, {
+    cursor?: "start" | "middle" | "end" | undefined;
+    limit?: number | undefined;
+}>;
+type PaginationParams = z.infer<typeof paginationSchema>;
+
+export { AuthenticationError, BaseError, BaseService, type ClientConfig, ConnectionError, CrossmediaClient, type CursorPageParams, HttpClient, type HttpClientConfig, type HttpMethod, type HttpRequest, type HttpResponse, InterceptorManager, NetworkError, NotFoundError, type PaginatedResult, type PaginationParams, PermissionError, RateLimitError, type RequestInterceptor, type RequestOptions, type ResponseInterceptor, type RetryConfig, VERSION, ValidationError, paginationSchema, retryWithBackoff };

package/dist/index.js

@@ -0,0 +1,256 @@
+import { z } from 'zod';
+
+// src/http/interceptors.ts
+var InterceptorManager = class {
+  handlers = [];
+  /**
+   * Add an interceptor and return a function to remove it.
+   */
+  use(handler) {
+    const id = this.handlers.length;
+    this.handlers.push(handler);
+    return () => {
+      this.handlers[id] = null;
+    };
+  }
+};
+
+// src/http/retry.ts
+async function retryWithBackoff(fn, config = {}) {
+  const maxAttempts = config.maxAttempts ?? 3;
+  const initialDelayMs = config.initialDelayMs ?? 100;
+  const maxDelayMs = config.maxDelayMs ?? 5e3;
+  const backoffMultiplier = config.backoffMultiplier ?? 2;
+  let lastError;
+  let delayMs = initialDelayMs;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (attempt === maxAttempts) {
+        break;
+      }
+      await sleep(delayMs);
+      delayMs = Math.min(delayMs * backoffMultiplier, maxDelayMs);
+    }
+  }
+  throw lastError;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/http/client.ts
+var DEFAULT_BASE_URL = "https://api.atzentis.ai";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var HttpClient = class {
+  baseUrl;
+  timeoutMs;
+  maxRetries;
+  userAgent;
+  fetchImpl;
+  requestInterceptors;
+  responseInterceptors;
+  constructor(config) {
+    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.maxRetries = config.maxRetries ?? 3;
+    this.userAgent = config.userAgent;
+    this.fetchImpl = config.fetch ?? globalThis.fetch?.bind(globalThis);
+    this.requestInterceptors = new InterceptorManager();
+    this.responseInterceptors = new InterceptorManager();
+  }
+  /** Add a request interceptor (e.g., for auth headers). */
+  interceptRequest(interceptor) {
+    const remove = this.requestInterceptors.use(interceptor);
+    return { remove };
+  }
+  /** Add a response interceptor (e.g., for error mapping). */
+  interceptResponse(interceptor) {
+    const remove = this.responseInterceptors.use(interceptor);
+    return { remove };
+  }
+  get(path, options) {
+    return this.request("GET", path, options);
+  }
+  post(path, body, options) {
+    return this.request("POST", path, this.withBody(body, options));
+  }
+  patch(path, body, options) {
+    return this.request("PATCH", path, this.withBody(body, options));
+  }
+  put(path, body, options) {
+    return this.request("PUT", path, this.withBody(body, options));
+  }
+  delete(path, options) {
+    return this.request("DELETE", path, options);
+  }
+  async request(method, path, options) {
+    return retryWithBackoff(
+      async () => {
+        const url = new URL(path, this.baseUrl).toString();
+        const headers = {
+          "content-type": "application/json",
+          accept: "application/json",
+          "user-agent": this.userAgent,
+          ...options?.headers ?? {}
+        };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        const init = {
+          method,
+          headers,
+          ...options?.body !== void 0 && {
+            body: typeof options.body === "string" ? options.body : JSON.stringify(options.body)
+          },
+          signal: options?.signal ?? controller.signal
+        };
+        let response;
+        try {
+          response = await this.fetchImpl(url, init);
+        } finally {
+          clearTimeout(timeoutId);
+        }
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        }
+        return await response.json();
+      },
+      { maxAttempts: this.maxRetries }
+    );
+  }
+  withBody(body, options) {
+    if (body === void 0) return options ?? {};
+    return { ...options, body };
+  }
+};
+
+// src/client.ts
+var VERSION = "0.1.0";
+var CrossmediaClient = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient({
+      ...config,
+      userAgent: `@atzentis/crossmedia-sdk/${VERSION}`
+    });
+  }
+  /** Internal transport — used by service classes in P02+. */
+  getHttpClient() {
+    return this.http;
+  }
+};
+
+// src/errors/base.ts
+var BaseError = class extends Error {
+  name = "BaseError";
+  code;
+  statusCode;
+  details;
+  constructor(message, code, statusCode, details) {
+    super(message);
+    this.code = code;
+    if (statusCode !== void 0) {
+      this.statusCode = statusCode;
+    }
+    if (details !== void 0) {
+      this.details = details;
+    }
+    const errorWithCapture = Error;
+    errorWithCapture.captureStackTrace?.(this, this.constructor);
+  }
+};
+
+// src/errors/http/authentication.error.ts
+var AuthenticationError = class extends BaseError {
+  name = "AuthenticationError";
+  constructor(message = "Authentication failed") {
+    super(message, "AUTHENTICATION_ERROR", 401);
+  }
+};
+
+// src/errors/http/not-found.error.ts
+var NotFoundError = class extends BaseError {
+  name = "NotFoundError";
+  constructor(resourceType, resourceId) {
+    const message = `${resourceType} with id "${resourceId}" not found`;
+    super(message, "NOT_FOUND_ERROR", 404);
+  }
+};
+
+// src/errors/http/permission.error.ts
+var PermissionError = class extends BaseError {
+  name = "PermissionError";
+  constructor(message = "Permission denied") {
+    super(message, "PERMISSION_ERROR", 403);
+  }
+};
+
+// src/errors/http/rate-limit.error.ts
+var RateLimitError = class extends BaseError {
+  name = "RateLimitError";
+  retryAfter;
+  // milliseconds
+  constructor(message = "Rate limit exceeded", retryAfter) {
+    super(message, "RATE_LIMIT_ERROR", 429);
+    if (retryAfter !== void 0) {
+      this.retryAfter = retryAfter;
+    }
+  }
+};
+
+// src/errors/http/validation.error.ts
+var ValidationError = class extends BaseError {
+  name = "ValidationError";
+  constructor(message = "Validation failed", details) {
+    super(message, "VALIDATION_ERROR", 400, details);
+  }
+};
+
+// src/errors/domain/connection.error.ts
+var ConnectionError = class extends BaseError {
+  name = "ConnectionError";
+  constructor(message = "Connection failed", details) {
+    super(message, "CONNECTION_ERROR", void 0, details);
+  }
+};
+
+// src/errors/domain/network.error.ts
+var NetworkError = class extends BaseError {
+  name = "NetworkError";
+  constructor(message = "Network request failed", details) {
+    super(message, "NETWORK_ERROR", void 0, details);
+  }
+};
+
+// src/services/base.service.ts
+var BaseService = class {
+  client;
+  resource;
+  constructor(client, resource) {
+    this.client = client;
+    this.resource = resource;
+  }
+  path(id) {
+    return id ? `/${this.resource}/${id}` : `/${this.resource}`;
+  }
+  httpGet(path) {
+    return this.client.get(path);
+  }
+  httpPost(path, body) {
+    return this.client.post(path, body);
+  }
+  httpDelete(path) {
+    return this.client.delete(path);
+  }
+};
+var PAGINATION_CURSORS = ["start", "middle", "end"];
+var paginationSchema = z.object({
+  cursor: z.enum(PAGINATION_CURSORS).optional(),
+  limit: z.number().int().min(1).max(100).default(20)
+});
+
+export { AuthenticationError, BaseError, BaseService, ConnectionError, CrossmediaClient, HttpClient, InterceptorManager, NetworkError, NotFoundError, PermissionError, RateLimitError, VERSION, ValidationError, paginationSchema, retryWithBackoff };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http/interceptors.ts","../src/http/retry.ts","../src/http/client.ts","../src/client.ts","../src/errors/base.ts","../src/errors/http/authentication.error.ts","../src/errors/http/not-found.error.ts","../src/errors/http/permission.error.ts","../src/errors/http/rate-limit.error.ts","../src/errors/http/validation.error.ts","../src/errors/domain/connection.error.ts","../src/errors/domain/network.error.ts","../src/services/base.service.ts","../src/schemas/shared.schema.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Request interceptor — transform or inspect outgoing requests.\n */\nexport type RequestInterceptor = (\n  init: RequestInit,\n) => Promise<RequestInit | undefined> | RequestInit | undefined;\n\n/**\n * Response interceptor — inspect responses or handle errors.\n */\nexport type ResponseInterceptor = (response: Response) => Promise<void> | void;\n\n/**\n * Interceptor manager — maintains a list of interceptors and provides removal.\n */\nexport class InterceptorManager<T> {\n  readonly handlers: (T | null)[] = [];\n\n  /**\n   * Add an interceptor and return a function to remove it.\n   */\n  use(handler: T): () => void {\n    const id = this.handlers.length;\n    this.handlers.push(handler);\n\n    return () => {\n      this.handlers[id] = null;\n    };\n  }\n}\n","/**\n * Retry configuration.\n */\nexport interface RetryConfig {\n  readonly maxAttempts?: number;\n  readonly initialDelayMs?: number;\n  readonly maxDelayMs?: number;\n  readonly backoffMultiplier?: number;\n}\n\n/**\n * Exponential backoff retry strategy.\n * Retries on network errors or specific HTTP status codes (5xx, 429).\n */\nexport async function retryWithBackoff<T>(\n  fn: () => Promise<T>,\n  config: RetryConfig = {},\n): Promise<T> {\n  const maxAttempts = config.maxAttempts ?? 3;\n  const initialDelayMs = config.initialDelayMs ?? 100;\n  const maxDelayMs = config.maxDelayMs ?? 5000;\n  const backoffMultiplier = config.backoffMultiplier ?? 2;\n\n  let lastError: unknown;\n  let delayMs = initialDelayMs;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error;\n\n      // Don't retry on the last attempt\n      if (attempt === maxAttempts) {\n        break;\n      }\n\n      // Wait before retrying\n      await sleep(delayMs);\n      delayMs = Math.min(delayMs * backoffMultiplier, maxDelayMs);\n    }\n  }\n\n  throw lastError;\n}\n\n/**\n * Sleep for a given duration.\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { ClientConfig, HttpMethod, RequestOptions } from \"../types/http.types.js\";\nimport type { RequestInterceptor, ResponseInterceptor } from \"./interceptors.js\";\nimport { InterceptorManager } from \"./interceptors.js\";\nimport { retryWithBackoff } from \"./retry.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.atzentis.ai\";\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\nexport interface HttpClientConfig extends ClientConfig {\n  readonly userAgent: string;\n}\n\n/**\n * HttpClient — transport for @atzentis/crossmedia.\n *\n * Encapsulates fetch + retry + interceptors. Services depend on this class\n * (not the public CrossmediaClient) so they remain testable in isolation.\n * The top-level CrossmediaClient composes an HttpClient instance.\n */\nexport class HttpClient {\n  readonly baseUrl: string;\n  private readonly timeoutMs: number;\n  private readonly maxRetries: number;\n  private readonly userAgent: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly requestInterceptors: InterceptorManager<RequestInterceptor>;\n  private readonly responseInterceptors: InterceptorManager<ResponseInterceptor>;\n\n  constructor(config: HttpClientConfig) {\n    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;\n    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.maxRetries = config.maxRetries ?? 3;\n    this.userAgent = config.userAgent;\n    this.fetchImpl = config.fetch ?? globalThis.fetch?.bind(globalThis);\n    this.requestInterceptors = new InterceptorManager();\n    this.responseInterceptors = new InterceptorManager();\n  }\n\n  /** Add a request interceptor (e.g., for auth headers). */\n  interceptRequest(interceptor: RequestInterceptor): { remove: () => void } {\n    const remove = this.requestInterceptors.use(interceptor);\n    return { remove };\n  }\n\n  /** Add a response interceptor (e.g., for error mapping). */\n  interceptResponse(interceptor: ResponseInterceptor): { remove: () => void } {\n    const remove = this.responseInterceptors.use(interceptor);\n    return { remove };\n  }\n\n  get<T>(path: string, options?: RequestOptions): Promise<T> {\n    return this.request<T>(\"GET\", path, options);\n  }\n\n  post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T> {\n    return this.request<T>(\"POST\", path, this.withBody(body, options));\n  }\n\n  patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T> {\n    return this.request<T>(\"PATCH\", path, this.withBody(body, options));\n  }\n\n  put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T> {\n    return this.request<T>(\"PUT\", path, this.withBody(body, options));\n  }\n\n  delete<T>(path: string, options?: RequestOptions): Promise<T> {\n    return this.request<T>(\"DELETE\", path, options);\n  }\n\n  async request<T>(method: HttpMethod, path: string, options?: RequestOptions): Promise<T> {\n    return retryWithBackoff(\n      async () => {\n        const url = new URL(path, this.baseUrl).toString();\n        const headers: Record<string, string> = {\n          \"content-type\": \"application/json\",\n          accept: \"application/json\",\n          \"user-agent\": this.userAgent,\n          ...(options?.headers ?? {}),\n        };\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);\n        const init: RequestInit = {\n          method,\n          headers,\n          ...(options?.body !== undefined && {\n            body: typeof options.body === \"string\" ? options.body : JSON.stringify(options.body),\n          }),\n          signal: options?.signal ?? controller.signal,\n        };\n        let response: Response;\n        try {\n          response = await this.fetchImpl(url, init);\n        } finally {\n          clearTimeout(timeoutId);\n        }\n        if (!response.ok) {\n          throw new Error(`HTTP ${response.status} ${response.statusText}`);\n        }\n        return (await response.json()) as T;\n      },\n      { maxAttempts: this.maxRetries },\n    );\n  }\n\n  private withBody(body: unknown, options: RequestOptions | undefined): RequestOptions {\n    if (body === undefined) return options ?? {};\n    return { ...options, body };\n  }\n}\n","import { HttpClient } from \"./http/client.js\";\nimport type { ClientConfig } from \"./types/http.types.js\";\n\nexport const VERSION = \"0.1.0\";\n\n/**\n * Main entry point for @atzentis/crossmedia-sdk.\n * Service properties are attached in later phases (P02–P05).\n */\nexport class CrossmediaClient {\n  private readonly http: HttpClient;\n\n  constructor(config: ClientConfig) {\n    this.http = new HttpClient({\n      ...config,\n      userAgent: `@atzentis/crossmedia-sdk/${VERSION}`,\n    });\n  }\n\n  /** Internal transport — used by service classes in P02+. */\n  getHttpClient(): HttpClient {\n    return this.http;\n  }\n}\n","/**\n * Base error class for all Crossmedia SDK errors.\n * Extend this class to create domain-specific error types.\n */\nexport class BaseError extends Error {\n  readonly name: string = \"BaseError\";\n  readonly code: string;\n  readonly statusCode?: number;\n  readonly details?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    code: string,\n    statusCode?: number,\n    details?: Record<string, unknown>,\n  ) {\n    super(message);\n    this.code = code;\n    if (statusCode !== undefined) {\n      this.statusCode = statusCode;\n    }\n    if (details !== undefined) {\n      this.details = details;\n    }\n\n    const errorWithCapture = Error as typeof Error & {\n      captureStackTrace?: (target: object, ctor: new (...args: never[]) => Error) => void;\n    };\n    errorWithCapture.captureStackTrace?.(this, this.constructor as new (...args: never[]) => Error);\n  }\n}\n","import { BaseError } from \"../base.js\";\n\n/**\n * Raised when authentication fails (invalid or missing credentials).\n * Typically a 401 Unauthorized error.\n */\nexport class AuthenticationError extends BaseError {\n  override readonly name = \"AuthenticationError\";\n\n  constructor(message = \"Authentication failed\") {\n    super(message, \"AUTHENTICATION_ERROR\", 401);\n  }\n}\n","import { BaseError } from \"../base.js\";\n\n/**\n * Raised when a requested resource is not found.\n * Typically a 404 Not Found error.\n */\nexport class NotFoundError extends BaseError {\n  override readonly name = \"NotFoundError\";\n\n  constructor(resourceType: string, resourceId: string) {\n    const message = `${resourceType} with id \"${resourceId}\" not found`;\n    super(message, \"NOT_FOUND_ERROR\", 404);\n  }\n}\n","import { BaseError } from \"../base.js\";\n\n/**\n * Raised when user lacks permission for the requested operation.\n * Typically a 403 Forbidden error.\n */\nexport class PermissionError extends BaseError {\n  override readonly name = \"PermissionError\";\n\n  constructor(message = \"Permission denied\") {\n    super(message, \"PERMISSION_ERROR\", 403);\n  }\n}\n","import { BaseError } from \"../base.js\";\n\n/**\n * Raised when rate limit is exceeded.\n * Typically a 429 Too Many Requests error.\n * Includes retry-after timing information.\n */\nexport class RateLimitError extends BaseError {\n  override readonly name = \"RateLimitError\";\n  readonly retryAfter?: number; // milliseconds\n\n  constructor(message = \"Rate limit exceeded\", retryAfter?: number) {\n    super(message, \"RATE_LIMIT_ERROR\", 429);\n    if (retryAfter !== undefined) {\n      this.retryAfter = retryAfter;\n    }\n  }\n}\n","import { BaseError } from \"../base.js\";\n\n/**\n * Raised when request validation fails.\n * Typically a 400 Bad Request error.\n */\nexport class ValidationError extends BaseError {\n  override readonly name = \"ValidationError\";\n\n  constructor(message = \"Validation failed\", details?: Record<string, unknown>) {\n    super(message, \"VALIDATION_ERROR\", 400, details);\n  }\n}\n","import { BaseError } from \"../base.js\";\n\n/** Raised when a network connection cannot be established. */\nexport class ConnectionError extends BaseError {\n  override readonly name = \"ConnectionError\";\n\n  constructor(message = \"Connection failed\", details?: Record<string, unknown>) {\n    super(message, \"CONNECTION_ERROR\", undefined, details);\n  }\n}\n","import { BaseError } from \"../base.js\";\n\n/**\n * Raised when a network request fails (connection timeout, DNS failure, etc.).\n * Domain error — not mapped to an HTTP status code.\n */\nexport class NetworkError extends BaseError {\n  override readonly name = \"NetworkError\";\n\n  constructor(message = \"Network request failed\", details?: Record<string, unknown>) {\n    super(message, \"NETWORK_ERROR\", undefined, details);\n  }\n}\n","import type { HttpClient } from \"../http/client.js\";\n\n/**\n * Base class for Crossmedia SDK domain services.\n * Each service receives HttpClient (not CrossmediaClient) for isolated testing.\n */\nexport class BaseService {\n  protected readonly client: HttpClient;\n  protected readonly resource: string;\n\n  constructor(client: HttpClient, resource: string) {\n    this.client = client;\n    this.resource = resource;\n  }\n\n  protected path(id?: string): string {\n    return id ? `/${this.resource}/${id}` : `/${this.resource}`;\n  }\n\n  protected httpGet<T>(path: string): Promise<T> {\n    return this.client.get<T>(path);\n  }\n\n  protected httpPost<T>(path: string, body?: unknown): Promise<T> {\n    return this.client.post<T>(path, body);\n  }\n\n  protected httpDelete<T>(path: string): Promise<T> {\n    return this.client.delete<T>(path);\n  }\n}\n","import { z } from \"zod\";\n\n/**\n * Cursor-based pagination constants.\n * Single source of truth for valid pagination cursor values.\n */\nexport const PAGINATION_CURSORS = [\"start\", \"middle\", \"end\"] as const;\nexport type PaginationCursor = (typeof PAGINATION_CURSORS)[number];\n\n/**\n * Pagination schema for list endpoints.\n * Supports cursor-based pagination with configurable limit.\n */\nexport const paginationSchema = z.object({\n  cursor: z.enum(PAGINATION_CURSORS).optional(),\n  limit: z.number().int().min(1).max(100).default(20),\n});\n\nexport type PaginationParams = z.infer<typeof paginationSchema>;\n\n/**\n * Standard sorting directions.\n */\nexport const SORT_DIRECTIONS = [\"asc\", \"desc\"] as const;\nexport type SortDirection = (typeof SORT_DIRECTIONS)[number];\n"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@atzentis/crossmedia-sdk",
+  "version": "1.0.0",
+  "description": "Atzentis Crossmedia SDK — TypeScript client for api.atzentis.ai",
+  "keywords": [
+    "atzentis",
+    "crossmedia",
+    "sdk",
+    "client",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Atzentis <dev@atzentis.com> (https://atzentis.com)",
+  "homepage": "https://github.com/atzentis/atzentis-crossmedia-sdk/tree/main/packages/core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atzentis/atzentis-crossmedia-sdk.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "peerDependencies": {
+    "zod": "^3.23.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0",
+    "zod": "^3.23.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit"
+  }
+}