@addn/sdk 1.0.0

package/dist/types/project.types.d.ts

@@ -0,0 +1,20 @@
+export interface Project {
+    id: string;
+    organization_id: string;
+    customer_id?: string | null;
+    name: string;
+    description?: string;
+    status: "active" | "archived" | "draft";
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateProjectPayload {
+    name: string;
+    customer_id?: string;
+    description?: string;
+}
+export interface UpdateProjectPayload extends Partial<CreateProjectPayload> {
+    status?: "active" | "archived" | "draft";
+}
+//# sourceMappingURL=project.types.d.ts.map

package/dist/types/project.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.types.d.ts","sourceRoot":"","sources":["../../src/types/project.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAqB,SAAQ,OAAO,CAAC,oBAAoB,CAAC;IACzE,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;CAC1C"}

package/dist/types/project.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=project.types.js.map

package/dist/types/project.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.types.js","sourceRoot":"","sources":["../../src/types/project.types.ts"],"names":[],"mappings":""}

package/dist/types/scheduling.types.d.ts

@@ -0,0 +1,31 @@
+export interface ScheduledPost {
+    id: string;
+    post_id: string;
+    account_id: string;
+    platform: "instagram" | "facebook" | "linkedin";
+    caption: string;
+    media_urls: string[];
+    scheduled_time: string;
+    status: "scheduled" | "processing" | "published" | "failed";
+    error_message?: string;
+    approval_token?: string;
+}
+export interface PublicApprovalView {
+    token: string;
+    project_name: string;
+    posts: Array<{
+        id: string;
+        title: string;
+        caption: string;
+        media_urls: string[];
+        post_type: string;
+        status: string;
+    }>;
+}
+export interface SubmitApprovalPayload {
+    token: string;
+    post_id: string;
+    action: "approve" | "reject";
+    comment?: string;
+}
+//# sourceMappingURL=scheduling.types.d.ts.map

package/dist/types/scheduling.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.types.d.ts","sourceRoot":"","sources":["../../src/types/scheduling.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/scheduling.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=scheduling.types.js.map

package/dist/types/scheduling.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.types.js","sourceRoot":"","sources":["../../src/types/scheduling.types.ts"],"names":[],"mappings":""}

package/dist/types/storage.types.d.ts

@@ -0,0 +1,8 @@
+export interface UploadFileResponse {
+    file_id: string;
+    url: string;
+    filename: string;
+    size_bytes: number;
+    mime_type: string;
+}
+//# sourceMappingURL=storage.types.d.ts.map

package/dist/types/storage.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.types.d.ts","sourceRoot":"","sources":["../../src/types/storage.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/storage.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=storage.types.js.map

package/dist/types/storage.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.types.js","sourceRoot":"","sources":["../../src/types/storage.types.ts"],"names":[],"mappings":""}

package/dist/types/subscription.types.d.ts

@@ -0,0 +1,19 @@
+export interface SubscriptionPlan {
+    id: string;
+    name: string;
+    price_monthly: number;
+    price_yearly: number;
+    features: string[];
+    max_projects: number;
+    max_members: number;
+    max_social_accounts: number;
+    is_active: boolean;
+}
+export interface UserSubscription {
+    id: string;
+    organization_id: string;
+    plan_id: string;
+    status: "active" | "canceled" | "past_due" | "trialing";
+    current_period_end: string;
+}
+//# sourceMappingURL=subscription.types.d.ts.map

package/dist/types/subscription.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.types.d.ts","sourceRoot":"","sources":["../../src/types/subscription.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IACxD,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types/subscription.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=subscription.types.js.map

package/dist/types/subscription.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.types.js","sourceRoot":"","sources":["../../src/types/subscription.types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@addn/sdk",
+  "version": "1.0.0",
+  "description": "Official ADDN Backend TypeScript SDK for Web (frontend3) and Mobile (React Native/Expo)",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "author": "ADDN Engineering",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/src/auth/storage.ts

@@ -0,0 +1,75 @@
+import { StorageAdapter } from "../http/types";
+
+export class MemoryStorageAdapter implements StorageAdapter {
+  private store: Map<string, string> = new Map();
+
+  getItem(key: string): string | null {
+    return this.store.get(key) ?? null;
+  }
+
+  setItem(key: string, value: string): void {
+    this.store.set(key, value);
+  }
+
+  removeItem(key: string): void {
+    this.store.delete(key);
+  }
+}
+
+export class LocalStorageAdapter implements StorageAdapter {
+  getItem(key: string): string | null {
+    if (typeof window !== "undefined" && window.localStorage) {
+      return window.localStorage.getItem(key);
+    }
+    return null;
+  }
+
+  setItem(key: string, value: string): void {
+    if (typeof window !== "undefined" && window.localStorage) {
+      window.localStorage.setItem(key, value);
+    }
+  }
+
+  removeItem(key: string): void {
+    if (typeof window !== "undefined" && window.localStorage) {
+      window.localStorage.removeItem(key);
+    }
+  }
+}
+
+export class SessionStorageAdapter implements StorageAdapter {
+  getItem(key: string): string | null {
+    if (typeof window !== "undefined" && window.sessionStorage) {
+      return window.sessionStorage.getItem(key);
+    }
+    return null;
+  }
+
+  setItem(key: string, value: string): void {
+    if (typeof window !== "undefined" && window.sessionStorage) {
+      window.sessionStorage.setItem(key, value);
+    }
+  }
+
+  removeItem(key: string): void {
+    if (typeof window !== "undefined" && window.sessionStorage) {
+      window.sessionStorage.removeItem(key);
+    }
+  }
+}
+
+export class CustomStorageAdapter implements StorageAdapter {
+  constructor(private readonly storage: StorageAdapter) {}
+
+  async getItem(key: string): Promise<string | null> {
+    return await this.storage.getItem(key);
+  }
+
+  async setItem(key: string, value: string): Promise<void> {
+    await this.storage.setItem(key, value);
+  }
+
+  async removeItem(key: string): Promise<void> {
+    await this.storage.removeItem(key);
+  }
+}

package/src/auth/token-manager.ts

@@ -0,0 +1,107 @@
+import { StorageAdapter } from "../http/types";
+import { MemoryStorageAdapter } from "./storage";
+
+export interface TokenPair {
+  accessToken: string;
+  refreshToken?: string;
+}
+
+export class TokenManager {
+  private readonly REFRESH_TOKEN_KEY = "addn_refresh_token";
+  private readonly USER_KEY = "addn_current_user";
+
+  private memoryAccessToken: string | null = null;
+  private memoryRefreshToken: string | null = null;
+  private refreshPromise: Promise<TokenPair | null> | null = null;
+
+  constructor(
+    private readonly storage: StorageAdapter = new MemoryStorageAdapter(),
+    private readonly onUnauthenticated?: () => void
+  ) {}
+
+  /**
+   * Returns the short-lived access token strictly from memory.
+   * Access tokens are NEVER stored in persistent browser/disk storage to prevent XSS exfiltration.
+   */
+  public async getAccessToken(): Promise<string | null> {
+    return this.memoryAccessToken;
+  }
+
+  /**
+   * Returns the refresh token from memory or secure storage for session restoration.
+   */
+  public async getRefreshToken(): Promise<string | null> {
+    if (this.memoryRefreshToken) {
+      return this.memoryRefreshToken;
+    }
+    const stored = await this.storage.getItem(this.REFRESH_TOKEN_KEY);
+    this.memoryRefreshToken = stored;
+    return stored;
+  }
+
+  /**
+   * Sets access token in memory and persists refresh token securely.
+   */
+  public async setTokens(accessToken: string, refreshToken?: string): Promise<void> {
+    this.memoryAccessToken = accessToken;
+    if (refreshToken) {
+      this.memoryRefreshToken = refreshToken;
+      await this.storage.setItem(this.REFRESH_TOKEN_KEY, refreshToken);
+    }
+  }
+
+  public async setUser(user: any): Promise<void> {
+    if (user) {
+      await this.storage.setItem(this.USER_KEY, JSON.stringify(user));
+    } else {
+      await this.storage.removeItem(this.USER_KEY);
+    }
+  }
+
+  public async getUser<T = any>(): Promise<T | null> {
+    const raw = await this.storage.getItem(this.USER_KEY);
+    if (!raw) return null;
+    try {
+      return JSON.parse(raw) as T;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Clears in-memory tokens and persistent session keys.
+   */
+  public async clearTokens(): Promise<void> {
+    this.memoryAccessToken = null;
+    this.memoryRefreshToken = null;
+    await this.storage.removeItem(this.REFRESH_TOKEN_KEY);
+    await this.storage.removeItem(this.USER_KEY);
+  }
+
+  /**
+   * Manages single-flight refresh queue without race conditions.
+   */
+  public async handleRefresh(refreshFn: (refreshToken?: string) => Promise<TokenPair>): Promise<TokenPair | null> {
+    if (this.refreshPromise) {
+      return this.refreshPromise;
+    }
+
+    const currentRefreshToken = await this.getRefreshToken();
+
+    this.refreshPromise = (async () => {
+      try {
+        const newTokens = await refreshFn(currentRefreshToken || undefined);
+        await this.setTokens(newTokens.accessToken, newTokens.refreshToken);
+        return newTokens;
+      } catch (err) {
+        await this.clearTokens();
+        this.onUnauthenticated?.();
+        return null;
+      } finally {
+        this.refreshPromise = null;
+      }
+    })();
+
+    return this.refreshPromise;
+  }
+}

package/src/client.ts

@@ -0,0 +1,51 @@
+import { HttpClient } from "./http/http-client";
+import { AddnClientOptions } from "./http/types";
+import { AuthModule } from "./modules/auth.module";
+import { OrgsModule } from "./modules/orgs.module";
+import { CustomersModule } from "./modules/customers.module";
+import { ProjectsModule } from "./modules/projects.module";
+import { ContentPlansModule } from "./modules/content-plans.module";
+import { SchedulingModule } from "./modules/scheduling.module";
+import { AccountsModule } from "./modules/accounts.module";
+import { AnalyticsModule } from "./modules/analytics.module";
+import { NotificationsModule } from "./modules/notifications.module";
+import { StorageModule } from "./modules/storage.module";
+import { SubscriptionsModule } from "./modules/subscriptions.module";
+
+export class AddnClient {
+  public readonly http: HttpClient;
+  public readonly auth: AuthModule;
+  public readonly orgs: OrgsModule;
+  public readonly customers: CustomersModule;
+  public readonly projects: ProjectsModule;
+  public readonly contentPlans: ContentPlansModule;
+  public readonly scheduling: SchedulingModule;
+  public readonly accounts: AccountsModule;
+  public readonly analytics: AnalyticsModule;
+  public readonly notifications: NotificationsModule;
+  public readonly storage: StorageModule;
+  public readonly subscriptions: SubscriptionsModule;
+
+  constructor(options: AddnClientOptions) {
+    this.http = new HttpClient(options);
+    this.auth = new AuthModule(this.http);
+    this.orgs = new OrgsModule(this.http);
+    this.customers = new CustomersModule(this.http);
+    this.projects = new ProjectsModule(this.http);
+    this.contentPlans = new ContentPlansModule(this.http);
+    this.scheduling = new SchedulingModule(this.http);
+    this.accounts = new AccountsModule(this.http);
+    this.analytics = new AnalyticsModule(this.http);
+    this.notifications = new NotificationsModule(this.http);
+    this.storage = new StorageModule(this.http);
+    this.subscriptions = new SubscriptionsModule(this.http);
+  }
+
+  public async setTokens(accessToken: string, refreshToken: string): Promise<void> {
+    await this.http.tokenManager.setTokens(accessToken, refreshToken);
+  }
+
+  public async clearTokens(): Promise<void> {
+    await this.http.tokenManager.clearTokens();
+  }
+}

package/src/http/errors.ts

@@ -0,0 +1,97 @@
+import { ValidationErrorDetail } from "../types";
+
+export abstract class AddnError extends Error {
+  public abstract readonly code: string;
+
+  constructor(message: string, public readonly cause?: unknown) {
+    super(message);
+    Object.setPrototypeOf(this, new.target.prototype);
+    if ((Error as any).captureStackTrace) {
+      (Error as any).captureStackTrace(this, this.constructor);
+    }
+  }
+}
+
+export class AddnNetworkError extends AddnError {
+  public readonly code = "NETWORK_ERROR";
+
+  constructor(message: string = "Unable to connect to ADDN server. Please check your internet connection.", cause?: unknown) {
+    super(message, cause);
+  }
+}
+
+export class AddnTimeoutError extends AddnError {
+  public readonly code = "REQUEST_TIMEOUT";
+
+  constructor(public readonly timeoutMs: number, message: string = `Request timed out after ${timeoutMs}ms`) {
+    super(message);
+  }
+}
+
+export class AddnApiError extends AddnError {
+  public readonly code: string;
+
+  constructor(
+    message: string,
+    public readonly statusCode: number,
+    public readonly errorCode: string = "API_ERROR",
+    public readonly details: unknown = null,
+    public readonly rawResponse?: unknown
+  ) {
+    super(message);
+    this.code = errorCode;
+  }
+}
+
+export class AddnAuthError extends AddnApiError {
+  constructor(message: string = "Authentication failed or token expired.", statusCode: number = 401, errorCode: string = "AUTHENTICATION_FAILED", details?: unknown) {
+    super(message, statusCode, errorCode, details);
+  }
+}
+
+export class AddnForbiddenError extends AddnApiError {
+  constructor(message: string = "You do not have permission to perform this action.", statusCode: number = 403, errorCode: string = "PERMISSION_DENIED", details?: unknown) {
+    super(message, statusCode, errorCode, details);
+  }
+}
+
+export class AddnNotFoundError extends AddnApiError {
+  constructor(message: string = "The requested resource could not be found.", statusCode: number = 404, errorCode: string = "RESOURCE_NOT_FOUND", details?: unknown) {
+    super(message, statusCode, errorCode, details);
+  }
+}
+
+export class AddnConflictError extends AddnApiError {
+  constructor(message: string = "A resource conflict occurred.", statusCode: number = 409, errorCode: string = "DUPLICATE_RESOURCE", details?: unknown) {
+    super(message, statusCode, errorCode, details);
+  }
+}
+
+export class AddnValidationError extends AddnApiError {
+  public readonly validationDetails: ValidationErrorDetail[];
+
+  constructor(message: string = "Validation failed.", details: ValidationErrorDetail[] = [], rawResponse?: unknown) {
+    super(message, 422, "VALIDATION_ERROR", details, rawResponse);
+    this.validationDetails = details;
+  }
+}
+
+export class AddnRateLimitError extends AddnApiError {
+  constructor(message: string = "Too many requests. Please try again later.", public readonly retryAfterSeconds?: number) {
+    super(message, 429, "RATE_LIMITED", { retryAfterSeconds });
+  }
+}
+
+export class AddnServerError extends AddnApiError {
+  constructor(message: string = "An internal server error occurred. Please try again later.", statusCode: number = 500, errorCode: string = "INTERNAL_SERVER_ERROR", details?: unknown) {
+    super(message, statusCode, errorCode, details);
+  }
+}
+
+export class AddnUnexpectedError extends AddnError {
+  public readonly code = "UNEXPECTED_ERROR";
+
+  constructor(message: string = "An unexpected error occurred processing the server response.", cause?: unknown) {
+    super(message, cause);
+  }
+}