foundation-sdk 0.2.6 → 0.2.7

package/dist/types-HdCjnyCt.d.cts

@@ -0,0 +1,204 @@
+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;
+}
+type AuthProvider = (config: Record<string, unknown>) => Promise<AuthClient>;
+interface FoundationConfig {
+    /** Backend config endpoint URL. If omitted, reads from /foundation-env.json */
+    configUrl?: string;
+    tenantId?: string;
+    appId?: string;
+    /** Override API base URL (e.g. '/api' when using a dev proxy) */
+    baseUrl?: string;
+    /** Auth client instance, or provider factory from foundation-sdk/cognito or foundation-sdk/auth0 */
+    auth?: AuthClient | AuthProvider;
+}
+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;
+}
+
+export type { AuthClient as A, DbService as D, EntityChangeEvent as E, FoundationConfig as F, IntegrationService as I, LogService as L, OpenApiService as O, User as U, Foundation as a, FullConfig as b, FileMetadata as c, AuthProvider as d, AuthService as e, FilesService as f, AccountService as g, Integration as h, IntegrationConnection as i, IntegrationDetail as j };

package/dist/types-HdCjnyCt.d.ts

@@ -0,0 +1,204 @@
+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;
+}
+type AuthProvider = (config: Record<string, unknown>) => Promise<AuthClient>;
+interface FoundationConfig {
+    /** Backend config endpoint URL. If omitted, reads from /foundation-env.json */
+    configUrl?: string;
+    tenantId?: string;
+    appId?: string;
+    /** Override API base URL (e.g. '/api' when using a dev proxy) */
+    baseUrl?: string;
+    /** Auth client instance, or provider factory from foundation-sdk/cognito or foundation-sdk/auth0 */
+    auth?: AuthClient | AuthProvider;
+}
+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;
+}
+
+export type { AuthClient as A, DbService as D, EntityChangeEvent as E, FoundationConfig as F, IntegrationService as I, LogService as L, OpenApiService as O, User as U, Foundation as a, FullConfig as b, FileMetadata as c, AuthProvider as d, AuthService as e, FilesService as f, AccountService as g, Integration as h, IntegrationConnection as i, IntegrationDetail as j };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foundation-sdk",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "TypeScript SDK for Foundation",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -12,10 +12,12 @@
       "import": "./dist/index.js"
     },
     "./auth0": {
+      "types": "./dist/auth-auth0.d.ts",
       "require": "./dist/auth-auth0.cjs",
       "import": "./dist/auth-auth0.js"
     },
     "./cognito": {
+      "types": "./dist/auth-cognito.d.ts",
       "require": "./dist/auth-cognito.cjs",
       "import": "./dist/auth-cognito.js"
     }