@haex-space/vault-sdk 2.2.5 → 2.2.7

package/dist/types-FE9ewl3r.d.mts

@@ -0,0 +1,238 @@
+/**
+ * Central event name definitions for HaexHub extensions
+ *
+ * Event Naming Schema: haextension:{subject}:{predicate}
+ *
+ * IMPORTANT: Tauri event names can only contain:
+ * - Alphanumeric characters (a-z, A-Z, 0-9)
+ * - Hyphens (-)
+ * - Slashes (/)
+ * - Colons (:)
+ * - Underscores (_)
+ *
+ * NO dots (.) allowed!
+ */
+declare const HAEXTENSION_EVENTS: {
+    /** Context (theme, locale, platform) has changed */
+    readonly CONTEXT_CHANGED: "haextension:context:changed";
+    /** Search request from HaexHub */
+    readonly SEARCH_REQUEST: "haextension:search:request";
+};
+type HaextensionEvent = typeof HAEXTENSION_EVENTS[keyof typeof HAEXTENSION_EVENTS];
+
+declare const DEFAULT_TIMEOUT = 30000;
+declare const TABLE_SEPARATOR = "__";
+/**
+ * Build a fully qualified table name for extensions.
+ * Use this in Drizzle schemas to create table names at build time.
+ *
+ * @param publicKey - The extension's public key (from manifest.json)
+ * @param extensionName - The extension name (from manifest.json or package.json)
+ * @param tableName - The table name (e.g., "users", "items")
+ * @returns Fully qualified table name: `{publicKey}__{extensionName}__{tableName}`
+ *
+ * @example
+ * ```typescript
+ * import { getTableName } from "@haex-space/vault-sdk";
+ * import manifest from "../haextension/manifest.json";
+ * import pkg from "../package.json";
+ *
+ * const tableName = (name: string) =>
+ *   getTableName(manifest.publicKey, manifest.name || pkg.name, name);
+ *
+ * export const users = sqliteTable(tableName("users"), { ... });
+ * ```
+ */
+declare function getTableName(publicKey: string, extensionName: string, tableName: string): string;
+interface HaexHubRequest {
+    method: string;
+    params: Record<string, unknown>;
+    timestamp: number;
+}
+interface HaexHubResponse<T = unknown> {
+    id: string;
+    result?: T;
+    error?: HaexHubError;
+}
+interface ExtensionInfo {
+    publicKey: string;
+    name: string;
+    version: string;
+    displayName?: string;
+    namespace?: string;
+}
+interface ApplicationContext {
+    theme: "light" | "dark" | "system";
+    locale: string;
+    platform: "linux" | "macos" | "ios" | "freebsd" | "dragonfly" | "netbsd" | "openbsd" | "solaris" | "android" | "windows" | undefined;
+}
+interface SearchQuery {
+    query: string;
+    filters?: Record<string, unknown>;
+    limit?: number;
+}
+interface SearchResult {
+    id: string;
+    title: string;
+    description?: string;
+    type: string;
+    data?: Record<string, unknown>;
+    score?: number;
+}
+declare enum PermissionStatus {
+    GRANTED = "granted",
+    DENIED = "denied",
+    ASK = "ask"
+}
+interface PermissionResponse {
+    status: PermissionStatus;
+    permanent: boolean;
+}
+interface DatabasePermission {
+    extensionId: string;
+    resource: string;
+    operation: "read" | "write";
+    path: string;
+}
+interface DatabasePermissionRequest {
+    resource: string;
+    operation: "read" | "write";
+    reason?: string;
+}
+interface DatabaseQueryParams {
+    query: string;
+    params?: unknown[];
+}
+interface DatabaseQueryResult {
+    rows: unknown[];
+    columns?: string[];
+    rowsAffected: number;
+    lastInsertId?: number;
+}
+interface DatabaseExecuteParams {
+    statements: string[];
+}
+interface MigrationResult {
+    appliedCount: number;
+    alreadyAppliedCount: number;
+    appliedMigrations: string[];
+}
+interface Migration {
+    name: string;
+    sql: string;
+}
+interface DatabaseTableInfo {
+    name: string;
+    columns: DatabaseColumnInfo[];
+}
+interface DatabaseColumnInfo {
+    name: string;
+    type: string;
+    notNull: boolean;
+    defaultValue?: unknown;
+    primaryKey: boolean;
+}
+interface HaexHubEvent {
+    type: string;
+    data: unknown;
+    timestamp: number;
+}
+interface ContextChangedEvent extends HaexHubEvent {
+    type: typeof HAEXTENSION_EVENTS.CONTEXT_CHANGED;
+    data: {
+        context: ApplicationContext;
+    };
+}
+interface SearchRequestEvent extends HaexHubEvent {
+    type: typeof HAEXTENSION_EVENTS.SEARCH_REQUEST;
+    data: {
+        query: SearchQuery;
+        requestId: string;
+    };
+}
+type EventCallback = (event: HaexHubEvent) => void;
+interface ExtensionManifest {
+    name: string;
+    version: string;
+    author?: string | null;
+    entry?: string | null;
+    icon?: string | null;
+    publicKey: string;
+    signature: string;
+    permissions: {
+        database?: any[];
+        filesystem?: any[];
+        http?: any[];
+        shell?: any[];
+    };
+    homepage?: string | null;
+    description?: string | null;
+    singleInstance?: boolean | null;
+    displayMode?: "auto" | "window" | "iframe" | null;
+    /**
+     * Path to the migrations directory relative to the extension root.
+     * Contains Drizzle-style migrations with meta/_journal.json and *.sql files.
+     * These migrations will be applied when the extension is installed.
+     * Example: "database/migrations"
+     */
+    migrationsDir?: string | null;
+}
+interface HaexHubConfig {
+    debug?: boolean;
+    timeout?: number;
+    /** Extension manifest data (auto-injected by framework integrations) */
+    manifest?: ExtensionManifest;
+}
+interface WebRequestOptions {
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+    headers?: Record<string, string>;
+    body?: string | ArrayBuffer | Blob;
+    timeout?: number;
+}
+interface WebResponse {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: ArrayBuffer;
+    url: string;
+}
+declare enum ErrorCode {
+    TIMEOUT = "TIMEOUT",
+    NOT_IN_IFRAME = "NOT_IN_IFRAME",
+    UNAUTHORIZED_ORIGIN = "UNAUTHORIZED_ORIGIN",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    INVALID_PUBLIC_KEY = "INVALID_PUBLIC_KEY",
+    INVALID_EXTENSION_NAME = "INVALID_EXTENSION_NAME",
+    INVALID_TABLE_NAME = "INVALID_TABLE_NAME",
+    INVALID_PARAMS = "INVALID_PARAMS",
+    EXTENSION_NOT_INITIALIZED = "EXTENSION_NOT_INITIALIZED",
+    EXTENSION_INFO_UNAVAILABLE = "EXTENSION_INFO_UNAVAILABLE",
+    METHOD_NOT_FOUND = "METHOD_NOT_FOUND",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    DATABASE_ERROR = "DATABASE_ERROR",
+    WEB_ERROR = "WEB_ERROR"
+}
+interface HaexHubError {
+    code: ErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+declare class HaexHubError extends Error {
+    code: ErrorCode;
+    messageKey: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, messageKey: string, details?: Record<string, unknown> | undefined);
+    /**
+     * Get localized error message
+     * @param locale - Locale code (e.g., 'en', 'de')
+     * @param translations - Translation object
+     */
+    getLocalizedMessage(locale?: string, translations?: Record<string, Record<string, string>>): string;
+    toJSON(): {
+        code: ErrorCode;
+        message: string;
+        details: Record<string, unknown> | undefined;
+    };
+}
+
+export { type ApplicationContext as A, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type HaexHubConfig as H, type Migration as M, type PermissionResponse as P, type SearchResult as S, TABLE_SEPARATOR as T, type WebRequestOptions as W, type ExtensionInfo as a, type MigrationResult as b, type WebResponse as c, type DatabasePermissionRequest as d, type EventCallback as e, type HaexHubRequest as f, type HaexHubResponse as g, type HaexHubEvent as h, type DatabasePermission as i, type DatabaseQueryParams as j, type DatabaseExecuteParams as k, type DatabaseTableInfo as l, type DatabaseColumnInfo as m, type SearchQuery as n, type SearchRequestEvent as o, PermissionStatus as p, ErrorCode as q, DEFAULT_TIMEOUT as r, getTableName as s, HaexHubError as t, HAEXTENSION_EVENTS as u, type HaextensionEvent as v };

