get-db9 0.4.0 → 0.5.0

package/dist/{client-fUeI7kwU.d.cts → client-UKXFQNll.d.cts}

@@ -4,6 +4,9 @@ interface HttpClientOptions {
     baseUrl: string;
     fetch?: FetchFn;
     headers?: Record<string, string>;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
 }
 interface HttpClient {
     get<T>(path: string, params?: Record<string, string | undefined>): Promise<T>;
@@ -12,6 +15,8 @@ interface HttpClient {
     del<T>(path: string): Promise<T>;
     getRaw(path: string, params?: Record<string, string | undefined>): Promise<Response>;
     putRaw(path: string, body: BodyInit, headers?: Record<string, string>): Promise<Response>;
+    postRaw(path: string, body?: BodyInit, headers?: Record<string, string>): Promise<Response>;
+    delRaw(path: string, params?: Record<string, string | undefined>): Promise<Response>;
 }
 
 /** Credential fields stored in `~/.db9/credentials` (TOML). */
@@ -49,22 +54,19 @@ declare class MemoryCredentialStore implements CredentialStore {
 /** Returns a FileCredentialStore with the default path (`~/.db9/credentials`). */
 declare function defaultCredentialStore(): CredentialStore;
 
-/** A file or directory entry from fs9 readdir API */
-interface Fs9FileInfo {
+/** A file or directory entry from fs9 readdir/stat API */
+interface Fs9FileEntry {
     path: string;
-    type: 'file' | 'dir';
-    size: number;
-    mode: number;
-    mtime: string;
-}
-/** Response from fs9 stat API */
-interface Fs9StatResponse {
-    path: string;
-    is_dir: boolean;
-    is_file: boolean;
     size: number;
+    file_type: 'regular' | 'directory' | 'symlink';
     mode: number;
+    uid: number;
+    gid: number;
+    atime: number;
     mtime: number;
+    ctime: number;
+    etag: string;
+    symlink_target?: string;
 }
 /** Options for fs9 list operation */
 interface Fs9ListOptions {
@@ -91,12 +93,19 @@ interface ColumnInfo {
     name: string;
     type: string;
 }
+interface SqlErrorDetail {
+    message: string;
+    code?: string;
+    position?: number;
+    hint?: string;
+    detail?: string;
+}
 interface SqlResult {
     columns: ColumnInfo[];
     rows: unknown[][];
     row_count: number;
     command: string;
-    error?: string;
+    error?: string | SqlErrorDetail;
 }
 interface CreateTenantRequest {
     admin_user?: string;
@@ -291,6 +300,10 @@ interface CreateUserRequest {
     username: string;
     password: string;
 }
+interface CreateTokenRequest {
+    name?: string;
+    expires_in_days?: number;
+}
 interface CustomerResponse {
     id: string;
     email: string;
@@ -343,6 +356,13 @@ interface TokenResponse {
     created_at: string;
     expires_at?: string;
 }
+interface CreateTokenResponse {
+    id: string;
+    name: string;
+    token: string;
+    expires_at?: string;
+    created_at: string;
+}
 interface DumpResponse {
     sql: string;
     object_count: number;
@@ -376,6 +396,21 @@ interface MigrationMetadata {
     applied_at: string;
     sql_preview: string;
 }
+interface Fs9EventEntry {
+    id: string;
+    type: string;
+    path: string;
+    timestamp: string;
+    user_id?: string;
+    size?: number;
+    metadata?: Record<string, unknown>;
+}
+interface Fs9EventOptions {
+    limit?: number;
+    offset?: number;
+    path?: string;
+    type?: string;
+}
 type TenantState = 'CREATING' | 'ACTIVE' | 'DISABLING' | 'DISABLED' | 'CREATE_FAILED';
 
 interface Db9ClientOptions {
@@ -383,6 +418,9 @@ interface Db9ClientOptions {
     token?: string;
     fetch?: FetchFn;
     credentialStore?: CredentialStore;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
 }
 declare function createDb9Client(options?: Db9ClientOptions): {
     auth: {
@@ -393,10 +431,12 @@ declare function createDb9Client(options?: Db9ClientOptions): {
         me: () => Promise<CustomerResponse>;
         getAnonymousSecret: () => Promise<AnonymousSecretResponse>;
         claim: (req: ClaimRequest) => Promise<ClaimResponse>;
+        ensureAnonymousSecret: () => Promise<void>;
     };
     tokens: {
         list: () => Promise<TokenResponse[]>;
         revoke: (tokenId: string) => Promise<MessageResponse>;
+        create: (req: CreateTokenRequest) => Promise<CreateTokenResponse>;
     };
     databases: {
         create: (req: CreateDatabaseRequest) => Promise<DatabaseResponse>;
@@ -419,12 +459,17 @@ declare function createDb9Client(options?: Db9ClientOptions): {
         };
     };
     fs: {
-        list: (dbId: string, path: string, options?: Fs9ListOptions) => Promise<Fs9FileInfo[]>;
+        list: (dbId: string, path: string, options?: Fs9ListOptions) => Promise<Fs9FileEntry[]>;
         read: (dbId: string, path: string) => Promise<string>;
-        write: (dbId: string, path: string, content: string) => Promise<void>;
-        stat: (dbId: string, path: string) => Promise<Fs9StatResponse>;
+        readBinary: (dbId: string, path: string) => Promise<ArrayBuffer>;
+        write: (dbId: string, path: string, content: string | ArrayBuffer | Uint8Array | Blob) => Promise<void>;
+        stat: (dbId: string, path: string) => Promise<Fs9FileEntry>;
+        exists: (dbId: string, path: string) => Promise<boolean>;
+        mkdir: (dbId: string, path: string) => Promise<void>;
+        remove: (dbId: string, path: string) => Promise<void>;
+        events: (dbId: string, options?: Fs9EventOptions) => Promise<Fs9EventEntry[]>;
     };
 };
 type Db9Client = ReturnType<typeof createDb9Client>;
 
-export { type SqlQueryResponse as $, type AdminCreateUserRequest as A, type BatchCreateRequest as B, type CredentialStore as C, type DatabaseResponse as D, type DumpRequest as E, type FetchFn as F, type DumpResponse as G, type Endpoint as H, FileCredentialStore as I, type HealthResponse as J, type HttpClient as K, type HttpClientOptions as L, type ListTenantsParams as M, type LoginRequest as N, type LoginResponse as O, MemoryCredentialStore as P, type MessageResponse as Q, type MigrationApplyRequest as R, type MigrationApplyResponse as S, type MigrationMetadata as T, type ObservabilitySummary as U, type PasswordResetResponse as V, type QuerySample as W, type RegisterRequest as X, type SchemaResponse as Y, type SqlExecuteRequest as Z, type SqlQueryRequest as _, type AnonymousRefreshRequest as a, type SqlResult as a0, type TableMetadata as a1, type TenantConnectRequest as a2, type TenantConnectResponse as a3, type TenantListResponse as a4, type TenantObservabilityResponse as a5, type TenantResponse as a6, type TenantState as a7, type TenantUpdateRequest as a8, type TokenResponse as a9, type UserCreateResponse as aa, type UserResponse as ab, type ViewMetadata as ac, createDb9Client as ad, defaultCredentialStore as ae, type AnonymousRefreshResponse as b, type AnonymousRegisterResponse as c, type AnonymousSecretResponse as d, type AuditLogParams as e, type AuditLogResponse as f, type BatchCreateResponse as g, type BatchDeleteRequest as h, type BatchDeleteResponse as i, type BatchItemError as j, type BatchUpdateRequest as k, type BatchUpdateResponse as l, type BranchRequest as m, type ClaimRequest as n, type ClaimResponse as o, type ColumnInfo as p, type ColumnMetadata as q, type CreateDatabaseRequest as r, type CreateTenantRequest as s, type CreateTenantResponse as t, type CreateUserRequest as u, type Credentials as v, type CustomerPasswordResetResponse as w, type CustomerResponse as x, type Db9Client as y, type Db9ClientOptions as z };
+export { type RegisterRequest as $, type AdminCreateUserRequest as A, type BatchCreateRequest as B, type CredentialStore as C, type DatabaseResponse as D, type Db9Client as E, type FetchFn as F, type Db9ClientOptions as G, type DumpRequest as H, type DumpResponse as I, type Endpoint as J, FileCredentialStore as K, type Fs9EventEntry as L, type Fs9EventOptions as M, type HealthResponse as N, type HttpClient as O, type HttpClientOptions as P, type ListTenantsParams as Q, type LoginRequest as R, type LoginResponse as S, MemoryCredentialStore as T, type MessageResponse as U, type MigrationApplyRequest as V, type MigrationApplyResponse as W, type MigrationMetadata as X, type ObservabilitySummary as Y, type PasswordResetResponse as Z, type QuerySample as _, type AnonymousRefreshRequest as a, type SchemaResponse as a0, type SqlErrorDetail as a1, type SqlExecuteRequest as a2, type SqlQueryRequest as a3, type SqlQueryResponse as a4, type SqlResult as a5, type TableMetadata as a6, type TenantConnectRequest as a7, type TenantConnectResponse as a8, type TenantListResponse as a9, type TenantObservabilityResponse as aa, type TenantResponse as ab, type TenantState as ac, type TenantUpdateRequest as ad, type TokenResponse as ae, type UserCreateResponse as af, type UserResponse as ag, type ViewMetadata as ah, createDb9Client as ai, defaultCredentialStore as aj, type AnonymousRefreshResponse as b, type AnonymousRegisterResponse as c, type AnonymousSecretResponse as d, type AuditLogParams as e, type AuditLogResponse as f, type BatchCreateResponse as g, type BatchDeleteRequest as h, type BatchDeleteResponse as i, type BatchItemError as j, type BatchUpdateRequest as k, type BatchUpdateResponse as l, type BranchRequest as m, type ClaimRequest as n, type ClaimResponse as o, type ColumnInfo as p, type ColumnMetadata as q, type CreateDatabaseRequest as r, type CreateTenantRequest as s, type CreateTenantResponse as t, type CreateTokenRequest as u, type CreateTokenResponse as v, type CreateUserRequest as w, type Credentials as x, type CustomerPasswordResetResponse as y, type CustomerResponse as z };

package/dist/{client-fUeI7kwU.d.ts → client-UKXFQNll.d.ts}

@@ -4,6 +4,9 @@ interface HttpClientOptions {
     baseUrl: string;
     fetch?: FetchFn;
     headers?: Record<string, string>;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
 }
 interface HttpClient {
     get<T>(path: string, params?: Record<string, string | undefined>): Promise<T>;
@@ -12,6 +15,8 @@ interface HttpClient {
     del<T>(path: string): Promise<T>;
     getRaw(path: string, params?: Record<string, string | undefined>): Promise<Response>;
     putRaw(path: string, body: BodyInit, headers?: Record<string, string>): Promise<Response>;
+    postRaw(path: string, body?: BodyInit, headers?: Record<string, string>): Promise<Response>;
+    delRaw(path: string, params?: Record<string, string | undefined>): Promise<Response>;
 }
 
 /** Credential fields stored in `~/.db9/credentials` (TOML). */
@@ -49,22 +54,19 @@ declare class MemoryCredentialStore implements CredentialStore {
 /** Returns a FileCredentialStore with the default path (`~/.db9/credentials`). */
 declare function defaultCredentialStore(): CredentialStore;
 
-/** A file or directory entry from fs9 readdir API */
-interface Fs9FileInfo {
+/** A file or directory entry from fs9 readdir/stat API */
+interface Fs9FileEntry {
     path: string;
-    type: 'file' | 'dir';
-    size: number;
-    mode: number;
-    mtime: string;
-}
-/** Response from fs9 stat API */
-interface Fs9StatResponse {
-    path: string;
-    is_dir: boolean;
-    is_file: boolean;
     size: number;
+    file_type: 'regular' | 'directory' | 'symlink';
     mode: number;
+    uid: number;
+    gid: number;
+    atime: number;
     mtime: number;
+    ctime: number;
+    etag: string;
+    symlink_target?: string;
 }
 /** Options for fs9 list operation */
 interface Fs9ListOptions {
@@ -91,12 +93,19 @@ interface ColumnInfo {
     name: string;
     type: string;
 }
+interface SqlErrorDetail {
+    message: string;
+    code?: string;
+    position?: number;
+    hint?: string;
+    detail?: string;
+}
 interface SqlResult {
     columns: ColumnInfo[];
     rows: unknown[][];
     row_count: number;
     command: string;
-    error?: string;
+    error?: string | SqlErrorDetail;
 }
 interface CreateTenantRequest {
     admin_user?: string;
@@ -291,6 +300,10 @@ interface CreateUserRequest {
     username: string;
     password: string;
 }
+interface CreateTokenRequest {
+    name?: string;
+    expires_in_days?: number;
+}
 interface CustomerResponse {
     id: string;
     email: string;
@@ -343,6 +356,13 @@ interface TokenResponse {
     created_at: string;
     expires_at?: string;
 }
+interface CreateTokenResponse {
+    id: string;
+    name: string;
+    token: string;
+    expires_at?: string;
+    created_at: string;
+}
 interface DumpResponse {
     sql: string;
     object_count: number;
@@ -376,6 +396,21 @@ interface MigrationMetadata {
     applied_at: string;
     sql_preview: string;
 }
+interface Fs9EventEntry {
+    id: string;
+    type: string;
+    path: string;
+    timestamp: string;
+    user_id?: string;
+    size?: number;
+    metadata?: Record<string, unknown>;
+}
+interface Fs9EventOptions {
+    limit?: number;
+    offset?: number;
+    path?: string;
+    type?: string;
+}
 type TenantState = 'CREATING' | 'ACTIVE' | 'DISABLING' | 'DISABLED' | 'CREATE_FAILED';
 
 interface Db9ClientOptions {
@@ -383,6 +418,9 @@ interface Db9ClientOptions {
     token?: string;
     fetch?: FetchFn;
     credentialStore?: CredentialStore;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
 }
 declare function createDb9Client(options?: Db9ClientOptions): {
     auth: {
@@ -393,10 +431,12 @@ declare function createDb9Client(options?: Db9ClientOptions): {
         me: () => Promise<CustomerResponse>;
         getAnonymousSecret: () => Promise<AnonymousSecretResponse>;
         claim: (req: ClaimRequest) => Promise<ClaimResponse>;
+        ensureAnonymousSecret: () => Promise<void>;
     };
     tokens: {
         list: () => Promise<TokenResponse[]>;
         revoke: (tokenId: string) => Promise<MessageResponse>;
+        create: (req: CreateTokenRequest) => Promise<CreateTokenResponse>;
     };
     databases: {
         create: (req: CreateDatabaseRequest) => Promise<DatabaseResponse>;
@@ -419,12 +459,17 @@ declare function createDb9Client(options?: Db9ClientOptions): {
         };
     };
     fs: {
-        list: (dbId: string, path: string, options?: Fs9ListOptions) => Promise<Fs9FileInfo[]>;
+        list: (dbId: string, path: string, options?: Fs9ListOptions) => Promise<Fs9FileEntry[]>;
         read: (dbId: string, path: string) => Promise<string>;
-        write: (dbId: string, path: string, content: string) => Promise<void>;
-        stat: (dbId: string, path: string) => Promise<Fs9StatResponse>;
+        readBinary: (dbId: string, path: string) => Promise<ArrayBuffer>;
+        write: (dbId: string, path: string, content: string | ArrayBuffer | Uint8Array | Blob) => Promise<void>;
+        stat: (dbId: string, path: string) => Promise<Fs9FileEntry>;
+        exists: (dbId: string, path: string) => Promise<boolean>;
+        mkdir: (dbId: string, path: string) => Promise<void>;
+        remove: (dbId: string, path: string) => Promise<void>;
+        events: (dbId: string, options?: Fs9EventOptions) => Promise<Fs9EventEntry[]>;
     };
 };
 type Db9Client = ReturnType<typeof createDb9Client>;
 
-export { type SqlQueryResponse as $, type AdminCreateUserRequest as A, type BatchCreateRequest as B, type CredentialStore as C, type DatabaseResponse as D, type DumpRequest as E, type FetchFn as F, type DumpResponse as G, type Endpoint as H, FileCredentialStore as I, type HealthResponse as J, type HttpClient as K, type HttpClientOptions as L, type ListTenantsParams as M, type LoginRequest as N, type LoginResponse as O, MemoryCredentialStore as P, type MessageResponse as Q, type MigrationApplyRequest as R, type MigrationApplyResponse as S, type MigrationMetadata as T, type ObservabilitySummary as U, type PasswordResetResponse as V, type QuerySample as W, type RegisterRequest as X, type SchemaResponse as Y, type SqlExecuteRequest as Z, type SqlQueryRequest as _, type AnonymousRefreshRequest as a, type SqlResult as a0, type TableMetadata as a1, type TenantConnectRequest as a2, type TenantConnectResponse as a3, type TenantListResponse as a4, type TenantObservabilityResponse as a5, type TenantResponse as a6, type TenantState as a7, type TenantUpdateRequest as a8, type TokenResponse as a9, type UserCreateResponse as aa, type UserResponse as ab, type ViewMetadata as ac, createDb9Client as ad, defaultCredentialStore as ae, type AnonymousRefreshResponse as b, type AnonymousRegisterResponse as c, type AnonymousSecretResponse as d, type AuditLogParams as e, type AuditLogResponse as f, type BatchCreateResponse as g, type BatchDeleteRequest as h, type BatchDeleteResponse as i, type BatchItemError as j, type BatchUpdateRequest as k, type BatchUpdateResponse as l, type BranchRequest as m, type ClaimRequest as n, type ClaimResponse as o, type ColumnInfo as p, type ColumnMetadata as q, type CreateDatabaseRequest as r, type CreateTenantRequest as s, type CreateTenantResponse as t, type CreateUserRequest as u, type Credentials as v, type CustomerPasswordResetResponse as w, type CustomerResponse as x, type Db9Client as y, type Db9ClientOptions as z };
+export { type RegisterRequest as $, type AdminCreateUserRequest as A, type BatchCreateRequest as B, type CredentialStore as C, type DatabaseResponse as D, type Db9Client as E, type FetchFn as F, type Db9ClientOptions as G, type DumpRequest as H, type DumpResponse as I, type Endpoint as J, FileCredentialStore as K, type Fs9EventEntry as L, type Fs9EventOptions as M, type HealthResponse as N, type HttpClient as O, type HttpClientOptions as P, type ListTenantsParams as Q, type LoginRequest as R, type LoginResponse as S, MemoryCredentialStore as T, type MessageResponse as U, type MigrationApplyRequest as V, type MigrationApplyResponse as W, type MigrationMetadata as X, type ObservabilitySummary as Y, type PasswordResetResponse as Z, type QuerySample as _, type AnonymousRefreshRequest as a, type SchemaResponse as a0, type SqlErrorDetail as a1, type SqlExecuteRequest as a2, type SqlQueryRequest as a3, type SqlQueryResponse as a4, type SqlResult as a5, type TableMetadata as a6, type TenantConnectRequest as a7, type TenantConnectResponse as a8, type TenantListResponse as a9, type TenantObservabilityResponse as aa, type TenantResponse as ab, type TenantState as ac, type TenantUpdateRequest as ad, type TokenResponse as ae, type UserCreateResponse as af, type UserResponse as ag, type ViewMetadata as ah, createDb9Client as ai, defaultCredentialStore as aj, type AnonymousRefreshResponse as b, type AnonymousRegisterResponse as c, type AnonymousSecretResponse as d, type AuditLogParams as e, type AuditLogResponse as f, type BatchCreateResponse as g, type BatchDeleteRequest as h, type BatchDeleteResponse as i, type BatchItemError as j, type BatchUpdateRequest as k, type BatchUpdateResponse as l, type BranchRequest as m, type ClaimRequest as n, type ClaimResponse as o, type ColumnInfo as p, type ColumnMetadata as q, type CreateDatabaseRequest as r, type CreateTenantRequest as s, type CreateTenantResponse as t, type CreateTokenRequest as u, type CreateTokenResponse as v, type CreateUserRequest as w, type Credentials as x, type CustomerPasswordResetResponse as y, type CustomerResponse as z };