foundation-sdk 0.1.13 → 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,210 @@
+interface User {
+    id: string;
+    email: string;
+    name?: string;
+    picture?: string;
+    [key: string]: unknown;
+}
+interface FileMetadata {
+    id: string;
+    name: string;
+    type: string;
+    size: number;
+    url: string;
+    folder?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+}
+interface EntityChangeEvent {
+    changeType: string;
+    entityId?: string;
+    id?: string;
+    namespace?: string;
+    timestamp?: number;
+}
+interface FoundationConfig {
+    configUrl: string;
+    tenantId?: string;
+    appId?: string;
+    /** Override API base URL (e.g. '/api' when using a dev proxy) */
+    baseUrl?: string;
+    auth?: AuthClient;
+}
+interface FullConfig {
+    readonly app: {
+        id: string;
+        name: string;
+        version: string;
+        environment: string;
+        [key: string]: unknown;
+    };
+    readonly features: Record<string, unknown>;
+    readonly plans: unknown[];
+    readonly theme: {
+        colors: Record<string, string>;
+        dark: Record<string, string>;
+        defaultColorScheme?: string;
+    };
+    readonly connectors: Record<string, unknown>;
+    readonly resources: Record<string, string>;
+    readonly auth: {
+        provider: string;
+        [key: string]: unknown;
+    };
+    readonly raw: Record<string, unknown>;
+}
+interface AuthClient {
+    login(options?: Record<string, unknown>): Promise<void>;
+    logout(options?: Record<string, unknown>): void | Promise<void>;
+    getUser(): Promise<User | undefined>;
+    getTokenSilently(options?: Record<string, unknown>): Promise<string>;
+    isAuthenticated(): Promise<boolean>;
+    signIn?(email: string, password: string): Promise<void>;
+    signUp?(email: string, password: string, metadata?: Record<string, unknown>): Promise<void>;
+    forgotPassword?(email: string): Promise<void>;
+    resetPassword?(code: string, newPassword: string): Promise<void>;
+}
+interface AuthService {
+    readonly user: User | null;
+    readonly isAuthenticated: boolean;
+    getToken(): Promise<string>;
+    /** Redirect-based login (Auth0 Universal Login / Cognito Hosted UI) */
+    login(options?: Record<string, unknown>): Promise<void>;
+    logout(options?: Record<string, unknown>): Promise<void>;
+    /** Direct sign in with credentials (for custom login forms) */
+    signIn(email: string, password: string): Promise<void>;
+    /** Direct sign up (for custom registration forms) */
+    signUp(email: string, password: string, metadata?: Record<string, unknown>): Promise<void>;
+    /** Initiate password reset */
+    forgotPassword(email: string): Promise<void>;
+    /** Complete password reset with code */
+    resetPassword(code: string, newPassword: string): Promise<void>;
+    onChange(callback: (user: User | null) => void): () => void;
+}
+interface DbService {
+    list<T = unknown>(entity: string, options?: {
+        filters?: Record<string, unknown>;
+        limit?: number;
+        cursor?: string;
+        orderBy?: string;
+        orderDir?: 'asc' | 'desc';
+    }): Promise<{
+        items: T[];
+        nextCursor?: string;
+    }>;
+    get<T = unknown>(entity: string, id: string): Promise<T>;
+    create<T = unknown>(entity: string, data: Partial<T>): Promise<T>;
+    update<T = unknown>(entity: string, id: string, updates: Partial<T>): Promise<T>;
+    save<T = unknown>(entity: string, data: Partial<T>): Promise<T>;
+    delete(entity: string, id: string): Promise<void>;
+}
+interface FilesService {
+    initiate(options: {
+        name: string;
+        contentType: string;
+        contentLength: number;
+        metadata?: Record<string, unknown>;
+        sha256: string;
+    }): Promise<{
+        id: string;
+        name: string;
+        signedUrl: string;
+        signedData: Record<string, string>;
+    }>;
+    upload(options: {
+        name: string;
+        contentType: string;
+        file: ArrayBuffer | Blob | File;
+        sha256: string;
+    }): Promise<{
+        id: string;
+        name: string;
+        status: string;
+        s3UploadComplete: boolean;
+    }>;
+    get(fileId: string): Promise<FileMetadata>;
+    delete(fileId: string): Promise<void>;
+    list(options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: FileMetadata[];
+        nextCursor?: string;
+    }>;
+}
+interface AccountService {
+    get<TUser = User, TAccount = Record<string, unknown>>(): Promise<{
+        user: TUser;
+        account: TAccount;
+    }>;
+    update(data: Record<string, unknown>): Promise<void>;
+    usage(): Promise<Record<string, unknown>>;
+    resendVerification(): Promise<void>;
+}
+interface Integration {
+    id: string;
+    name: string;
+    description?: string;
+    icon?: string;
+    authType?: string;
+    [key: string]: unknown;
+}
+interface IntegrationConnection {
+    id: string;
+    source: string;
+    connected: boolean;
+    [key: string]: unknown;
+}
+interface IntegrationDetail extends Integration {
+    connections: IntegrationConnection[];
+    connected: boolean;
+    connectionCount: number;
+}
+interface IntegrationService {
+    list(): Promise<Integration[]>;
+    connections(): Promise<IntegrationConnection[]>;
+    all(): Promise<IntegrationDetail[]>;
+    status(source: string): Promise<{
+        connected: boolean;
+        connections: IntegrationConnection[];
+    }>;
+    connect(source: string): Promise<{
+        success: boolean;
+        configuration?: unknown;
+        message?: string;
+    }>;
+    disconnect(source: string, configurationId: string): Promise<void>;
+}
+interface OpenApiService {
+    get(): Promise<Record<string, unknown>>;
+}
+interface LogService {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    event(event: string, data?: Record<string, unknown>): void;
+}
+interface Foundation {
+    readonly ready: Promise<void>;
+    readonly isReady: boolean;
+    auth: AuthService;
+    db: DbService;
+    files: FilesService;
+    integration: IntegrationService;
+    account: AccountService;
+    config: FullConfig;
+    openapi: OpenApiService;
+    log: LogService;
+    on(event: string, callback: (event: EntityChangeEvent) => void): () => void;
+}
+
+/**
+ * Foundation SDK — typed API client for the Foundation platform.
+ *
+ * One input: a config URL. The SDK fetches it, discovers auth, API URLs,
+ * features, plans, theme, connectors — everything. Self-configuring.
+ */
+
+declare function createFoundation(options: FoundationConfig): Promise<Foundation>;
+
+export { type AccountService, type AuthClient, type AuthService, type DbService, type EntityChangeEvent, type FileMetadata, type FilesService, type Foundation, type FoundationConfig, type FullConfig, type Integration, type IntegrationConnection, type IntegrationDetail, type IntegrationService, type LogService, type OpenApiService, type User, createFoundation };