package/dist/types-FE9ewl3r.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Central event name definitions for HaexHub extensions
+ *
+ * Event Naming Schema: haextension:{subject}:{predicate}
+ *
+ * IMPORTANT: Tauri event names can only contain:
+ * - Alphanumeric characters (a-z, A-Z, 0-9)
+ * - Hyphens (-)
+ * - Slashes (/)
+ * - Colons (:)
+ * - Underscores (_)
+ *
+ * NO dots (.) allowed!
+ */
+declare const HAEXTENSION_EVENTS: {
+    /** Context (theme, locale, platform) has changed */
+    readonly CONTEXT_CHANGED: "haextension:context:changed";
+    /** Search request from HaexHub */
+    readonly SEARCH_REQUEST: "haextension:search:request";
+};
+type HaextensionEvent = typeof HAEXTENSION_EVENTS[keyof typeof HAEXTENSION_EVENTS];
+
+declare const DEFAULT_TIMEOUT = 30000;
+declare const TABLE_SEPARATOR = "__";
+/**
+ * Build a fully qualified table name for extensions.
+ * Use this in Drizzle schemas to create table names at build time.
+ *
+ * @param publicKey - The extension's public key (from manifest.json)
+ * @param extensionName - The extension name (from manifest.json or package.json)
+ * @param tableName - The table name (e.g., "users", "items")
+ * @returns Fully qualified table name: `{publicKey}__{extensionName}__{tableName}`
+ *
+ * @example
+ * ```typescript
+ * import { getTableName } from "@haex-space/vault-sdk";
+ * import manifest from "../haextension/manifest.json";
+ * import pkg from "../package.json";
+ *
+ * const tableName = (name: string) =>
+ *   getTableName(manifest.publicKey, manifest.name || pkg.name, name);
+ *
+ * export const users = sqliteTable(tableName("users"), { ... });
+ * ```
+ */
+declare function getTableName(publicKey: string, extensionName: string, tableName: string): string;
+interface HaexHubRequest {
+    method: string;
+    params: Record<string, unknown>;
+    timestamp: number;
+}
+interface HaexHubResponse<T = unknown> {
+    id: string;
+    result?: T;
+    error?: HaexHubError;
+}
+interface ExtensionInfo {
+    publicKey: string;
+    name: string;
+    version: string;
+    displayName?: string;
+    namespace?: string;
+}
+interface ApplicationContext {
+    theme: "light" | "dark" | "system";
+    locale: string;
+    platform: "linux" | "macos" | "ios" | "freebsd" | "dragonfly" | "netbsd" | "openbsd" | "solaris" | "android" | "windows" | undefined;
+}
+interface SearchQuery {
+    query: string;
+    filters?: Record<string, unknown>;
+    limit?: number;
+}
+interface SearchResult {
+    id: string;
+    title: string;
+    description?: string;
+    type: string;
+    data?: Record<string, unknown>;
+    score?: number;
+}
+declare enum PermissionStatus {
+    GRANTED = "granted",
+    DENIED = "denied",
+    ASK = "ask"
+}
+interface PermissionResponse {
+    status: PermissionStatus;
+    permanent: boolean;
+}
+interface DatabasePermission {
+    extensionId: string;
+    resource: string;
+    operation: "read" | "write";
+    path: string;
+}
+interface DatabasePermissionRequest {
+    resource: string;
+    operation: "read" | "write";
+    reason?: string;
+}
+interface DatabaseQueryParams {
+    query: string;
+    params?: unknown[];
+}
+interface DatabaseQueryResult {
+    rows: unknown[];
+    columns?: string[];
+    rowsAffected: number;
+    lastInsertId?: number;
+}
+interface DatabaseExecuteParams {
+    statements: string[];
+}
+interface MigrationResult {
+    appliedCount: number;
+    alreadyAppliedCount: number;
+    appliedMigrations: string[];
+}
+interface Migration {
+    name: string;
+    sql: string;
+}
+interface DatabaseTableInfo {
+    name: string;
+    columns: DatabaseColumnInfo[];
+}
+interface DatabaseColumnInfo {
+    name: string;
+    type: string;
+    notNull: boolean;
+    defaultValue?: unknown;
+    primaryKey: boolean;
+}
+interface HaexHubEvent {
+    type: string;
+    data: unknown;
+    timestamp: number;
+}
+interface ContextChangedEvent extends HaexHubEvent {
+    type: typeof HAEXTENSION_EVENTS.CONTEXT_CHANGED;
+    data: {
+        context: ApplicationContext;
+    };
+}
+interface SearchRequestEvent extends HaexHubEvent {
+    type: typeof HAEXTENSION_EVENTS.SEARCH_REQUEST;
+    data: {
+        query: SearchQuery;
+        requestId: string;
+    };
+}
+type EventCallback = (event: HaexHubEvent) => void;
+interface ExtensionManifest {
+    name: string;
+    version: string;
+    author?: string | null;
+    entry?: string | null;
+    icon?: string | null;
+    publicKey: string;
+    signature: string;
+    permissions: {
+        database?: any[];
+        filesystem?: any[];
+        http?: any[];
+        shell?: any[];
+    };
+    homepage?: string | null;
+    description?: string | null;
+    singleInstance?: boolean | null;
+    displayMode?: "auto" | "window" | "iframe" | null;
+    /**
+     * Path to the migrations directory relative to the extension root.
+     * Contains Drizzle-style migrations with meta/_journal.json and *.sql files.
+     * These migrations will be applied when the extension is installed.
+     * Example: "database/migrations"
+     */
+    migrationsDir?: string | null;
+}
+interface HaexHubConfig {
+    debug?: boolean;
+    timeout?: number;
+    /** Extension manifest data (auto-injected by framework integrations) */
+    manifest?: ExtensionManifest;
+}
+interface WebRequestOptions {
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+    headers?: Record<string, string>;
+    body?: string | ArrayBuffer | Blob;
+    timeout?: number;
+}
+interface WebResponse {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: ArrayBuffer;
+    url: string;
+}
+declare enum ErrorCode {
+    TIMEOUT = "TIMEOUT",
+    NOT_IN_IFRAME = "NOT_IN_IFRAME",
+    UNAUTHORIZED_ORIGIN = "UNAUTHORIZED_ORIGIN",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    INVALID_PUBLIC_KEY = "INVALID_PUBLIC_KEY",
+    INVALID_EXTENSION_NAME = "INVALID_EXTENSION_NAME",
+    INVALID_TABLE_NAME = "INVALID_TABLE_NAME",
+    INVALID_PARAMS = "INVALID_PARAMS",
+    EXTENSION_NOT_INITIALIZED = "EXTENSION_NOT_INITIALIZED",
+    EXTENSION_INFO_UNAVAILABLE = "EXTENSION_INFO_UNAVAILABLE",
+    METHOD_NOT_FOUND = "METHOD_NOT_FOUND",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    DATABASE_ERROR = "DATABASE_ERROR",
+    WEB_ERROR = "WEB_ERROR"
+}
+interface HaexHubError {
+    code: ErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+declare class HaexHubError extends Error {
+    code: ErrorCode;
+    messageKey: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, messageKey: string, details?: Record<string, unknown> | undefined);
+    /**
+     * Get localized error message
+     * @param locale - Locale code (e.g., 'en', 'de')
+     * @param translations - Translation object
+     */
+    getLocalizedMessage(locale?: string, translations?: Record<string, Record<string, string>>): string;
+    toJSON(): {
+        code: ErrorCode;
+        message: string;
+        details: Record<string, unknown> | undefined;
+    };
+}
+
+export { type ApplicationContext as A, type ContextChangedEvent as C, type DatabaseQueryResult as D, type ExtensionManifest as E, type HaexHubConfig as H, type Migration as M, type PermissionResponse as P, type SearchResult as S, TABLE_SEPARATOR as T, type WebRequestOptions as W, type ExtensionInfo as a, type MigrationResult as b, type WebResponse as c, type DatabasePermissionRequest as d, type EventCallback as e, type HaexHubRequest as f, type HaexHubResponse as g, type HaexHubEvent as h, type DatabasePermission as i, type DatabaseQueryParams as j, type DatabaseExecuteParams as k, type DatabaseTableInfo as l, type DatabaseColumnInfo as m, type SearchQuery as n, type SearchRequestEvent as o, PermissionStatus as p, ErrorCode as q, DEFAULT_TIMEOUT as r, getTableName as s, HaexHubError as t, HAEXTENSION_EVENTS as u, type HaextensionEvent as v };

