@palbase/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Palbase
+
+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/dist/index.cjs

@@ -0,0 +1,288 @@
+"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, {
+  ConfigFetcher: () => ConfigFetcher,
+  HttpClient: () => HttpClient,
+  PalbaseError: () => PalbaseError,
+  TokenManager: () => TokenManager,
+  detectPlatform: () => detectPlatform
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/config.ts
+var CACHE_TTL_MS = 5 * 60 * 1e3;
+var ConfigFetcher = class {
+  httpClient;
+  cachedConfig = null;
+  cacheTimestamp = 0;
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  async getConfig() {
+    const now = Date.now();
+    if (this.cachedConfig && now - this.cacheTimestamp < CACHE_TTL_MS) {
+      return this.cachedConfig;
+    }
+    try {
+      const response = await this.httpClient.request("GET", "/v1/config");
+      if (response.error || !response.data) {
+        return null;
+      }
+      this.cachedConfig = response.data;
+      this.cacheTimestamp = now;
+      return this.cachedConfig;
+    } catch {
+      return null;
+    }
+  }
+};
+
+// src/errors.ts
+var PalbaseError = class extends Error {
+  code;
+  status;
+  details;
+  constructor(code, message, status, details) {
+    super(message);
+    this.name = "PalbaseError";
+    this.code = code;
+    this.status = status;
+    this.details = details;
+  }
+};
+
+// src/http.ts
+var PALBASE_DOMAIN = "palbase.io";
+function parseProjectRef(apiKey) {
+  const parts = apiKey.split("_");
+  const ref = parts[1];
+  if (parts.length >= 3 && parts[0] === "pb" && ref) {
+    return ref;
+  }
+  return null;
+}
+var MAX_RETRIES = 3;
+var INITIAL_BACKOFF_MS = 200;
+var HttpClient = class {
+  apiKey;
+  options;
+  tokenManager = null;
+  interceptors = [];
+  constructor(apiKey, options) {
+    this.apiKey = apiKey;
+    this.options = options;
+  }
+  /** Add a request interceptor. Runs before every request. */
+  addInterceptor(interceptor) {
+    this.interceptors.push(interceptor);
+  }
+  async request(method, path, options) {
+    if (this.tokenManager?.isExpired() && this.tokenManager.getRefreshToken() && this.tokenManager.refreshFunction) {
+      await this.tokenManager.refreshSession();
+    }
+    return this.executeWithRetry(method, path, options, 0);
+  }
+  getBaseUrl() {
+    if (this.options?.url) {
+      return this.options.url;
+    }
+    const ref = parseProjectRef(this.apiKey);
+    if (ref) {
+      return `https://${ref}.${PALBASE_DOMAIN}`;
+    }
+    throw new PalbaseError(
+      "invalid_api_key",
+      "Invalid API key format. Expected: pb_{ref}_{random}. Provide an explicit url option for custom endpoints.",
+      0
+    );
+  }
+  buildHeaders(options) {
+    const headers = {
+      "apikey": this.apiKey,
+      "Content-Type": "application/json"
+    };
+    const token = this.tokenManager?.getAccessToken();
+    if (token) {
+      headers["Authorization"] = `Bearer ${token}`;
+    }
+    if (this.options?.serviceRoleKey) {
+      headers["Authorization"] = `Bearer ${this.options.serviceRoleKey}`;
+    }
+    if (this.options?.headers) {
+      Object.assign(headers, this.options.headers);
+    }
+    if (options?.headers) {
+      Object.assign(headers, options.headers);
+    }
+    return headers;
+  }
+  async executeWithRetry(method, path, options, attempt) {
+    const url = `${this.getBaseUrl()}${path}`;
+    const headers = this.buildHeaders(options);
+    for (const interceptor of this.interceptors) {
+      await interceptor({ headers, method, path });
+    }
+    const fetchOptions = {
+      method,
+      headers,
+      signal: options?.signal
+    };
+    if (options?.body !== void 0) {
+      fetchOptions.body = JSON.stringify(options.body);
+    }
+    let response;
+    try {
+      response = await fetch(url, fetchOptions);
+    } catch (error) {
+      if (attempt < MAX_RETRIES - 1) {
+        const backoff = INITIAL_BACKOFF_MS * 2 ** attempt;
+        await this.delay(backoff);
+        return this.executeWithRetry(method, path, options, attempt + 1);
+      }
+      throw new PalbaseError(
+        "network_error",
+        error instanceof Error ? error.message : "Network request failed",
+        0
+      );
+    }
+    if (response.status === 429) {
+      if (attempt < MAX_RETRIES - 1) {
+        const retryAfter = response.headers.get("Retry-After");
+        const parsed = retryAfter ? Number.parseInt(retryAfter, 10) : Number.NaN;
+        const delayMs = Number.isNaN(parsed) ? INITIAL_BACKOFF_MS * 2 ** attempt : parsed * 1e3;
+        await this.delay(delayMs);
+        return this.executeWithRetry(method, path, options, attempt + 1);
+      }
+    }
+    let data = null;
+    let errorBody;
+    const contentType = response.headers.get("Content-Type");
+    if (contentType?.includes("json")) {
+      const body = await response.json();
+      if (response.ok) {
+        data = body;
+      } else {
+        errorBody = body;
+      }
+    }
+    if (!response.ok) {
+      return {
+        data: null,
+        error: new PalbaseError(
+          errorBody?.error ?? "unknown_error",
+          errorBody?.error_description ?? response.statusText,
+          response.status,
+          errorBody
+        ),
+        status: response.status
+      };
+    }
+    return { data, error: null, status: response.status };
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/platform.ts
+function detectPlatform() {
+  if (typeof Deno !== "undefined") {
+    return "deno";
+  }
+  if (process?.versions) {
+    if ("bun" in process.versions) {
+      return "bun";
+    }
+    if ("node" in process.versions) {
+      return "node";
+    }
+  }
+  if (typeof navigator !== "undefined" && navigator.product === "ReactNative") {
+    return "react-native";
+  }
+  return "browser";
+}
+
+// src/token.ts
+var TokenManager = class {
+  session = null;
+  listeners = /* @__PURE__ */ new Set();
+  refreshPromise = null;
+  refreshFunction = null;
+  setSession(session) {
+    this.session = session;
+    this.notify("SESSION_SET", session);
+  }
+  getAccessToken() {
+    return this.session?.accessToken ?? null;
+  }
+  getRefreshToken() {
+    return this.session?.refreshToken ?? null;
+  }
+  clearSession() {
+    this.session = null;
+    this.notify("SESSION_CLEARED", null);
+  }
+  isExpired() {
+    if (!this.session) return true;
+    return Date.now() >= this.session.expiresAt;
+  }
+  async refreshSession() {
+    if (!this.session?.refreshToken || !this.refreshFunction) {
+      return;
+    }
+    if (this.refreshPromise) {
+      return this.refreshPromise;
+    }
+    this.refreshPromise = this.executeRefresh(this.session.refreshToken);
+    try {
+      await this.refreshPromise;
+    } finally {
+      this.refreshPromise = null;
+    }
+  }
+  onAuthStateChange(callback) {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  }
+  async executeRefresh(refreshToken) {
+    if (!this.refreshFunction) return;
+    const newSession = await this.refreshFunction(refreshToken);
+    this.setSession(newSession);
+  }
+  notify(event, session) {
+    for (const listener of this.listeners) {
+      listener(event, session);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigFetcher,
+  HttpClient,
+  PalbaseError,
+  TokenManager,
+  detectPlatform
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/errors.ts","../src/http.ts","../src/platform.ts","../src/token.ts"],"sourcesContent":["export { ConfigFetcher } from './config.js';\nexport { PalbaseError } from './errors.js';\nexport { HttpClient } from './http.js';\nexport type { RequestInterceptor } from './http.js';\nexport type { Platform } from './platform.js';\nexport { detectPlatform } from './platform.js';\nexport { TokenManager } from './token.js';\nexport type {\n  AuthStateCallback,\n  AuthStateEvent,\n  HttpClientOptions,\n  PalbaseConfig,\n  PalbaseResponse,\n  ProjectConfig,\n  RequestOptions,\n  Session,\n  Unsubscribe,\n} from './types.js';\n","import type { HttpClient } from './http.js';\nimport type { ProjectConfig } from './types.js';\n\nconst CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\nexport class ConfigFetcher {\n  protected readonly httpClient: HttpClient;\n  private cachedConfig: ProjectConfig | null = null;\n  private cacheTimestamp = 0;\n\n  constructor(httpClient: HttpClient) {\n    this.httpClient = httpClient;\n  }\n\n  async getConfig(): Promise<ProjectConfig | null> {\n    const now = Date.now();\n\n    if (this.cachedConfig && now - this.cacheTimestamp < CACHE_TTL_MS) {\n      return this.cachedConfig;\n    }\n\n    try {\n      const response = await this.httpClient.request<ProjectConfig>('GET', '/v1/config');\n\n      if (response.error || !response.data) {\n        return null;\n      }\n\n      this.cachedConfig = response.data;\n      this.cacheTimestamp = now;\n\n      return this.cachedConfig;\n    } catch {\n      return null;\n    }\n  }\n}\n","export class PalbaseError extends Error {\n  readonly code: string;\n  readonly status: number;\n  readonly details?: unknown;\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(message);\n    this.name = 'PalbaseError';\n    this.code = code;\n    this.status = status;\n    this.details = details;\n  }\n}\n","import { PalbaseError } from './errors.js';\nimport type { TokenManager } from './token.js';\nimport type { HttpClientOptions, PalbaseResponse, RequestOptions } from './types.js';\n\nconst PALBASE_DOMAIN = 'palbase.io';\n\n/**\n * Parse project ref from an API key.\n * Format: pb_{ref}_{random}\n * Example: pb_abc12345_xxxxxxxxxxxxxxxxxxxxxxxx\n * Returns the ref segment or null if the key doesn't match.\n */\nfunction parseProjectRef(apiKey: string): string | null {\n  const parts = apiKey.split('_');\n  // Format: [\"pb\", ref, random]\n  const ref = parts[1];\n  if (parts.length >= 3 && parts[0] === 'pb' && ref) {\n    return ref;\n  }\n  return null;\n}\nconst MAX_RETRIES = 3;\nconst INITIAL_BACKOFF_MS = 200;\n\n/**\n * Request interceptor. Runs before every HTTP request.\n * Can modify headers, body, or reject the request.\n */\nexport interface RequestInterceptor {\n  (request: { headers: Record<string, string>; method: string; path: string }): void | Promise<void>;\n}\n\nexport class HttpClient {\n  protected readonly apiKey: string;\n  protected readonly options?: HttpClientOptions;\n\n  tokenManager: TokenManager | null = null;\n\n  private readonly interceptors: RequestInterceptor[] = [];\n\n  constructor(apiKey: string, options?: HttpClientOptions) {\n    this.apiKey = apiKey;\n    this.options = options;\n  }\n\n  /** Add a request interceptor. Runs before every request. */\n  addInterceptor(interceptor: RequestInterceptor): void {\n    this.interceptors.push(interceptor);\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: RequestOptions,\n  ): Promise<PalbaseResponse<T>> {\n    // If token is expired and refresh is available, refresh before making the request\n    if (this.tokenManager?.isExpired() && this.tokenManager.getRefreshToken() && this.tokenManager.refreshFunction) {\n      await this.tokenManager.refreshSession();\n    }\n\n    return this.executeWithRetry<T>(method, path, options, 0);\n  }\n\n  private getBaseUrl(): string {\n    // Explicit URL always wins (local dev, testing)\n    if (this.options?.url) {\n      return this.options.url;\n    }\n\n    // Resolve from API key (format: pb_{ref}_{random})\n    const ref = parseProjectRef(this.apiKey);\n    if (ref) {\n      return `https://${ref}.${PALBASE_DOMAIN}`;\n    }\n\n    throw new PalbaseError(\n      'invalid_api_key',\n      'Invalid API key format. Expected: pb_{ref}_{random}. Provide an explicit url option for custom endpoints.',\n      0,\n    );\n  }\n\n  private buildHeaders(options?: RequestOptions): Record<string, string> {\n    const headers: Record<string, string> = {\n      'apikey': this.apiKey,\n      'Content-Type': 'application/json',\n    };\n\n    // Add token if available\n    const token = this.tokenManager?.getAccessToken();\n    if (token) {\n      headers['Authorization'] = `Bearer ${token}`;\n    }\n\n    // serviceRoleKey overrides token-based Authorization\n    if (this.options?.serviceRoleKey) {\n      headers['Authorization'] = `Bearer ${this.options.serviceRoleKey}`;\n    }\n\n    // Merge global custom headers\n    if (this.options?.headers) {\n      Object.assign(headers, this.options.headers);\n    }\n\n    // Merge per-request headers\n    if (options?.headers) {\n      Object.assign(headers, options.headers);\n    }\n\n    return headers;\n  }\n\n  private async executeWithRetry<T>(\n    method: string,\n    path: string,\n    options: RequestOptions | undefined,\n    attempt: number,\n  ): Promise<PalbaseResponse<T>> {\n    const url = `${this.getBaseUrl()}${path}`;\n    const headers = this.buildHeaders(options);\n\n    // Run interceptors\n    for (const interceptor of this.interceptors) {\n      await interceptor({ headers, method, path });\n    }\n\n    const fetchOptions: RequestInit = {\n      method,\n      headers,\n      signal: options?.signal,\n    };\n\n    if (options?.body !== undefined) {\n      fetchOptions.body = JSON.stringify(options.body);\n    }\n\n    let response: Response;\n    try {\n      response = await fetch(url, fetchOptions);\n    } catch (error) {\n      // Network error — retry with backoff\n      if (attempt < MAX_RETRIES - 1) {\n        const backoff = INITIAL_BACKOFF_MS * 2 ** attempt;\n        await this.delay(backoff);\n        return this.executeWithRetry<T>(method, path, options, attempt + 1);\n      }\n\n      // All retries exhausted — throw PalbaseError\n      throw new PalbaseError(\n        'network_error',\n        error instanceof Error ? error.message : 'Network request failed',\n        0,\n      );\n    }\n\n    // Handle 429 Too Many Requests — retry with Retry-After or backoff;\n    // if retries exhausted, fall through to normal error response handling below\n    if (response.status === 429) {\n      if (attempt < MAX_RETRIES - 1) {\n        const retryAfter = response.headers.get('Retry-After');\n        const parsed = retryAfter ? Number.parseInt(retryAfter, 10) : Number.NaN;\n        const delayMs = Number.isNaN(parsed) ? INITIAL_BACKOFF_MS * 2 ** attempt : parsed * 1000;\n        await this.delay(delayMs);\n        return this.executeWithRetry<T>(method, path, options, attempt + 1);\n      }\n    }\n\n    // Parse response body\n    let data: T | null = null;\n    let errorBody: { error?: string; error_description?: string; status?: number } | undefined;\n\n    const contentType = response.headers.get('Content-Type');\n    if (contentType?.includes('json')) {\n      const body = await response.json() as Record<string, unknown>;\n      if (response.ok) {\n        data = body as T;\n      } else {\n        errorBody = body as typeof errorBody;\n      }\n    }\n\n    if (!response.ok) {\n      return {\n        data: null,\n        error: new PalbaseError(\n          errorBody?.error ?? 'unknown_error',\n          errorBody?.error_description ?? response.statusText,\n          response.status,\n          errorBody,\n        ),\n        status: response.status,\n      };\n    }\n\n    return { data, error: null, status: response.status };\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n","export type Platform = 'browser' | 'node' | 'react-native' | 'deno' | 'bun';\n\ndeclare const Deno: unknown;\ndeclare const process: { versions: Record<string, string> } | undefined;\n\nexport function detectPlatform(): Platform {\n  if (typeof Deno !== 'undefined') {\n    return 'deno';\n  }\n\n  if (process?.versions) {\n    if ('bun' in process.versions) {\n      return 'bun';\n    }\n    if ('node' in process.versions) {\n      return 'node';\n    }\n  }\n\n  if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {\n    return 'react-native';\n  }\n\n  return 'browser';\n}\n","import type { AuthStateCallback, Session, Unsubscribe } from './types.js';\n\nexport class TokenManager {\n  private session: Session | null = null;\n  private listeners: Set<AuthStateCallback> = new Set();\n  private refreshPromise: Promise<void> | null = null;\n\n  refreshFunction: ((refreshToken: string) => Promise<Session>) | null = null;\n\n  setSession(session: Session): void {\n    this.session = session;\n    this.notify('SESSION_SET', session);\n  }\n\n  getAccessToken(): string | null {\n    return this.session?.accessToken ?? null;\n  }\n\n  getRefreshToken(): string | null {\n    return this.session?.refreshToken ?? null;\n  }\n\n  clearSession(): void {\n    this.session = null;\n    this.notify('SESSION_CLEARED', null);\n  }\n\n  isExpired(): boolean {\n    if (!this.session) return true;\n    return Date.now() >= this.session.expiresAt;\n  }\n\n  async refreshSession(): Promise<void> {\n    if (!this.session?.refreshToken || !this.refreshFunction) {\n      return;\n    }\n\n    // Collapse concurrent refresh calls into a single request\n    if (this.refreshPromise) {\n      return this.refreshPromise;\n    }\n\n    this.refreshPromise = this.executeRefresh(this.session.refreshToken);\n\n    try {\n      await this.refreshPromise;\n    } finally {\n      this.refreshPromise = null;\n    }\n  }\n\n  onAuthStateChange(callback: AuthStateCallback): Unsubscribe {\n    this.listeners.add(callback);\n    return () => {\n      this.listeners.delete(callback);\n    };\n  }\n\n  private async executeRefresh(refreshToken: string): Promise<void> {\n    if (!this.refreshFunction) return;\n    const newSession = await this.refreshFunction(refreshToken);\n    this.setSession(newSession);\n  }\n\n  private notify(event: 'SESSION_SET' | 'SESSION_CLEARED', session: Session | null): void {\n    for (const listener of this.listeners) {\n      listener(event, session);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,100 @@
+declare class PalbaseError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+
+interface PalbaseResponse<T> {
+    data: T | null;
+    error: PalbaseError | null;
+    count?: number;
+    status: number;
+}
+interface HttpClientOptions {
+    url?: string;
+    serviceRoleKey?: string;
+    headers?: Record<string, string>;
+}
+interface RequestOptions {
+    headers?: Record<string, string>;
+    body?: unknown;
+    signal?: AbortSignal;
+}
+interface PalbaseConfig {
+    apiKey: string;
+    url?: string;
+    headers?: Record<string, string>;
+}
+interface ProjectConfig {
+    projectId: string;
+    enabledModules: string[];
+    appCheck: {
+        enabled: boolean;
+        provider?: string;
+    };
+    customDomain?: string;
+}
+interface Session {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+}
+type AuthStateEvent = 'SESSION_SET' | 'SESSION_CLEARED';
+type AuthStateCallback = (event: AuthStateEvent, session: Session | null) => void;
+type Unsubscribe = () => void;
+
+declare class TokenManager {
+    private session;
+    private listeners;
+    private refreshPromise;
+    refreshFunction: ((refreshToken: string) => Promise<Session>) | null;
+    setSession(session: Session): void;
+    getAccessToken(): string | null;
+    getRefreshToken(): string | null;
+    clearSession(): void;
+    isExpired(): boolean;
+    refreshSession(): Promise<void>;
+    onAuthStateChange(callback: AuthStateCallback): Unsubscribe;
+    private executeRefresh;
+    private notify;
+}
+
+/**
+ * Request interceptor. Runs before every HTTP request.
+ * Can modify headers, body, or reject the request.
+ */
+interface RequestInterceptor {
+    (request: {
+        headers: Record<string, string>;
+        method: string;
+        path: string;
+    }): void | Promise<void>;
+}
+declare class HttpClient {
+    protected readonly apiKey: string;
+    protected readonly options?: HttpClientOptions;
+    tokenManager: TokenManager | null;
+    private readonly interceptors;
+    constructor(apiKey: string, options?: HttpClientOptions);
+    /** Add a request interceptor. Runs before every request. */
+    addInterceptor(interceptor: RequestInterceptor): void;
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<PalbaseResponse<T>>;
+    private getBaseUrl;
+    private buildHeaders;
+    private executeWithRetry;
+    private delay;
+}
+
+declare class ConfigFetcher {
+    protected readonly httpClient: HttpClient;
+    private cachedConfig;
+    private cacheTimestamp;
+    constructor(httpClient: HttpClient);
+    getConfig(): Promise<ProjectConfig | null>;
+}
+
+type Platform = 'browser' | 'node' | 'react-native' | 'deno' | 'bun';
+declare function detectPlatform(): Platform;
+
+export { type AuthStateCallback, type AuthStateEvent, ConfigFetcher, HttpClient, type HttpClientOptions, type PalbaseConfig, PalbaseError, type PalbaseResponse, type Platform, type ProjectConfig, type RequestInterceptor, type RequestOptions, type Session, TokenManager, type Unsubscribe, detectPlatform };

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+declare class PalbaseError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(code: string, message: string, status: number, details?: unknown);
+}
+
+interface PalbaseResponse<T> {
+    data: T | null;
+    error: PalbaseError | null;
+    count?: number;
+    status: number;
+}
+interface HttpClientOptions {
+    url?: string;
+    serviceRoleKey?: string;
+    headers?: Record<string, string>;
+}
+interface RequestOptions {
+    headers?: Record<string, string>;
+    body?: unknown;
+    signal?: AbortSignal;
+}
+interface PalbaseConfig {
+    apiKey: string;
+    url?: string;
+    headers?: Record<string, string>;
+}
+interface ProjectConfig {
+    projectId: string;
+    enabledModules: string[];
+    appCheck: {
+        enabled: boolean;
+        provider?: string;
+    };
+    customDomain?: string;
+}
+interface Session {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+}
+type AuthStateEvent = 'SESSION_SET' | 'SESSION_CLEARED';
+type AuthStateCallback = (event: AuthStateEvent, session: Session | null) => void;
+type Unsubscribe = () => void;
+
+declare class TokenManager {
+    private session;
+    private listeners;
+    private refreshPromise;
+    refreshFunction: ((refreshToken: string) => Promise<Session>) | null;
+    setSession(session: Session): void;
+    getAccessToken(): string | null;
+    getRefreshToken(): string | null;
+    clearSession(): void;
+    isExpired(): boolean;
+    refreshSession(): Promise<void>;
+    onAuthStateChange(callback: AuthStateCallback): Unsubscribe;
+    private executeRefresh;
+    private notify;
+}
+
+/**
+ * Request interceptor. Runs before every HTTP request.
+ * Can modify headers, body, or reject the request.
+ */
+interface RequestInterceptor {
+    (request: {
+        headers: Record<string, string>;
+        method: string;
+        path: string;
+    }): void | Promise<void>;
+}
+declare class HttpClient {
+    protected readonly apiKey: string;
+    protected readonly options?: HttpClientOptions;
+    tokenManager: TokenManager | null;
+    private readonly interceptors;
+    constructor(apiKey: string, options?: HttpClientOptions);
+    /** Add a request interceptor. Runs before every request. */
+    addInterceptor(interceptor: RequestInterceptor): void;
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<PalbaseResponse<T>>;
+    private getBaseUrl;
+    private buildHeaders;
+    private executeWithRetry;
+    private delay;
+}
+
+declare class ConfigFetcher {
+    protected readonly httpClient: HttpClient;
+    private cachedConfig;
+    private cacheTimestamp;
+    constructor(httpClient: HttpClient);
+    getConfig(): Promise<ProjectConfig | null>;
+}
+
+type Platform = 'browser' | 'node' | 'react-native' | 'deno' | 'bun';
+declare function detectPlatform(): Platform;
+
+export { type AuthStateCallback, type AuthStateEvent, ConfigFetcher, HttpClient, type HttpClientOptions, type PalbaseConfig, PalbaseError, type PalbaseResponse, type Platform, type ProjectConfig, type RequestInterceptor, type RequestOptions, type Session, TokenManager, type Unsubscribe, detectPlatform };

package/dist/index.js

@@ -0,0 +1,257 @@
+// src/config.ts
+var CACHE_TTL_MS = 5 * 60 * 1e3;
+var ConfigFetcher = class {
+  httpClient;
+  cachedConfig = null;
+  cacheTimestamp = 0;
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  async getConfig() {
+    const now = Date.now();
+    if (this.cachedConfig && now - this.cacheTimestamp < CACHE_TTL_MS) {
+      return this.cachedConfig;
+    }
+    try {
+      const response = await this.httpClient.request("GET", "/v1/config");
+      if (response.error || !response.data) {
+        return null;
+      }
+      this.cachedConfig = response.data;
+      this.cacheTimestamp = now;
+      return this.cachedConfig;
+    } catch {
+      return null;
+    }
+  }
+};
+
+// src/errors.ts
+var PalbaseError = class extends Error {
+  code;
+  status;
+  details;
+  constructor(code, message, status, details) {
+    super(message);
+    this.name = "PalbaseError";
+    this.code = code;
+    this.status = status;
+    this.details = details;
+  }
+};
+
+// src/http.ts
+var PALBASE_DOMAIN = "palbase.io";
+function parseProjectRef(apiKey) {
+  const parts = apiKey.split("_");
+  const ref = parts[1];
+  if (parts.length >= 3 && parts[0] === "pb" && ref) {
+    return ref;
+  }
+  return null;
+}
+var MAX_RETRIES = 3;
+var INITIAL_BACKOFF_MS = 200;
+var HttpClient = class {
+  apiKey;
+  options;
+  tokenManager = null;
+  interceptors = [];
+  constructor(apiKey, options) {
+    this.apiKey = apiKey;
+    this.options = options;
+  }
+  /** Add a request interceptor. Runs before every request. */
+  addInterceptor(interceptor) {
+    this.interceptors.push(interceptor);
+  }
+  async request(method, path, options) {
+    if (this.tokenManager?.isExpired() && this.tokenManager.getRefreshToken() && this.tokenManager.refreshFunction) {
+      await this.tokenManager.refreshSession();
+    }
+    return this.executeWithRetry(method, path, options, 0);
+  }
+  getBaseUrl() {
+    if (this.options?.url) {
+      return this.options.url;
+    }
+    const ref = parseProjectRef(this.apiKey);
+    if (ref) {
+      return `https://${ref}.${PALBASE_DOMAIN}`;
+    }
+    throw new PalbaseError(
+      "invalid_api_key",
+      "Invalid API key format. Expected: pb_{ref}_{random}. Provide an explicit url option for custom endpoints.",
+      0
+    );
+  }
+  buildHeaders(options) {
+    const headers = {
+      "apikey": this.apiKey,
+      "Content-Type": "application/json"
+    };
+    const token = this.tokenManager?.getAccessToken();
+    if (token) {
+      headers["Authorization"] = `Bearer ${token}`;
+    }
+    if (this.options?.serviceRoleKey) {
+      headers["Authorization"] = `Bearer ${this.options.serviceRoleKey}`;
+    }
+    if (this.options?.headers) {
+      Object.assign(headers, this.options.headers);
+    }
+    if (options?.headers) {
+      Object.assign(headers, options.headers);
+    }
+    return headers;
+  }
+  async executeWithRetry(method, path, options, attempt) {
+    const url = `${this.getBaseUrl()}${path}`;
+    const headers = this.buildHeaders(options);
+    for (const interceptor of this.interceptors) {
+      await interceptor({ headers, method, path });
+    }
+    const fetchOptions = {
+      method,
+      headers,
+      signal: options?.signal
+    };
+    if (options?.body !== void 0) {
+      fetchOptions.body = JSON.stringify(options.body);
+    }
+    let response;
+    try {
+      response = await fetch(url, fetchOptions);
+    } catch (error) {
+      if (attempt < MAX_RETRIES - 1) {
+        const backoff = INITIAL_BACKOFF_MS * 2 ** attempt;
+        await this.delay(backoff);
+        return this.executeWithRetry(method, path, options, attempt + 1);
+      }
+      throw new PalbaseError(
+        "network_error",
+        error instanceof Error ? error.message : "Network request failed",
+        0
+      );
+    }
+    if (response.status === 429) {
+      if (attempt < MAX_RETRIES - 1) {
+        const retryAfter = response.headers.get("Retry-After");
+        const parsed = retryAfter ? Number.parseInt(retryAfter, 10) : Number.NaN;
+        const delayMs = Number.isNaN(parsed) ? INITIAL_BACKOFF_MS * 2 ** attempt : parsed * 1e3;
+        await this.delay(delayMs);
+        return this.executeWithRetry(method, path, options, attempt + 1);
+      }
+    }
+    let data = null;
+    let errorBody;
+    const contentType = response.headers.get("Content-Type");
+    if (contentType?.includes("json")) {
+      const body = await response.json();
+      if (response.ok) {
+        data = body;
+      } else {
+        errorBody = body;
+      }
+    }
+    if (!response.ok) {
+      return {
+        data: null,
+        error: new PalbaseError(
+          errorBody?.error ?? "unknown_error",
+          errorBody?.error_description ?? response.statusText,
+          response.status,
+          errorBody
+        ),
+        status: response.status
+      };
+    }
+    return { data, error: null, status: response.status };
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/platform.ts
+function detectPlatform() {
+  if (typeof Deno !== "undefined") {
+    return "deno";
+  }
+  if (process?.versions) {
+    if ("bun" in process.versions) {
+      return "bun";
+    }
+    if ("node" in process.versions) {
+      return "node";
+    }
+  }
+  if (typeof navigator !== "undefined" && navigator.product === "ReactNative") {
+    return "react-native";
+  }
+  return "browser";
+}
+
+// src/token.ts
+var TokenManager = class {
+  session = null;
+  listeners = /* @__PURE__ */ new Set();
+  refreshPromise = null;
+  refreshFunction = null;
+  setSession(session) {
+    this.session = session;
+    this.notify("SESSION_SET", session);
+  }
+  getAccessToken() {
+    return this.session?.accessToken ?? null;
+  }
+  getRefreshToken() {
+    return this.session?.refreshToken ?? null;
+  }
+  clearSession() {
+    this.session = null;
+    this.notify("SESSION_CLEARED", null);
+  }
+  isExpired() {
+    if (!this.session) return true;
+    return Date.now() >= this.session.expiresAt;
+  }
+  async refreshSession() {
+    if (!this.session?.refreshToken || !this.refreshFunction) {
+      return;
+    }
+    if (this.refreshPromise) {
+      return this.refreshPromise;
+    }
+    this.refreshPromise = this.executeRefresh(this.session.refreshToken);
+    try {
+      await this.refreshPromise;
+    } finally {
+      this.refreshPromise = null;
+    }
+  }
+  onAuthStateChange(callback) {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  }
+  async executeRefresh(refreshToken) {
+    if (!this.refreshFunction) return;
+    const newSession = await this.refreshFunction(refreshToken);
+    this.setSession(newSession);
+  }
+  notify(event, session) {
+    for (const listener of this.listeners) {
+      listener(event, session);
+    }
+  }
+};
+export {
+  ConfigFetcher,
+  HttpClient,
+  PalbaseError,
+  TokenManager,
+  detectPlatform
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/errors.ts","../src/http.ts","../src/platform.ts","../src/token.ts"],"sourcesContent":["import type { HttpClient } from './http.js';\nimport type { ProjectConfig } from './types.js';\n\nconst CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\nexport class ConfigFetcher {\n  protected readonly httpClient: HttpClient;\n  private cachedConfig: ProjectConfig | null = null;\n  private cacheTimestamp = 0;\n\n  constructor(httpClient: HttpClient) {\n    this.httpClient = httpClient;\n  }\n\n  async getConfig(): Promise<ProjectConfig | null> {\n    const now = Date.now();\n\n    if (this.cachedConfig && now - this.cacheTimestamp < CACHE_TTL_MS) {\n      return this.cachedConfig;\n    }\n\n    try {\n      const response = await this.httpClient.request<ProjectConfig>('GET', '/v1/config');\n\n      if (response.error || !response.data) {\n        return null;\n      }\n\n      this.cachedConfig = response.data;\n      this.cacheTimestamp = now;\n\n      return this.cachedConfig;\n    } catch {\n      return null;\n    }\n  }\n}\n","export class PalbaseError extends Error {\n  readonly code: string;\n  readonly status: number;\n  readonly details?: unknown;\n\n  constructor(code: string, message: string, status: number, details?: unknown) {\n    super(message);\n    this.name = 'PalbaseError';\n    this.code = code;\n    this.status = status;\n    this.details = details;\n  }\n}\n","import { PalbaseError } from './errors.js';\nimport type { TokenManager } from './token.js';\nimport type { HttpClientOptions, PalbaseResponse, RequestOptions } from './types.js';\n\nconst PALBASE_DOMAIN = 'palbase.io';\n\n/**\n * Parse project ref from an API key.\n * Format: pb_{ref}_{random}\n * Example: pb_abc12345_xxxxxxxxxxxxxxxxxxxxxxxx\n * Returns the ref segment or null if the key doesn't match.\n */\nfunction parseProjectRef(apiKey: string): string | null {\n  const parts = apiKey.split('_');\n  // Format: [\"pb\", ref, random]\n  const ref = parts[1];\n  if (parts.length >= 3 && parts[0] === 'pb' && ref) {\n    return ref;\n  }\n  return null;\n}\nconst MAX_RETRIES = 3;\nconst INITIAL_BACKOFF_MS = 200;\n\n/**\n * Request interceptor. Runs before every HTTP request.\n * Can modify headers, body, or reject the request.\n */\nexport interface RequestInterceptor {\n  (request: { headers: Record<string, string>; method: string; path: string }): void | Promise<void>;\n}\n\nexport class HttpClient {\n  protected readonly apiKey: string;\n  protected readonly options?: HttpClientOptions;\n\n  tokenManager: TokenManager | null = null;\n\n  private readonly interceptors: RequestInterceptor[] = [];\n\n  constructor(apiKey: string, options?: HttpClientOptions) {\n    this.apiKey = apiKey;\n    this.options = options;\n  }\n\n  /** Add a request interceptor. Runs before every request. */\n  addInterceptor(interceptor: RequestInterceptor): void {\n    this.interceptors.push(interceptor);\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: RequestOptions,\n  ): Promise<PalbaseResponse<T>> {\n    // If token is expired and refresh is available, refresh before making the request\n    if (this.tokenManager?.isExpired() && this.tokenManager.getRefreshToken() && this.tokenManager.refreshFunction) {\n      await this.tokenManager.refreshSession();\n    }\n\n    return this.executeWithRetry<T>(method, path, options, 0);\n  }\n\n  private getBaseUrl(): string {\n    // Explicit URL always wins (local dev, testing)\n    if (this.options?.url) {\n      return this.options.url;\n    }\n\n    // Resolve from API key (format: pb_{ref}_{random})\n    const ref = parseProjectRef(this.apiKey);\n    if (ref) {\n      return `https://${ref}.${PALBASE_DOMAIN}`;\n    }\n\n    throw new PalbaseError(\n      'invalid_api_key',\n      'Invalid API key format. Expected: pb_{ref}_{random}. Provide an explicit url option for custom endpoints.',\n      0,\n    );\n  }\n\n  private buildHeaders(options?: RequestOptions): Record<string, string> {\n    const headers: Record<string, string> = {\n      'apikey': this.apiKey,\n      'Content-Type': 'application/json',\n    };\n\n    // Add token if available\n    const token = this.tokenManager?.getAccessToken();\n    if (token) {\n      headers['Authorization'] = `Bearer ${token}`;\n    }\n\n    // serviceRoleKey overrides token-based Authorization\n    if (this.options?.serviceRoleKey) {\n      headers['Authorization'] = `Bearer ${this.options.serviceRoleKey}`;\n    }\n\n    // Merge global custom headers\n    if (this.options?.headers) {\n      Object.assign(headers, this.options.headers);\n    }\n\n    // Merge per-request headers\n    if (options?.headers) {\n      Object.assign(headers, options.headers);\n    }\n\n    return headers;\n  }\n\n  private async executeWithRetry<T>(\n    method: string,\n    path: string,\n    options: RequestOptions | undefined,\n    attempt: number,\n  ): Promise<PalbaseResponse<T>> {\n    const url = `${this.getBaseUrl()}${path}`;\n    const headers = this.buildHeaders(options);\n\n    // Run interceptors\n    for (const interceptor of this.interceptors) {\n      await interceptor({ headers, method, path });\n    }\n\n    const fetchOptions: RequestInit = {\n      method,\n      headers,\n      signal: options?.signal,\n    };\n\n    if (options?.body !== undefined) {\n      fetchOptions.body = JSON.stringify(options.body);\n    }\n\n    let response: Response;\n    try {\n      response = await fetch(url, fetchOptions);\n    } catch (error) {\n      // Network error — retry with backoff\n      if (attempt < MAX_RETRIES - 1) {\n        const backoff = INITIAL_BACKOFF_MS * 2 ** attempt;\n        await this.delay(backoff);\n        return this.executeWithRetry<T>(method, path, options, attempt + 1);\n      }\n\n      // All retries exhausted — throw PalbaseError\n      throw new PalbaseError(\n        'network_error',\n        error instanceof Error ? error.message : 'Network request failed',\n        0,\n      );\n    }\n\n    // Handle 429 Too Many Requests — retry with Retry-After or backoff;\n    // if retries exhausted, fall through to normal error response handling below\n    if (response.status === 429) {\n      if (attempt < MAX_RETRIES - 1) {\n        const retryAfter = response.headers.get('Retry-After');\n        const parsed = retryAfter ? Number.parseInt(retryAfter, 10) : Number.NaN;\n        const delayMs = Number.isNaN(parsed) ? INITIAL_BACKOFF_MS * 2 ** attempt : parsed * 1000;\n        await this.delay(delayMs);\n        return this.executeWithRetry<T>(method, path, options, attempt + 1);\n      }\n    }\n\n    // Parse response body\n    let data: T | null = null;\n    let errorBody: { error?: string; error_description?: string; status?: number } | undefined;\n\n    const contentType = response.headers.get('Content-Type');\n    if (contentType?.includes('json')) {\n      const body = await response.json() as Record<string, unknown>;\n      if (response.ok) {\n        data = body as T;\n      } else {\n        errorBody = body as typeof errorBody;\n      }\n    }\n\n    if (!response.ok) {\n      return {\n        data: null,\n        error: new PalbaseError(\n          errorBody?.error ?? 'unknown_error',\n          errorBody?.error_description ?? response.statusText,\n          response.status,\n          errorBody,\n        ),\n        status: response.status,\n      };\n    }\n\n    return { data, error: null, status: response.status };\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n","export type Platform = 'browser' | 'node' | 'react-native' | 'deno' | 'bun';\n\ndeclare const Deno: unknown;\ndeclare const process: { versions: Record<string, string> } | undefined;\n\nexport function detectPlatform(): Platform {\n  if (typeof Deno !== 'undefined') {\n    return 'deno';\n  }\n\n  if (process?.versions) {\n    if ('bun' in process.versions) {\n      return 'bun';\n    }\n    if ('node' in process.versions) {\n      return 'node';\n    }\n  }\n\n  if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {\n    return 'react-native';\n  }\n\n  return 'browser';\n}\n","import type { AuthStateCallback, Session, Unsubscribe } from './types.js';\n\nexport class TokenManager {\n  private session: Session | null = null;\n  private listeners: Set<AuthStateCallback> = new Set();\n  private refreshPromise: Promise<void> | null = null;\n\n  refreshFunction: ((refreshToken: string) => Promise<Session>) | null = null;\n\n  setSession(session: Session): void {\n    this.session = session;\n    this.notify('SESSION_SET', session);\n  }\n\n  getAccessToken(): string | null {\n    return this.session?.accessToken ?? null;\n  }\n\n  getRefreshToken(): string | null {\n    return this.session?.refreshToken ?? null;\n  }\n\n  clearSession(): void {\n    this.session = null;\n    this.notify('SESSION_CLEARED', null);\n  }\n\n  isExpired(): boolean {\n    if (!this.session) return true;\n    return Date.now() >= this.session.expiresAt;\n  }\n\n  async refreshSession(): Promise<void> {\n    if (!this.session?.refreshToken || !this.refreshFunction) {\n      return;\n    }\n\n    // Collapse concurrent refresh calls into a single request\n    if (this.refreshPromise) {\n      return this.refreshPromise;\n    }\n\n    this.refreshPromise = this.executeRefresh(this.session.refreshToken);\n\n    try {\n      await this.refreshPromise;\n    } finally {\n      this.refreshPromise = null;\n    }\n  }\n\n  onAuthStateChange(callback: AuthStateCallback): Unsubscribe {\n    this.listeners.add(callback);\n    return () => {\n      this.listeners.delete(callback);\n    };\n  }\n\n  private async executeRefresh(refreshToken: string): Promise<void> {\n    if (!this.refreshFunction) return;\n    const newSession = await this.refreshFunction(refreshToken);\n    this.setSession(newSession);\n  }\n\n  private notify(event: 'SESSION_SET' | 'SESSION_CLEARED', session: Session | null): void {\n    for (const listener of this.listeners) {\n      listener(event, session);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@palbase/core",
+  "version": "0.1.0",
+  "description": "Shared core for Palbase SDK — HTTP client, error types, token management",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seklabsnet/palbase-ts.git",
+    "directory": "core"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "biome check src/ __tests__/"
+  }
+}