package/dist/index.d.ts

@@ -1,3 +1,210 @@
-export { createFoundationClient, resetFoundationClient } from './client';
-export type { FoundationClient, User, Theme, RouterState, EntityDefinition, EntityChangeEvent, AuthService, ThemeService, RouterService, DbService, UIService, StorageService, FilesService, FileMetadata, LogService, ConfigService, StuffService, StuffItem } from './types';
-//# sourceMappingURL=index.d.ts.map
+interface User {
+    id: string;
+    email: string;
+    name?: string;
+    picture?: string;
+    [key: string]: unknown;
+}
+interface FileMetadata {
+    id: string;
+    name: string;
+    type: string;
+    size: number;
+    url: string;
+    folder?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+}
+interface EntityChangeEvent {
+    changeType: string;
+    entityId?: string;
+    id?: string;
+    namespace?: string;
+    timestamp?: number;
+}
+interface FoundationConfig {
+    configUrl: string;
+    tenantId?: string;
+    appId?: string;
+    /** Override API base URL (e.g. '/api' when using a dev proxy) */
+    baseUrl?: string;
+    auth?: AuthClient;
+}
+interface FullConfig {
+    readonly app: {
+        id: string;
+        name: string;
+        version: string;
+        environment: string;
+        [key: string]: unknown;
+    };
+    readonly features: Record<string, unknown>;
+    readonly plans: unknown[];
+    readonly theme: {
+        colors: Record<string, string>;
+        dark: Record<string, string>;
+        defaultColorScheme?: string;
+    };
+    readonly connectors: Record<string, unknown>;
+    readonly resources: Record<string, string>;
+    readonly auth: {
+        provider: string;
+        [key: string]: unknown;
+    };
+    readonly raw: Record<string, unknown>;
+}
+interface AuthClient {
+    login(options?: Record<string, unknown>): Promise<void>;
+    logout(options?: Record<string, unknown>): void | Promise<void>;
+    getUser(): Promise<User | undefined>;
+    getTokenSilently(options?: Record<string, unknown>): Promise<string>;
+    isAuthenticated(): Promise<boolean>;
+    signIn?(email: string, password: string): Promise<void>;
+    signUp?(email: string, password: string, metadata?: Record<string, unknown>): Promise<void>;
+    forgotPassword?(email: string): Promise<void>;
+    resetPassword?(code: string, newPassword: string): Promise<void>;
+}
+interface AuthService {
+    readonly user: User | null;
+    readonly isAuthenticated: boolean;
+    getToken(): Promise<string>;
+    /** Redirect-based login (Auth0 Universal Login / Cognito Hosted UI) */
+    login(options?: Record<string, unknown>): Promise<void>;
+    logout(options?: Record<string, unknown>): Promise<void>;
+    /** Direct sign in with credentials (for custom login forms) */
+    signIn(email: string, password: string): Promise<void>;
+    /** Direct sign up (for custom registration forms) */
+    signUp(email: string, password: string, metadata?: Record<string, unknown>): Promise<void>;
+    /** Initiate password reset */
+    forgotPassword(email: string): Promise<void>;
+    /** Complete password reset with code */
+    resetPassword(code: string, newPassword: string): Promise<void>;
+    onChange(callback: (user: User | null) => void): () => void;
+}
+interface DbService {
+    list<T = unknown>(entity: string, options?: {
+        filters?: Record<string, unknown>;
+        limit?: number;
+        cursor?: string;
+        orderBy?: string;
+        orderDir?: 'asc' | 'desc';
+    }): Promise<{
+        items: T[];
+        nextCursor?: string;
+    }>;
+    get<T = unknown>(entity: string, id: string): Promise<T>;
+    create<T = unknown>(entity: string, data: Partial<T>): Promise<T>;
+    update<T = unknown>(entity: string, id: string, updates: Partial<T>): Promise<T>;
+    save<T = unknown>(entity: string, data: Partial<T>): Promise<T>;
+    delete(entity: string, id: string): Promise<void>;
+}
+interface FilesService {
+    initiate(options: {
+        name: string;
+        contentType: string;
+        contentLength: number;
+        metadata?: Record<string, unknown>;
+        sha256: string;
+    }): Promise<{
+        id: string;
+        name: string;
+        signedUrl: string;
+        signedData: Record<string, string>;
+    }>;
+    upload(options: {
+        name: string;
+        contentType: string;
+        file: ArrayBuffer | Blob | File;
+        sha256: string;
+    }): Promise<{
+        id: string;
+        name: string;
+        status: string;
+        s3UploadComplete: boolean;
+    }>;
+    get(fileId: string): Promise<FileMetadata>;
+    delete(fileId: string): Promise<void>;
+    list(options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: FileMetadata[];
+        nextCursor?: string;
+    }>;
+}
+interface AccountService {
+    get<TUser = User, TAccount = Record<string, unknown>>(): Promise<{
+        user: TUser;
+        account: TAccount;
+    }>;
+    update(data: Record<string, unknown>): Promise<void>;
+    usage(): Promise<Record<string, unknown>>;
+    resendVerification(): Promise<void>;
+}
+interface Integration {
+    id: string;
+    name: string;
+    description?: string;
+    icon?: string;
+    authType?: string;
+    [key: string]: unknown;
+}
+interface IntegrationConnection {
+    id: string;
+    source: string;
+    connected: boolean;
+    [key: string]: unknown;
+}
+interface IntegrationDetail extends Integration {
+    connections: IntegrationConnection[];
+    connected: boolean;
+    connectionCount: number;
+}
+interface IntegrationService {
+    list(): Promise<Integration[]>;
+    connections(): Promise<IntegrationConnection[]>;
+    all(): Promise<IntegrationDetail[]>;
+    status(source: string): Promise<{
+        connected: boolean;
+        connections: IntegrationConnection[];
+    }>;
+    connect(source: string): Promise<{
+        success: boolean;
+        configuration?: unknown;
+        message?: string;
+    }>;
+    disconnect(source: string, configurationId: string): Promise<void>;
+}
+interface OpenApiService {
+    get(): Promise<Record<string, unknown>>;
+}
+interface LogService {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    event(event: string, data?: Record<string, unknown>): void;
+}
+interface Foundation {
+    readonly ready: Promise<void>;
+    readonly isReady: boolean;
+    auth: AuthService;
+    db: DbService;
+    files: FilesService;
+    integration: IntegrationService;
+    account: AccountService;
+    config: FullConfig;
+    openapi: OpenApiService;
+    log: LogService;
+    on(event: string, callback: (event: EntityChangeEvent) => void): () => void;
+}
+
+/**
+ * Foundation SDK — typed API client for the Foundation platform.
+ *
+ * One input: a config URL. The SDK fetches it, discovers auth, API URLs,
+ * features, plans, theme, connectors — everything. Self-configuring.
+ */
+
+declare function createFoundation(options: FoundationConfig): Promise<Foundation>;
+
+export { type AccountService, type AuthClient, type AuthService, type DbService, type EntityChangeEvent, type FileMetadata, type FilesService, type Foundation, type FoundationConfig, type FullConfig, type Integration, type IntegrationConnection, type IntegrationDetail, type IntegrationService, type LogService, type OpenApiService, type User, createFoundation };