package/dist/vue.d.mts

@@ -1,6 +1,7 @@
-import { H as HaexHubConfig, a as HaexVaultClient, S as StorageAPI } from './client-UgMJJ4NT.mjs';
+import { H as HaexVaultClient, S as StorageAPI } from './client-BIiJwbdW.mjs';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
+import { H as HaexHubConfig } from './types-FE9ewl3r.mjs';
 
 /**
  * Vue 3 composable for HaexHub SDK

package/dist/vue.d.ts

@@ -1,6 +1,7 @@
-import { H as HaexHubConfig, a as HaexVaultClient, S as StorageAPI } from './client-UgMJJ4NT.js';
+import { H as HaexVaultClient, S as StorageAPI } from './client-D4hDL-PR.js';
 import * as drizzle_orm_sqlite_proxy from 'drizzle-orm/sqlite-proxy';
 import { Ref } from 'vue';
+import { H as HaexHubConfig } from './types-FE9ewl3r.js';
 
 /**
  * Vue 3 composable for HaexHub SDK

package/dist/vue.js

@@ -366,6 +366,9 @@ var HAEXTENSION_METHODS = {
 // src/types.ts
 var DEFAULT_TIMEOUT = 3e4;
 var TABLE_SEPARATOR = "__";
+function getTableName(publicKey, extensionName, tableName) {
+  return `${publicKey}${TABLE_SEPARATOR}${extensionName}${TABLE_SEPARATOR}${tableName}`;
+}
 var HaexHubError = class extends Error {
   constructor(code, messageKey, details) {
     super(messageKey);
@@ -907,14 +910,13 @@ var HaexVaultClient = class {
     }
     this.validateTableName(tableName);
     const { publicKey, name } = this._extensionInfo;
-    const extensionName = name;
-    return `"${publicKey}${TABLE_SEPARATOR}${extensionName}${TABLE_SEPARATOR}${tableName}"`;
+    return `"${getTableName(publicKey, name, tableName)}"`;
   }
   getDependencyTableName(publicKey, extensionName, tableName) {
     this.validatePublicKey(publicKey);
     this.validateExtensionName(extensionName);
     this.validateTableName(tableName);
-    return `"${publicKey}${TABLE_SEPARATOR}${extensionName}${TABLE_SEPARATOR}${tableName}"`;
+    return `"${getTableName(publicKey, extensionName, tableName)}"`;
   }
   parseTableName(fullTableName) {
     let cleanTableName = fullTableName;