@haex-space/vault-sdk 2.3.15 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -14,6 +14,46 @@ var HAEXTENSION_EVENTS = {
14
14
  EXTERNAL_REQUEST: "haextension:external:request"
15
15
  };
16
16
 
17
+ // src/types.ts
18
+ var DEFAULT_TIMEOUT = 3e4;
19
+ var TABLE_SEPARATOR = "__";
20
+ function getTableName(publicKey, extensionName, tableName) {
21
+ return `${publicKey}${TABLE_SEPARATOR}${extensionName}${TABLE_SEPARATOR}${tableName}`;
22
+ }
23
+ var HaexVaultSdkError = class extends Error {
24
+ constructor(code, messageKey, details) {
25
+ super(messageKey);
26
+ this.code = code;
27
+ this.messageKey = messageKey;
28
+ this.details = details;
29
+ this.name = "HaexVaultSdkError";
30
+ }
31
+ /**
32
+ * Get localized error message
33
+ * @param locale - Locale code (e.g., 'en', 'de')
34
+ * @param translations - Translation object
35
+ */
36
+ getLocalizedMessage(locale = "en", translations) {
37
+ if (!translations || !translations[locale]) {
38
+ return this.messageKey;
39
+ }
40
+ let message = translations[locale][this.messageKey] || this.messageKey;
41
+ if (this.details) {
42
+ Object.entries(this.details).forEach(([key, value]) => {
43
+ message = message.replace(`{${key}}`, String(value));
44
+ });
45
+ }
46
+ return message;
47
+ }
48
+ toJSON() {
49
+ return {
50
+ code: this.code,
51
+ message: this.messageKey,
52
+ details: this.details
53
+ };
54
+ }
55
+ };
56
+
17
57
  // src/methods.ts
18
58
  var HAEXTENSION_METHODS = {
19
59
  context: {
@@ -75,54 +115,6 @@ var HAEXTENSION_METHODS = {
75
115
  }
76
116
  };
77
117
 
78
- // src/messages.ts
79
- var HAEXSPACE_MESSAGE_TYPES = {
80
- /** Debug message for development/troubleshooting */
81
- DEBUG: "haexspace:debug",
82
- /** Console forwarding from extension iframe */
83
- CONSOLE_FORWARD: "console.forward"
84
- };
85
-
86
- // src/types.ts
87
- var DEFAULT_TIMEOUT = 3e4;
88
- var TABLE_SEPARATOR = "__";
89
- function getTableName(publicKey, extensionName, tableName) {
90
- return `${publicKey}${TABLE_SEPARATOR}${extensionName}${TABLE_SEPARATOR}${tableName}`;
91
- }
92
- var HaexHubError = class extends Error {
93
- constructor(code, messageKey, details) {
94
- super(messageKey);
95
- this.code = code;
96
- this.messageKey = messageKey;
97
- this.details = details;
98
- this.name = "HaexHubError";
99
- }
100
- /**
101
- * Get localized error message
102
- * @param locale - Locale code (e.g., 'en', 'de')
103
- * @param translations - Translation object
104
- */
105
- getLocalizedMessage(locale = "en", translations) {
106
- if (!translations || !translations[locale]) {
107
- return this.messageKey;
108
- }
109
- let message = translations[locale][this.messageKey] || this.messageKey;
110
- if (this.details) {
111
- Object.entries(this.details).forEach(([key, value]) => {
112
- message = message.replace(`{${key}}`, String(value));
113
- });
114
- }
115
- return message;
116
- }
117
- toJSON() {
118
- return {
119
- code: this.code,
120
- message: this.messageKey,
121
- details: this.details
122
- };
123
- }
124
- };
125
-
126
118
  // src/api/storage.ts
127
119
  var StorageAPI = class {
128
120
  constructor(client) {
@@ -666,6 +658,14 @@ var PermissionsAPI = class {
666
658
  }
667
659
  };
668
660
 
661
+ // src/messages.ts
662
+ var HAEXSPACE_MESSAGE_TYPES = {
663
+ /** Debug message for development/troubleshooting */
664
+ DEBUG: "haexspace:debug",
665
+ /** Console forwarding from extension iframe */
666
+ CONSOLE_FORWARD: "console.forward"
667
+ };
668
+
669
669
  // src/polyfills/consoleForwarding.ts
670
670
  var originalConsole = {
671
671
  log: console.log,
@@ -731,548 +731,543 @@ function installConsoleForwarding(debug = false) {
731
731
  interceptConsole("debug");
732
732
  console.log("[HaexSpace] Console forwarding installed");
733
733
  }
734
- var HaexVaultClient = class {
735
- constructor(config = {}) {
736
- this.pendingRequests = /* @__PURE__ */ new Map();
737
- this.eventListeners = /* @__PURE__ */ new Map();
738
- this.externalRequestHandlers = /* @__PURE__ */ new Map();
739
- this.messageHandler = null;
740
- this.initialized = false;
741
- this.requestCounter = 0;
742
- this._extensionInfo = null;
743
- this._context = null;
744
- this.reactiveSubscribers = /* @__PURE__ */ new Set();
745
- this.isNativeWindow = false;
746
- // Wird im Konstruktor initialisiert
747
- this.setupPromise = null;
748
- this.setupHook = null;
749
- this._setupCompleted = false;
750
- this.orm = null;
751
- this.config = {
752
- debug: config.debug ?? false,
753
- timeout: config.timeout ?? DEFAULT_TIMEOUT,
754
- manifest: config.manifest
755
- };
756
- this.storage = new StorageAPI(this);
757
- this.database = new DatabaseAPI(this);
758
- this.filesystem = new FilesystemAPI(this);
759
- this.web = new WebAPI(this);
760
- this.permissions = new PermissionsAPI(this);
761
- installConsoleForwarding(this.config.debug);
762
- this.readyPromise = new Promise((resolve) => {
763
- this.resolveReady = resolve;
764
- });
765
- this.init();
734
+
735
+ // src/client/tableName.ts
736
+ function validatePublicKey(publicKey) {
737
+ if (!publicKey || typeof publicKey !== "string" || publicKey.trim() === "") {
738
+ throw new HaexVaultSdkError(
739
+ "INVALID_PUBLIC_KEY" /* INVALID_PUBLIC_KEY */,
740
+ "errors.invalid_public_key",
741
+ { publicKey }
742
+ );
766
743
  }
767
- /**
768
- * Gibt ein Promise zurück, das aufgelöst wird, sobald der Client
769
- * initialisiert ist und Extension-Infos empfangen hat.
770
- */
771
- async ready() {
772
- return this.readyPromise;
744
+ }
745
+ function validateExtensionName(extensionName) {
746
+ if (!extensionName || !/^[a-z][a-z0-9-]*$/i.test(extensionName)) {
747
+ throw new HaexVaultSdkError(
748
+ "INVALID_EXTENSION_NAME" /* INVALID_EXTENSION_NAME */,
749
+ "errors.invalid_extension_name",
750
+ { extensionName }
751
+ );
773
752
  }
774
- /**
775
- * Gibt zurück, ob das Setup bereits abgeschlossen wurde.
776
- */
777
- get setupCompleted() {
778
- return this._setupCompleted;
753
+ if (extensionName.includes(TABLE_SEPARATOR)) {
754
+ throw new HaexVaultSdkError(
755
+ "INVALID_EXTENSION_NAME" /* INVALID_EXTENSION_NAME */,
756
+ "errors.extension_name_contains_separator",
757
+ { extensionName, separator: TABLE_SEPARATOR }
758
+ );
779
759
  }
780
- /**
781
- * Registriert eine Setup-Funktion, die nach der Initialisierung ausgeführt wird.
782
- * Diese Funktion sollte für Aufgaben wie Tabellenerstellung, Migrationen, etc. verwendet werden.
783
- * @param setupFn Die Setup-Funktion, die ausgeführt werden soll
784
- */
785
- onSetup(setupFn) {
786
- if (this.setupHook) {
787
- throw new Error("Setup hook already registered");
788
- }
789
- this.setupHook = setupFn;
760
+ }
761
+ function validateTableName(tableName) {
762
+ if (!tableName || typeof tableName !== "string") {
763
+ throw new HaexVaultSdkError(
764
+ "INVALID_TABLE_NAME" /* INVALID_TABLE_NAME */,
765
+ "errors.table_name_empty"
766
+ );
790
767
  }
791
- /**
792
- * Gibt ein Promise zurück, das aufgelöst wird, sobald der Client vollständig eingerichtet ist.
793
- * Dies umfasst die Initialisierung UND das Setup (z.B. Tabellenerstellung).
794
- * Falls kein Setup-Hook registriert wurde, entspricht dies ready().
795
- */
796
- async setupComplete() {
797
- await this.readyPromise;
798
- if (!this.setupHook || this.setupCompleted) {
799
- return;
800
- }
801
- if (!this.setupPromise) {
802
- this.setupPromise = this.runSetupAsync();
803
- }
804
- return this.setupPromise;
768
+ if (tableName.includes(TABLE_SEPARATOR)) {
769
+ throw new HaexVaultSdkError(
770
+ "INVALID_TABLE_NAME" /* INVALID_TABLE_NAME */,
771
+ "errors.table_name_contains_separator",
772
+ { tableName, separator: TABLE_SEPARATOR }
773
+ );
805
774
  }
806
- async runSetupAsync() {
807
- if (!this.setupHook) return;
808
- try {
809
- this.log("[HaexSpace] Running setup hook...");
810
- await this.setupHook();
811
- this._setupCompleted = true;
812
- this.log("[HaexSpace] Setup completed successfully");
813
- this.notifySubscribers();
814
- } catch (error) {
815
- this.log("[HaexSpace] Setup failed:", error);
816
- throw error;
817
- }
775
+ if (!/^[a-z][a-z0-9-_]*$/i.test(tableName)) {
776
+ throw new HaexVaultSdkError(
777
+ "INVALID_TABLE_NAME" /* INVALID_TABLE_NAME */,
778
+ "errors.table_name_format",
779
+ { tableName }
780
+ );
818
781
  }
819
- /**
820
- * Initialisiert die Drizzle-Datenbankinstanz.
821
- * Muss nach der Definition des Schemas aufgerufen werden.
822
- * @param schema Das Drizzle-Schemaobjekt (mit bereits geprefixten Tabellennamen).
823
- * @returns Die typsichere Drizzle-Datenbankinstanz.
824
- */
825
- initializeDatabase(schema) {
826
- if (!this._extensionInfo) {
827
- throw new HaexHubError(
828
- "EXTENSION_INFO_UNAVAILABLE" /* EXTENSION_INFO_UNAVAILABLE */,
829
- "errors.client_not_ready"
830
- );
831
- }
832
- const dbInstance = drizzle(
833
- async (sql, params, method) => {
834
- try {
835
- if (method === "run" || method === "all") {
836
- const result2 = await this.request(
837
- HAEXTENSION_METHODS.database.execute,
838
- {
839
- query: sql,
840
- params
841
- }
842
- );
843
- if (method === "all") {
844
- return { rows: result2.rows || [] };
845
- }
846
- if (result2.rows && Array.isArray(result2.rows) && result2.rows.length > 0) {
847
- return { rows: result2.rows };
848
- }
849
- return result2;
850
- }
851
- const result = await this.request(HAEXTENSION_METHODS.database.query, {
852
- query: sql,
853
- params
854
- });
855
- const rows = result.rows;
856
- if (method === "get") {
857
- return { rows: rows.length > 0 ? rows.at(0) : void 0 };
858
- }
859
- return { rows };
860
- } catch (error) {
861
- this.log("Database operation failed:", error);
862
- throw error;
863
- }
864
- },
865
- {
866
- schema,
867
- logger: false
868
- }
782
+ }
783
+ function getExtensionTableName(extensionInfo, tableName) {
784
+ if (!extensionInfo) {
785
+ throw new HaexVaultSdkError(
786
+ "EXTENSION_INFO_UNAVAILABLE" /* EXTENSION_INFO_UNAVAILABLE */,
787
+ "errors.extension_info_unavailable"
869
788
  );
870
- this.orm = dbInstance;
871
- return dbInstance;
872
789
  }
873
- get extensionInfo() {
874
- return this._extensionInfo;
790
+ validateTableName(tableName);
791
+ const { publicKey, name } = extensionInfo;
792
+ return `"${getTableName(publicKey, name, tableName)}"`;
793
+ }
794
+ function getDependencyTableName(publicKey, extensionName, tableName) {
795
+ validatePublicKey(publicKey);
796
+ validateExtensionName(extensionName);
797
+ validateTableName(tableName);
798
+ return `"${getTableName(publicKey, extensionName, tableName)}"`;
799
+ }
800
+ function parseTableName(fullTableName) {
801
+ let cleanTableName = fullTableName;
802
+ if (cleanTableName.startsWith('"') && cleanTableName.endsWith('"')) {
803
+ cleanTableName = cleanTableName.slice(1, -1);
875
804
  }
876
- get context() {
877
- return this._context;
805
+ const parts = cleanTableName.split(TABLE_SEPARATOR);
806
+ if (parts.length !== 3) {
807
+ return null;
878
808
  }
879
- subscribe(callback) {
880
- this.reactiveSubscribers.add(callback);
881
- return () => {
882
- this.reactiveSubscribers.delete(callback);
883
- };
809
+ const [publicKey, extensionName, tableName] = parts;
810
+ if (!publicKey || !extensionName || !tableName) {
811
+ return null;
884
812
  }
885
- notifySubscribers() {
886
- this.reactiveSubscribers.forEach((callback) => callback());
813
+ return {
814
+ publicKey,
815
+ extensionName,
816
+ tableName
817
+ };
818
+ }
819
+
820
+ // src/client/init.ts
821
+ function isInIframe() {
822
+ return window.self !== window.top;
823
+ }
824
+ function hasTauri() {
825
+ return typeof window.__TAURI__ !== "undefined";
826
+ }
827
+ function getTauriCore() {
828
+ return window.__TAURI__.core;
829
+ }
830
+ function getTauriEvent() {
831
+ return window.__TAURI__.event;
832
+ }
833
+ async function initNativeMode(ctx, log, onEvent, onContextChange) {
834
+ const { invoke } = getTauriCore();
835
+ const extensionInfo = await invoke("webview_extension_get_info");
836
+ const context = await invoke("webview_extension_context_get");
837
+ ctx.state.isNativeWindow = true;
838
+ ctx.state.initialized = true;
839
+ ctx.state.extensionInfo = extensionInfo;
840
+ ctx.state.context = context;
841
+ log("HaexVault SDK initialized in native WebViewWindow mode");
842
+ log("Extension info:", extensionInfo);
843
+ log("Application context:", context);
844
+ await setupTauriEventListeners(ctx, log, onEvent, onContextChange);
845
+ return { extensionInfo, context };
846
+ }
847
+ async function setupTauriEventListeners(ctx, log, onEvent, onContextChange) {
848
+ const { listen } = getTauriEvent();
849
+ console.log("[HaexVault SDK] Setting up Tauri event listener for:", HAEXTENSION_EVENTS.CONTEXT_CHANGED);
850
+ try {
851
+ await listen(HAEXTENSION_EVENTS.CONTEXT_CHANGED, (event) => {
852
+ console.log("[HaexVault SDK] Received Tauri event:", HAEXTENSION_EVENTS.CONTEXT_CHANGED, event);
853
+ log("Received context change event:", event);
854
+ const payload = event.payload;
855
+ if (payload?.context) {
856
+ ctx.state.context = payload.context;
857
+ console.log("[HaexVault SDK] Updated context to:", ctx.state.context);
858
+ onContextChange(payload.context);
859
+ onEvent({
860
+ type: HAEXTENSION_EVENTS.CONTEXT_CHANGED,
861
+ data: { context: ctx.state.context },
862
+ timestamp: Date.now()
863
+ });
864
+ } else {
865
+ console.warn("[HaexVault SDK] Event received but no context in payload:", event);
866
+ }
867
+ });
868
+ console.log("[HaexVault SDK] Context change listener registered successfully");
869
+ } catch (error) {
870
+ console.error("[HaexVault SDK] Failed to setup context change listener:", error);
871
+ log("Failed to setup context change listener:", error);
872
+ }
873
+ try {
874
+ await listen(HAEXTENSION_EVENTS.EXTERNAL_REQUEST, (event) => {
875
+ log("Received external request event:", event);
876
+ if (event.payload) {
877
+ onEvent({
878
+ type: HAEXTENSION_EVENTS.EXTERNAL_REQUEST,
879
+ data: event.payload,
880
+ timestamp: Date.now()
881
+ });
882
+ }
883
+ });
884
+ console.log("[HaexVault SDK] External request listener registered successfully");
885
+ } catch (error) {
886
+ console.error("[HaexVault SDK] Failed to setup external request listener:", error);
887
+ log("Failed to setup external request listener:", error);
887
888
  }
888
- async getDependencies() {
889
- return this.request("extensions.getDependencies");
889
+ }
890
+ async function initIframeMode(ctx, log, messageHandler, request) {
891
+ if (!isInIframe()) {
892
+ throw new HaexVaultSdkError("NOT_IN_IFRAME" /* NOT_IN_IFRAME */, "errors.not_in_iframe");
893
+ }
894
+ ctx.handlers.messageHandler = messageHandler;
895
+ window.addEventListener("message", messageHandler);
896
+ ctx.state.isNativeWindow = false;
897
+ ctx.state.initialized = true;
898
+ log("HaexVault SDK initialized in iframe mode");
899
+ if (ctx.config.manifest) {
900
+ ctx.state.extensionInfo = {
901
+ publicKey: ctx.config.manifest.publicKey,
902
+ name: ctx.config.manifest.name,
903
+ version: ctx.config.manifest.version,
904
+ displayName: ctx.config.manifest.name
905
+ };
906
+ log("Extension info loaded from manifest:", ctx.state.extensionInfo);
890
907
  }
891
- getTableName(tableName) {
892
- if (!this._extensionInfo) {
893
- throw new HaexHubError(
894
- "EXTENSION_INFO_UNAVAILABLE" /* EXTENSION_INFO_UNAVAILABLE */,
895
- "errors.extension_info_unavailable"
896
- );
897
- }
898
- this.validateTableName(tableName);
899
- const { publicKey, name } = this._extensionInfo;
900
- return `"${getTableName(publicKey, name, tableName)}"`;
908
+ sendDebugInfo(ctx.config);
909
+ const context = await request(HAEXTENSION_METHODS.context.get);
910
+ ctx.state.context = context;
911
+ log("Application context received:", context);
912
+ return { context };
913
+ }
914
+ function sendDebugInfo(config) {
915
+ if (!config.debug) return;
916
+ if (typeof window === "undefined" || !window.parent) return;
917
+ const debugInfo = `SDK Debug:
918
+ window.parent exists: ${!!window.parent}
919
+ window.parent === window: ${window.parent === window}
920
+ window.self === window.top: ${window.self === window.top}`;
921
+ try {
922
+ window.parent.postMessage({
923
+ type: HAEXSPACE_MESSAGE_TYPES.DEBUG,
924
+ data: debugInfo
925
+ }, "*");
926
+ } catch (e) {
927
+ alert(debugInfo + `
928
+ postMessage error: ${e}`);
901
929
  }
902
- getDependencyTableName(publicKey, extensionName, tableName) {
903
- this.validatePublicKey(publicKey);
904
- this.validateExtensionName(extensionName);
905
- this.validateTableName(tableName);
906
- return `"${getTableName(publicKey, extensionName, tableName)}"`;
930
+ }
931
+
932
+ // src/commands.ts
933
+ var TAURI_COMMANDS = {
934
+ database: {
935
+ query: "webview_extension_db_query",
936
+ execute: "webview_extension_db_execute",
937
+ registerMigrations: "webview_extension_db_register_migrations"
938
+ },
939
+ permissions: {
940
+ checkWeb: "webview_extension_check_web_permission",
941
+ checkDatabase: "webview_extension_check_database_permission",
942
+ checkFilesystem: "webview_extension_check_filesystem_permission"
943
+ },
944
+ web: {
945
+ open: "webview_extension_web_open",
946
+ fetch: "webview_extension_web_request"
947
+ },
948
+ filesystem: {
949
+ saveFile: "webview_extension_fs_save_file",
950
+ openFile: "webview_extension_fs_open_file",
951
+ showImage: "webview_extension_fs_show_image"
952
+ },
953
+ external: {
954
+ respond: "webview_extension_external_respond"
955
+ },
956
+ filesync: {
957
+ // Spaces
958
+ listSpaces: "filesync_list_spaces",
959
+ createSpace: "filesync_create_space",
960
+ deleteSpace: "filesync_delete_space",
961
+ // Files
962
+ listFiles: "filesync_list_files",
963
+ getFile: "filesync_get_file",
964
+ uploadFile: "filesync_upload_file",
965
+ downloadFile: "filesync_download_file",
966
+ deleteFile: "filesync_delete_file",
967
+ // Backends
968
+ listBackends: "filesync_list_backends",
969
+ addBackend: "filesync_add_backend",
970
+ removeBackend: "filesync_remove_backend",
971
+ testBackend: "filesync_test_backend",
972
+ // Sync Rules
973
+ listSyncRules: "filesync_list_sync_rules",
974
+ addSyncRule: "filesync_add_sync_rule",
975
+ removeSyncRule: "filesync_remove_sync_rule",
976
+ // Sync Operations
977
+ getSyncStatus: "filesync_get_sync_status",
978
+ triggerSync: "filesync_trigger_sync",
979
+ pauseSync: "filesync_pause_sync",
980
+ resumeSync: "filesync_resume_sync",
981
+ // Conflict Resolution
982
+ resolveConflict: "filesync_resolve_conflict",
983
+ // UI Helpers
984
+ selectFolder: "filesync_select_folder"
907
985
  }
908
- parseTableName(fullTableName) {
909
- let cleanTableName = fullTableName;
910
- if (cleanTableName.startsWith('"') && cleanTableName.endsWith('"')) {
911
- cleanTableName = cleanTableName.slice(1, -1);
912
- }
913
- const parts = cleanTableName.split(TABLE_SEPARATOR);
914
- if (parts.length !== 3) {
915
- return null;
916
- }
917
- const [publicKey, extensionName, tableName] = parts;
918
- if (!publicKey || !extensionName || !tableName) {
919
- return null;
920
- }
921
- return {
922
- publicKey,
923
- extensionName,
924
- tableName
925
- };
986
+ };
987
+
988
+ // src/transport/handlers/database.ts
989
+ var databaseHandlers = {
990
+ [HAEXTENSION_METHODS.database.query]: {
991
+ command: TAURI_COMMANDS.database.query,
992
+ args: (p) => ({
993
+ query: p.query,
994
+ params: p.params || []
995
+ })
996
+ },
997
+ [HAEXTENSION_METHODS.database.execute]: {
998
+ command: TAURI_COMMANDS.database.execute,
999
+ args: (p) => ({
1000
+ query: p.query,
1001
+ params: p.params || []
1002
+ })
1003
+ },
1004
+ [HAEXTENSION_METHODS.database.registerMigrations]: {
1005
+ command: TAURI_COMMANDS.database.registerMigrations,
1006
+ args: (p) => ({
1007
+ extensionVersion: p.extensionVersion,
1008
+ migrations: p.migrations
1009
+ })
926
1010
  }
927
- /**
928
- * Execute a raw SQL query (SELECT)
929
- * Returns rows as an array of objects
930
- */
931
- async query(sql, params = []) {
932
- const result = await this.request(
933
- HAEXTENSION_METHODS.database.query,
934
- { query: sql, params }
935
- );
936
- if (this.config.debug) {
937
- console.log("[SDK query()] Raw result:", JSON.stringify(result, null, 2));
938
- }
939
- return result.rows;
1011
+ };
1012
+
1013
+ // src/transport/handlers/permissions.ts
1014
+ var permissionsHandlers = {
1015
+ "permissions.web.check": {
1016
+ command: TAURI_COMMANDS.permissions.checkWeb,
1017
+ args: (p) => ({
1018
+ url: p.url
1019
+ })
1020
+ },
1021
+ "permissions.database.check": {
1022
+ command: TAURI_COMMANDS.permissions.checkDatabase,
1023
+ args: (p) => ({
1024
+ resource: p.resource,
1025
+ operation: p.operation
1026
+ })
1027
+ },
1028
+ "permissions.filesystem.check": {
1029
+ command: TAURI_COMMANDS.permissions.checkFilesystem,
1030
+ args: (p) => ({
1031
+ path: p.path,
1032
+ actionStr: p.action
1033
+ })
940
1034
  }
941
- /**
942
- * Alias for query() - more intuitive for SELECT statements
943
- */
944
- async select(sql, params = []) {
945
- return this.query(sql, params);
946
- }
947
- /**
948
- * Execute a raw SQL statement (INSERT, UPDATE, DELETE, CREATE, etc.)
949
- * Returns rowsAffected and lastInsertId
950
- */
951
- async execute(sql, params = []) {
952
- const result = await this.request(
953
- HAEXTENSION_METHODS.database.execute,
954
- { query: sql, params }
955
- );
956
- return {
957
- rowsAffected: result.rowsAffected,
958
- lastInsertId: result.lastInsertId
959
- };
960
- }
961
- /**
962
- * Registers and applies extension migrations with HaexVault
963
- *
964
- * HaexVault will:
965
- * 1. Validate all SQL statements (ensure only extension's own tables are accessed)
966
- * 2. Store migrations with applied_at = NULL
967
- * 3. Query pending migrations sorted by name
968
- * 4. Apply pending migrations and set up CRDT triggers
969
- * 5. Mark successful migrations with applied_at timestamp
970
- *
971
- * @param extensionVersion - The version of the extension
972
- * @param migrations - Array of migration objects with name and SQL content
973
- * @returns Promise with migration result (applied count, already applied count, applied migration names)
974
- */
975
- async registerMigrationsAsync(extensionVersion, migrations) {
976
- return this.database.registerMigrationsAsync(extensionVersion, migrations);
977
- }
978
- async requestDatabasePermission(request) {
979
- return this.request("permissions.database.request", {
980
- resource: request.resource,
981
- operation: request.operation,
982
- reason: request.reason
983
- });
984
- }
985
- async checkDatabasePermission(resource, operation) {
986
- const response = await this.request(
987
- "permissions.database.check",
988
- {
989
- resource,
990
- operation
991
- }
992
- );
993
- return response.status === "granted";
994
- }
995
- async respondToSearch(requestId, results) {
996
- await this.request("search.respond", {
997
- requestId,
998
- results
999
- });
1000
- }
1001
- /**
1002
- * Register a handler for external requests (from browser extensions, CLI, servers, etc.)
1003
- *
1004
- * @param action - The action/method name to handle (e.g., "get-logins", "get-totp")
1005
- * @param handler - Function that processes the request and returns a response
1006
- * @returns Unsubscribe function to remove the handler
1007
- *
1008
- * @example
1009
- * ```typescript
1010
- * client.onExternalRequest("get-logins", async (request) => {
1011
- * const entries = await getMatchingEntries(request.payload.url);
1012
- * return {
1013
- * requestId: request.requestId,
1014
- * success: true,
1015
- * data: { entries }
1016
- * };
1017
- * });
1018
- * ```
1019
- */
1020
- onExternalRequest(action, handler) {
1021
- this.externalRequestHandlers.set(action, handler);
1022
- this.log(`[ExternalRequest] Registered handler for action: ${action}`);
1023
- return () => {
1024
- this.externalRequestHandlers.delete(action);
1025
- this.log(`[ExternalRequest] Unregistered handler for action: ${action}`);
1026
- };
1027
- }
1028
- /**
1029
- * Send a response to an external request back to haex-vault
1030
- * This is called internally after a handler processes a request
1031
- */
1032
- async respondToExternalRequest(response) {
1033
- await this.request("external.respond", response);
1034
- }
1035
- async request(method, params) {
1036
- const resolvedParams = params ?? {};
1037
- if (this.isNativeWindow && typeof window.__TAURI__ !== "undefined") {
1038
- return this.invoke(method, resolvedParams);
1039
- }
1040
- return this.postMessage(method, resolvedParams);
1041
- }
1042
- async postMessage(method, params) {
1043
- const requestId = this.generateRequestId();
1044
- const request = {
1045
- method,
1046
- params,
1047
- timestamp: Date.now()
1048
- };
1049
- return new Promise((resolve, reject) => {
1050
- const timeout = setTimeout(() => {
1051
- this.pendingRequests.delete(requestId);
1052
- reject(
1053
- new HaexHubError("TIMEOUT" /* TIMEOUT */, "errors.timeout", {
1054
- timeout: this.config.timeout
1055
- })
1056
- );
1057
- }, this.config.timeout);
1058
- this.pendingRequests.set(requestId, { resolve, reject, timeout });
1059
- const targetOrigin = "*";
1060
- if (this.config.debug) {
1061
- console.log("[SDK Debug] ========== Sending Request ==========");
1062
- console.log("[SDK Debug] Request ID:", requestId);
1063
- console.log("[SDK Debug] Method:", request.method);
1064
- console.log("[SDK Debug] Params:", request.params);
1065
- console.log("[SDK Debug] Target origin:", targetOrigin);
1066
- console.log("[SDK Debug] Extension info:", this._extensionInfo);
1067
- console.log("[SDK Debug] ========================================");
1068
- }
1069
- window.parent.postMessage({ id: requestId, ...request }, targetOrigin);
1070
- });
1071
- }
1072
- async invoke(method, params) {
1073
- const { invoke } = window.__TAURI__.core;
1074
- if (this.config.debug) {
1075
- console.log("[SDK Debug] ========== Invoke Request ==========");
1076
- console.log("[SDK Debug] Method:", method);
1077
- console.log("[SDK Debug] Params:", params);
1078
- console.log("[SDK Debug] =======================================");
1079
- }
1080
- switch (method) {
1081
- case HAEXTENSION_METHODS.database.query:
1082
- return invoke("webview_extension_db_query", {
1083
- query: params.query,
1084
- params: params.params || []
1085
- });
1086
- case HAEXTENSION_METHODS.database.execute:
1087
- return invoke("webview_extension_db_execute", {
1088
- query: params.query,
1089
- params: params.params || []
1090
- });
1091
- case "permissions.web.check":
1092
- return invoke("webview_extension_check_web_permission", {
1093
- url: params.url
1094
- });
1095
- case "permissions.database.check":
1096
- return invoke("webview_extension_check_database_permission", {
1097
- resource: params.resource,
1098
- operation: params.operation
1099
- });
1100
- case "permissions.filesystem.check":
1101
- return invoke("webview_extension_check_filesystem_permission", {
1102
- path: params.path,
1103
- actionStr: params.action
1104
- });
1105
- case HAEXTENSION_METHODS.application.open:
1106
- return invoke("webview_extension_web_open", {
1107
- url: params.url
1108
- });
1109
- case HAEXTENSION_METHODS.web.fetch:
1110
- return invoke("webview_extension_web_request", {
1111
- url: params.url,
1112
- method: params.method,
1113
- headers: params.headers,
1114
- body: params.body
1115
- });
1116
- case HAEXTENSION_METHODS.filesystem.saveFile:
1117
- return invoke("webview_extension_fs_save_file", {
1118
- data: params.data,
1119
- defaultPath: params.defaultPath,
1120
- title: params.title,
1121
- filters: params.filters
1122
- });
1123
- case HAEXTENSION_METHODS.filesystem.openFile:
1124
- return invoke("webview_extension_fs_open_file", {
1125
- data: params.data,
1126
- fileName: params.fileName
1127
- });
1128
- case HAEXTENSION_METHODS.database.registerMigrations:
1129
- return invoke("webview_extension_db_register_migrations", {
1130
- extensionVersion: params.extensionVersion,
1131
- migrations: params.migrations
1132
- });
1133
- case "external.respond":
1134
- return invoke("webview_extension_external_respond", {
1135
- requestId: params.requestId,
1136
- success: params.success,
1137
- data: params.data,
1138
- error: params.error
1139
- });
1140
- default:
1141
- throw new HaexHubError(
1142
- "METHOD_NOT_FOUND" /* METHOD_NOT_FOUND */,
1143
- "errors.method_not_found",
1144
- { method }
1145
- );
1146
- }
1035
+ };
1036
+
1037
+ // src/transport/handlers/web.ts
1038
+ var webHandlers = {
1039
+ [HAEXTENSION_METHODS.application.open]: {
1040
+ command: TAURI_COMMANDS.web.open,
1041
+ args: (p) => ({
1042
+ url: p.url
1043
+ })
1044
+ },
1045
+ [HAEXTENSION_METHODS.web.fetch]: {
1046
+ command: TAURI_COMMANDS.web.fetch,
1047
+ args: (p) => ({
1048
+ url: p.url,
1049
+ method: p.method,
1050
+ headers: p.headers,
1051
+ body: p.body
1052
+ })
1147
1053
  }
1148
- on(eventType, callback) {
1149
- if (!this.eventListeners.has(eventType)) {
1150
- this.eventListeners.set(eventType, /* @__PURE__ */ new Set());
1151
- }
1152
- this.eventListeners.get(eventType).add(callback);
1054
+ };
1055
+
1056
+ // src/transport/handlers/filesystem.ts
1057
+ var filesystemHandlers = {
1058
+ [HAEXTENSION_METHODS.filesystem.saveFile]: {
1059
+ command: TAURI_COMMANDS.filesystem.saveFile,
1060
+ args: (p) => ({
1061
+ data: p.data,
1062
+ defaultPath: p.defaultPath,
1063
+ title: p.title,
1064
+ filters: p.filters
1065
+ })
1066
+ },
1067
+ [HAEXTENSION_METHODS.filesystem.openFile]: {
1068
+ command: TAURI_COMMANDS.filesystem.openFile,
1069
+ args: (p) => ({
1070
+ data: p.data,
1071
+ fileName: p.fileName
1072
+ })
1073
+ },
1074
+ [HAEXTENSION_METHODS.filesystem.showImage]: {
1075
+ command: TAURI_COMMANDS.filesystem.showImage,
1076
+ args: (p) => ({
1077
+ dataUrl: p.dataUrl
1078
+ })
1153
1079
  }
1154
- off(eventType, callback) {
1155
- const listeners = this.eventListeners.get(eventType);
1156
- if (listeners) {
1157
- listeners.delete(callback);
1158
- }
1080
+ };
1081
+
1082
+ // src/transport/handlers/external.ts
1083
+ var externalHandlers = {
1084
+ "external.respond": {
1085
+ command: TAURI_COMMANDS.external.respond,
1086
+ args: (p) => ({
1087
+ requestId: p.requestId,
1088
+ success: p.success,
1089
+ data: p.data,
1090
+ error: p.error
1091
+ })
1159
1092
  }
1160
- destroy() {
1161
- if (this.messageHandler) {
1162
- window.removeEventListener("message", this.messageHandler);
1163
- }
1164
- this.pendingRequests.forEach(({ timeout }) => clearTimeout(timeout));
1165
- this.pendingRequests.clear();
1166
- this.eventListeners.clear();
1167
- this.initialized = false;
1168
- this.log("HaexHub SDK destroyed");
1093
+ };
1094
+
1095
+ // src/transport/handlers/filesync.ts
1096
+ var filesyncHandlers = {
1097
+ // ==========================================================================
1098
+ // Spaces
1099
+ // ==========================================================================
1100
+ [HAEXTENSION_METHODS.filesystem.sync.listSpaces]: {
1101
+ command: TAURI_COMMANDS.filesync.listSpaces,
1102
+ args: () => ({})
1103
+ },
1104
+ [HAEXTENSION_METHODS.filesystem.sync.createSpace]: {
1105
+ command: TAURI_COMMANDS.filesync.createSpace,
1106
+ args: (p) => ({ request: p })
1107
+ },
1108
+ [HAEXTENSION_METHODS.filesystem.sync.deleteSpace]: {
1109
+ command: TAURI_COMMANDS.filesync.deleteSpace,
1110
+ args: (p) => ({ spaceId: p.spaceId })
1111
+ },
1112
+ // ==========================================================================
1113
+ // Files
1114
+ // ==========================================================================
1115
+ [HAEXTENSION_METHODS.filesystem.sync.listFiles]: {
1116
+ command: TAURI_COMMANDS.filesync.listFiles,
1117
+ args: (p) => ({ request: p })
1118
+ },
1119
+ [HAEXTENSION_METHODS.filesystem.sync.getFile]: {
1120
+ command: TAURI_COMMANDS.filesync.getFile,
1121
+ args: (p) => ({ fileId: p.fileId })
1122
+ },
1123
+ [HAEXTENSION_METHODS.filesystem.sync.uploadFile]: {
1124
+ command: TAURI_COMMANDS.filesync.uploadFile,
1125
+ args: (p) => ({ request: p })
1126
+ },
1127
+ [HAEXTENSION_METHODS.filesystem.sync.downloadFile]: {
1128
+ command: TAURI_COMMANDS.filesync.downloadFile,
1129
+ args: (p) => ({ request: p })
1130
+ },
1131
+ [HAEXTENSION_METHODS.filesystem.sync.deleteFile]: {
1132
+ command: TAURI_COMMANDS.filesync.deleteFile,
1133
+ args: (p) => ({ fileId: p.fileId })
1134
+ },
1135
+ // ==========================================================================
1136
+ // Backends
1137
+ // ==========================================================================
1138
+ [HAEXTENSION_METHODS.filesystem.sync.listBackends]: {
1139
+ command: TAURI_COMMANDS.filesync.listBackends,
1140
+ args: () => ({})
1141
+ },
1142
+ [HAEXTENSION_METHODS.filesystem.sync.addBackend]: {
1143
+ command: TAURI_COMMANDS.filesync.addBackend,
1144
+ args: (p) => ({ request: p })
1145
+ },
1146
+ [HAEXTENSION_METHODS.filesystem.sync.removeBackend]: {
1147
+ command: TAURI_COMMANDS.filesync.removeBackend,
1148
+ args: (p) => ({ backendId: p.backendId })
1149
+ },
1150
+ [HAEXTENSION_METHODS.filesystem.sync.testBackend]: {
1151
+ command: TAURI_COMMANDS.filesync.testBackend,
1152
+ args: (p) => ({ backendId: p.backendId })
1153
+ },
1154
+ // ==========================================================================
1155
+ // Sync Rules
1156
+ // ==========================================================================
1157
+ [HAEXTENSION_METHODS.filesystem.sync.listSyncRules]: {
1158
+ command: TAURI_COMMANDS.filesync.listSyncRules,
1159
+ args: () => ({})
1160
+ },
1161
+ [HAEXTENSION_METHODS.filesystem.sync.addSyncRule]: {
1162
+ command: TAURI_COMMANDS.filesync.addSyncRule,
1163
+ args: (p) => ({ request: p })
1164
+ },
1165
+ [HAEXTENSION_METHODS.filesystem.sync.removeSyncRule]: {
1166
+ command: TAURI_COMMANDS.filesync.removeSyncRule,
1167
+ args: (p) => ({ ruleId: p.ruleId })
1168
+ },
1169
+ // ==========================================================================
1170
+ // Sync Operations
1171
+ // ==========================================================================
1172
+ [HAEXTENSION_METHODS.filesystem.sync.getSyncStatus]: {
1173
+ command: TAURI_COMMANDS.filesync.getSyncStatus,
1174
+ args: () => ({})
1175
+ },
1176
+ [HAEXTENSION_METHODS.filesystem.sync.triggerSync]: {
1177
+ command: TAURI_COMMANDS.filesync.triggerSync,
1178
+ args: () => ({})
1179
+ },
1180
+ [HAEXTENSION_METHODS.filesystem.sync.pauseSync]: {
1181
+ command: TAURI_COMMANDS.filesync.pauseSync,
1182
+ args: () => ({})
1183
+ },
1184
+ [HAEXTENSION_METHODS.filesystem.sync.resumeSync]: {
1185
+ command: TAURI_COMMANDS.filesync.resumeSync,
1186
+ args: () => ({})
1187
+ },
1188
+ // ==========================================================================
1189
+ // Conflict Resolution
1190
+ // ==========================================================================
1191
+ [HAEXTENSION_METHODS.filesystem.sync.resolveConflict]: {
1192
+ command: TAURI_COMMANDS.filesync.resolveConflict,
1193
+ args: (p) => ({ request: p })
1194
+ },
1195
+ // ==========================================================================
1196
+ // UI Helpers
1197
+ // ==========================================================================
1198
+ [HAEXTENSION_METHODS.filesystem.sync.selectFolder]: {
1199
+ command: TAURI_COMMANDS.filesync.selectFolder,
1200
+ args: () => ({})
1169
1201
  }
1170
- async init() {
1171
- if (this.initialized) return;
1172
- const isInIframe = window.self !== window.top;
1173
- if (!isInIframe) {
1174
- try {
1175
- if (typeof window.__TAURI__ !== "undefined") {
1176
- const { invoke } = window.__TAURI__.core;
1177
- this._extensionInfo = await invoke("webview_extension_get_info");
1178
- this._context = await invoke("webview_extension_context_get");
1179
- this.isNativeWindow = true;
1180
- this.initialized = true;
1181
- this.log("HaexHub SDK initialized in native WebViewWindow mode");
1182
- this.log("Extension info:", this._extensionInfo);
1183
- this.log("Application context:", this._context);
1184
- this.notifySubscribers();
1185
- const { listen } = window.__TAURI__.event;
1186
- console.log("[HaexSpace SDK] Setting up Tauri event listener for:", HAEXTENSION_EVENTS.CONTEXT_CHANGED);
1187
- try {
1188
- await listen(HAEXTENSION_EVENTS.CONTEXT_CHANGED, (event) => {
1189
- console.log("[HaexSpace SDK] Received Tauri event:", HAEXTENSION_EVENTS.CONTEXT_CHANGED, event);
1190
- this.log("Received context change event:", event);
1191
- if (event.payload?.context) {
1192
- this._context = event.payload.context;
1193
- console.log("[HaexSpace SDK] Updated context to:", this._context);
1194
- this.handleEvent({
1195
- type: HAEXTENSION_EVENTS.CONTEXT_CHANGED,
1196
- data: { context: this._context },
1197
- timestamp: Date.now()
1198
- });
1199
- } else {
1200
- console.warn("[HaexSpace SDK] Event received but no context in payload:", event);
1201
- }
1202
- });
1203
- console.log("[HaexSpace SDK] Context change listener registered successfully");
1204
- } catch (error) {
1205
- console.error("[HaexSpace SDK] Failed to setup context change listener:", error);
1206
- this.log("Failed to setup context change listener:", error);
1207
- }
1208
- try {
1209
- await listen(HAEXTENSION_EVENTS.EXTERNAL_REQUEST, (event) => {
1210
- this.log("Received external request event:", event);
1211
- if (event.payload) {
1212
- this.handleEvent({
1213
- type: HAEXTENSION_EVENTS.EXTERNAL_REQUEST,
1214
- data: event.payload,
1215
- timestamp: Date.now()
1216
- });
1217
- }
1218
- });
1219
- console.log("[HaexSpace SDK] External request listener registered successfully");
1220
- } catch (error) {
1221
- console.error("[HaexSpace SDK] Failed to setup external request listener:", error);
1222
- this.log("Failed to setup external request listener:", error);
1223
- }
1224
- this.resolveReady();
1225
- return;
1226
- }
1227
- } catch (error) {
1228
- this.log("Tauri commands failed, falling back to iframe mode", error);
1229
- }
1230
- }
1231
- if (window.self === window.top) {
1232
- throw new HaexHubError("NOT_IN_IFRAME" /* NOT_IN_IFRAME */, "errors.not_in_iframe");
1233
- }
1234
- this.messageHandler = this.handleMessage.bind(this);
1235
- window.addEventListener("message", this.messageHandler);
1236
- this.isNativeWindow = false;
1237
- this.initialized = true;
1238
- this.log("HaexSpace SDK initialized in iframe mode");
1239
- try {
1240
- if (this.config.manifest) {
1241
- this._extensionInfo = {
1242
- publicKey: this.config.manifest.publicKey,
1243
- name: this.config.manifest.name,
1244
- version: this.config.manifest.version,
1245
- displayName: this.config.manifest.name
1246
- };
1247
- this.log("Extension info loaded from manifest:", this._extensionInfo);
1248
- this.notifySubscribers();
1249
- }
1250
- if (typeof window !== "undefined" && window.parent) {
1251
- const debugInfo = `SDK Debug:
1252
- window.parent exists: ${!!window.parent}
1253
- window.parent === window: ${window.parent === window}
1254
- window.self === window.top: ${window.self === window.top}`;
1255
- try {
1256
- window.parent.postMessage({
1257
- type: HAEXSPACE_MESSAGE_TYPES.DEBUG,
1258
- data: debugInfo
1259
- }, "*");
1260
- } catch (e) {
1261
- alert(debugInfo + `
1262
- postMessage error: ${e}`);
1263
- }
1264
- }
1265
- this._context = await this.request(HAEXTENSION_METHODS.context.get);
1266
- this.log("Application context received:", this._context);
1267
- this.notifySubscribers();
1268
- this.resolveReady();
1269
- } catch (error) {
1270
- this.log("Failed to load extension info or context:", error);
1271
- throw error;
1202
+ };
1203
+
1204
+ // src/transport/handlers/index.ts
1205
+ var allHandlers = {
1206
+ ...databaseHandlers,
1207
+ ...permissionsHandlers,
1208
+ ...webHandlers,
1209
+ ...filesystemHandlers,
1210
+ ...externalHandlers,
1211
+ ...filesyncHandlers
1212
+ };
1213
+
1214
+ // src/client/transport.ts
1215
+ function generateRequestId(counter) {
1216
+ return `req_${counter}`;
1217
+ }
1218
+ function sendPostMessage(method, params, requestId, config, extensionInfo, pendingRequests) {
1219
+ const request = {
1220
+ method,
1221
+ params,
1222
+ timestamp: Date.now()
1223
+ };
1224
+ return new Promise((resolve, reject) => {
1225
+ const timeout = setTimeout(() => {
1226
+ pendingRequests.delete(requestId);
1227
+ reject(
1228
+ new HaexVaultSdkError("TIMEOUT" /* TIMEOUT */, "errors.timeout", {
1229
+ timeout: config.timeout
1230
+ })
1231
+ );
1232
+ }, config.timeout);
1233
+ pendingRequests.set(requestId, { resolve, reject, timeout });
1234
+ const targetOrigin = "*";
1235
+ if (config.debug) {
1236
+ console.log("[SDK Debug] ========== Sending Request ==========");
1237
+ console.log("[SDK Debug] Request ID:", requestId);
1238
+ console.log("[SDK Debug] Method:", request.method);
1239
+ console.log("[SDK Debug] Params:", request.params);
1240
+ console.log("[SDK Debug] Target origin:", targetOrigin);
1241
+ console.log("[SDK Debug] Extension info:", extensionInfo);
1242
+ console.log("[SDK Debug] ========================================");
1272
1243
  }
1273
- }
1274
- handleMessage(event) {
1275
- if (this.config.debug) {
1244
+ window.parent.postMessage({ id: requestId, ...request }, targetOrigin);
1245
+ });
1246
+ }
1247
+ async function sendInvoke(method, params, config, log) {
1248
+ const { invoke } = window.__TAURI__.core;
1249
+ if (config.debug) {
1250
+ console.log("[SDK Debug] ========== Invoke Request ==========");
1251
+ console.log("[SDK Debug] Method:", method);
1252
+ console.log("[SDK Debug] Params:", params);
1253
+ console.log("[SDK Debug] =======================================");
1254
+ }
1255
+ const handler = allHandlers[method];
1256
+ if (handler) {
1257
+ const args = handler.args(params);
1258
+ return invoke(handler.command, args);
1259
+ }
1260
+ throw new HaexVaultSdkError(
1261
+ "METHOD_NOT_FOUND" /* METHOD_NOT_FOUND */,
1262
+ "errors.method_not_found",
1263
+ { method }
1264
+ );
1265
+ }
1266
+
1267
+ // src/client/events.ts
1268
+ function createMessageHandler(config, pendingRequests, extensionInfo, onEvent) {
1269
+ return (event) => {
1270
+ if (config.debug) {
1276
1271
  console.log("[SDK Debug] ========== Message Received ==========");
1277
1272
  console.log("[SDK Debug] Event origin:", event.origin);
1278
1273
  console.log(
@@ -1280,160 +1275,534 @@ postMessage error: ${e}`);
1280
1275
  event.source === window.parent ? "parent window" : "unknown"
1281
1276
  );
1282
1277
  console.log("[SDK Debug] Event data:", event.data);
1283
- console.log("[SDK Debug] Extension info loaded:", !!this._extensionInfo);
1278
+ console.log("[SDK Debug] Extension info loaded:", !!extensionInfo());
1284
1279
  console.log(
1285
1280
  "[SDK Debug] Pending requests count:",
1286
- this.pendingRequests.size
1281
+ pendingRequests.size
1287
1282
  );
1288
1283
  }
1289
1284
  if (event.source !== window.parent) {
1290
- if (this.config.debug) {
1285
+ if (config.debug) {
1291
1286
  console.error("[SDK Debug] \u274C REJECTED: Message not from parent window!");
1292
1287
  }
1293
1288
  return;
1294
1289
  }
1295
1290
  const data = event.data;
1296
- if ("id" in data && this.pendingRequests.has(data.id)) {
1297
- if (this.config.debug) {
1291
+ if ("id" in data && pendingRequests.has(data.id)) {
1292
+ if (config.debug) {
1298
1293
  console.log("[SDK Debug] \u2705 Found pending request for ID:", data.id);
1299
1294
  }
1300
- const pending = this.pendingRequests.get(data.id);
1295
+ const pending = pendingRequests.get(data.id);
1301
1296
  clearTimeout(pending.timeout);
1302
- this.pendingRequests.delete(data.id);
1297
+ pendingRequests.delete(data.id);
1303
1298
  if (data.error) {
1304
- if (this.config.debug) {
1299
+ if (config.debug) {
1305
1300
  console.error("[SDK Debug] \u274C Request failed:", data.error);
1306
1301
  }
1307
1302
  pending.reject(data.error);
1308
1303
  } else {
1309
- if (this.config.debug) {
1304
+ if (config.debug) {
1310
1305
  console.log("[SDK Debug] \u2705 Request succeeded:", data.result);
1311
1306
  }
1312
1307
  pending.resolve(data.result);
1313
1308
  }
1314
1309
  return;
1315
1310
  }
1316
- if ("id" in data && !this.pendingRequests.has(data.id)) {
1317
- if (this.config.debug) {
1311
+ if ("id" in data && !pendingRequests.has(data.id)) {
1312
+ if (config.debug) {
1318
1313
  console.warn(
1319
1314
  "[SDK Debug] \u26A0\uFE0F Received response for unknown request ID:",
1320
1315
  data.id
1321
1316
  );
1322
1317
  console.warn(
1323
1318
  "[SDK Debug] Known IDs:",
1324
- Array.from(this.pendingRequests.keys())
1319
+ Array.from(pendingRequests.keys())
1325
1320
  );
1326
1321
  }
1327
1322
  }
1328
1323
  if ("type" in data && data.type) {
1329
- if (this.config.debug) {
1324
+ if (config.debug) {
1330
1325
  console.log("[SDK Debug] Event received:", data.type);
1331
1326
  }
1332
- this.handleEvent(data);
1327
+ onEvent(data);
1333
1328
  }
1334
- if (this.config.debug) {
1329
+ if (config.debug) {
1335
1330
  console.log("[SDK Debug] ========== End Message ==========");
1336
1331
  }
1332
+ };
1333
+ }
1334
+ function processEvent(event, log, eventListeners, onContextChanged, onExternalRequest) {
1335
+ if (event.type === HAEXTENSION_EVENTS.CONTEXT_CHANGED) {
1336
+ const contextEvent = event;
1337
+ onContextChanged(contextEvent.data.context);
1338
+ log("Context updated:", contextEvent.data.context);
1339
+ }
1340
+ if (event.type === HAEXTENSION_EVENTS.EXTERNAL_REQUEST) {
1341
+ const externalEvent = event;
1342
+ onExternalRequest(externalEvent);
1343
+ return;
1337
1344
  }
1338
- handleEvent(event) {
1339
- if (event.type === HAEXTENSION_EVENTS.CONTEXT_CHANGED) {
1340
- const contextEvent = event;
1341
- this._context = contextEvent.data.context;
1342
- this.log("Context updated:", this._context);
1343
- this.notifySubscribers();
1345
+ emitEvent(event, log, eventListeners);
1346
+ }
1347
+ function emitEvent(event, log, eventListeners) {
1348
+ log("Event received:", event);
1349
+ const listeners = eventListeners.get(event.type);
1350
+ if (listeners) {
1351
+ listeners.forEach((callback) => callback(event));
1352
+ }
1353
+ }
1354
+ function addEventListener(eventType, callback, eventListeners) {
1355
+ if (!eventListeners.has(eventType)) {
1356
+ eventListeners.set(eventType, /* @__PURE__ */ new Set());
1357
+ }
1358
+ eventListeners.get(eventType).add(callback);
1359
+ }
1360
+ function removeEventListener(eventType, callback, eventListeners) {
1361
+ const listeners = eventListeners.get(eventType);
1362
+ if (listeners) {
1363
+ listeners.delete(callback);
1364
+ }
1365
+ }
1366
+ function notifySubscribers(subscribers) {
1367
+ subscribers.forEach((callback) => callback());
1368
+ }
1369
+ function createDrizzleInstance(schema, extensionInfo, request, log) {
1370
+ if (!extensionInfo) {
1371
+ throw new HaexVaultSdkError(
1372
+ "EXTENSION_INFO_UNAVAILABLE" /* EXTENSION_INFO_UNAVAILABLE */,
1373
+ "errors.client_not_ready"
1374
+ );
1375
+ }
1376
+ return drizzle(
1377
+ async (sql, params, method) => {
1378
+ try {
1379
+ if (method === "run" || method === "all") {
1380
+ const result2 = await request(
1381
+ HAEXTENSION_METHODS.database.execute,
1382
+ {
1383
+ query: sql,
1384
+ params
1385
+ }
1386
+ );
1387
+ if (method === "all") {
1388
+ return { rows: result2.rows || [] };
1389
+ }
1390
+ if (result2.rows && Array.isArray(result2.rows) && result2.rows.length > 0) {
1391
+ return { rows: result2.rows };
1392
+ }
1393
+ return result2;
1394
+ }
1395
+ const result = await request(HAEXTENSION_METHODS.database.query, {
1396
+ query: sql,
1397
+ params
1398
+ });
1399
+ const rows = result.rows;
1400
+ if (method === "get") {
1401
+ return { rows: rows.length > 0 ? rows.at(0) : void 0 };
1402
+ }
1403
+ return { rows };
1404
+ } catch (error) {
1405
+ log("Database operation failed:", error);
1406
+ throw error;
1407
+ }
1408
+ },
1409
+ {
1410
+ schema,
1411
+ logger: false
1344
1412
  }
1345
- if (event.type === HAEXTENSION_EVENTS.EXTERNAL_REQUEST) {
1346
- const externalEvent = event;
1347
- this.handleExternalRequest(externalEvent.data);
1348
- return;
1413
+ );
1414
+ }
1415
+ async function queryRaw(sql, params, request, debug) {
1416
+ const result = await request(
1417
+ HAEXTENSION_METHODS.database.query,
1418
+ { query: sql, params }
1419
+ );
1420
+ if (debug) {
1421
+ console.log("[SDK query()] Raw result:", JSON.stringify(result, null, 2));
1422
+ }
1423
+ return result.rows;
1424
+ }
1425
+ async function executeRaw(sql, params, request) {
1426
+ const result = await request(
1427
+ HAEXTENSION_METHODS.database.execute,
1428
+ { query: sql, params }
1429
+ );
1430
+ return {
1431
+ rowsAffected: result.rowsAffected,
1432
+ lastInsertId: result.lastInsertId
1433
+ };
1434
+ }
1435
+
1436
+ // src/client/external.ts
1437
+ function registerExternalHandler(action, handler, handlers, log) {
1438
+ handlers.set(action, handler);
1439
+ log(`[ExternalRequest] Registered handler for action: ${action}`);
1440
+ return () => {
1441
+ handlers.delete(action);
1442
+ log(`[ExternalRequest] Unregistered handler for action: ${action}`);
1443
+ };
1444
+ }
1445
+ async function handleExternalRequest(request, handlers, respond, log) {
1446
+ log(`[ExternalRequest] Received request: ${request.action} from ${request.publicKey.substring(0, 20)}...`);
1447
+ const handler = handlers.get(request.action);
1448
+ if (!handler) {
1449
+ log(`[ExternalRequest] No handler for action: ${request.action}`);
1450
+ await respond({
1451
+ requestId: request.requestId,
1452
+ success: false,
1453
+ error: `No handler registered for action: ${request.action}`
1454
+ });
1455
+ return;
1456
+ }
1457
+ try {
1458
+ const response = await handler(request);
1459
+ await respond(response);
1460
+ log(`[ExternalRequest] Response sent for: ${request.action}`);
1461
+ } catch (error) {
1462
+ log(`[ExternalRequest] Handler error:`, error);
1463
+ await respond({
1464
+ requestId: request.requestId,
1465
+ success: false,
1466
+ error: error instanceof Error ? error.message : String(error)
1467
+ });
1468
+ }
1469
+ }
1470
+ async function respondToExternalRequest(response, request) {
1471
+ await request("external.respond", response);
1472
+ }
1473
+
1474
+ // src/client.ts
1475
+ var HaexVaultClient = class {
1476
+ constructor(config = {}) {
1477
+ // State
1478
+ this.initialized = false;
1479
+ this.isNativeWindow = false;
1480
+ this.requestCounter = 0;
1481
+ this._extensionInfo = null;
1482
+ this._context = null;
1483
+ this._setupCompleted = false;
1484
+ // Collections
1485
+ this.pendingRequests = /* @__PURE__ */ new Map();
1486
+ this.eventListeners = /* @__PURE__ */ new Map();
1487
+ this.externalRequestHandlers = /* @__PURE__ */ new Map();
1488
+ this.reactiveSubscribers = /* @__PURE__ */ new Set();
1489
+ // Handlers
1490
+ this.messageHandler = null;
1491
+ this.setupPromise = null;
1492
+ this.setupHook = null;
1493
+ // Public APIs
1494
+ this.orm = null;
1495
+ this.config = {
1496
+ debug: config.debug ?? false,
1497
+ timeout: config.timeout ?? DEFAULT_TIMEOUT,
1498
+ manifest: config.manifest
1499
+ };
1500
+ this.storage = new StorageAPI(this);
1501
+ this.database = new DatabaseAPI(this);
1502
+ this.filesystem = new FilesystemAPI(this);
1503
+ this.web = new WebAPI(this);
1504
+ this.permissions = new PermissionsAPI(this);
1505
+ installConsoleForwarding(this.config.debug);
1506
+ this.readyPromise = new Promise((resolve) => {
1507
+ this.resolveReady = resolve;
1508
+ });
1509
+ this.init();
1510
+ }
1511
+ // ==========================================================================
1512
+ // Lifecycle
1513
+ // ==========================================================================
1514
+ async ready() {
1515
+ return this.readyPromise;
1516
+ }
1517
+ get setupCompleted() {
1518
+ return this._setupCompleted;
1519
+ }
1520
+ onSetup(setupFn) {
1521
+ if (this.setupHook) {
1522
+ throw new Error("Setup hook already registered");
1349
1523
  }
1350
- this.emitEvent(event);
1351
- }
1352
- async handleExternalRequest(request) {
1353
- this.log(`[ExternalRequest] Received request: ${request.action} from ${request.publicKey.substring(0, 20)}...`);
1354
- const handler = this.externalRequestHandlers.get(request.action);
1355
- if (!handler) {
1356
- this.log(`[ExternalRequest] No handler for action: ${request.action}`);
1357
- await this.respondToExternalRequest({
1358
- requestId: request.requestId,
1359
- success: false,
1360
- error: `No handler registered for action: ${request.action}`
1361
- });
1524
+ this.setupHook = setupFn;
1525
+ }
1526
+ async setupComplete() {
1527
+ await this.readyPromise;
1528
+ if (!this.setupHook || this.setupCompleted) {
1362
1529
  return;
1363
1530
  }
1364
- try {
1365
- const response = await handler(request);
1366
- await this.respondToExternalRequest(response);
1367
- this.log(`[ExternalRequest] Response sent for: ${request.action}`);
1368
- } catch (error) {
1369
- this.log(`[ExternalRequest] Handler error:`, error);
1370
- await this.respondToExternalRequest({
1371
- requestId: request.requestId,
1372
- success: false,
1373
- error: error instanceof Error ? error.message : String(error)
1374
- });
1531
+ if (!this.setupPromise) {
1532
+ this.setupPromise = this.runSetupAsync();
1375
1533
  }
1534
+ return this.setupPromise;
1376
1535
  }
1377
- emitEvent(event) {
1378
- this.log("Event received:", event);
1379
- const listeners = this.eventListeners.get(event.type);
1380
- if (listeners) {
1381
- listeners.forEach((callback) => callback(event));
1536
+ destroy() {
1537
+ if (this.messageHandler) {
1538
+ window.removeEventListener("message", this.messageHandler);
1382
1539
  }
1540
+ this.pendingRequests.forEach(({ timeout }) => clearTimeout(timeout));
1541
+ this.pendingRequests.clear();
1542
+ this.eventListeners.clear();
1543
+ this.initialized = false;
1544
+ this.log("HaexVault SDK destroyed");
1383
1545
  }
1384
- generateRequestId() {
1385
- return `req_${++this.requestCounter}`;
1546
+ // ==========================================================================
1547
+ // Properties
1548
+ // ==========================================================================
1549
+ get extensionInfo() {
1550
+ return this._extensionInfo;
1386
1551
  }
1387
- validatePublicKey(publicKey) {
1388
- if (!publicKey || typeof publicKey !== "string" || publicKey.trim() === "") {
1389
- throw new HaexHubError(
1390
- "INVALID_PUBLIC_KEY" /* INVALID_PUBLIC_KEY */,
1391
- "errors.invalid_public_key",
1392
- { publicKey }
1393
- );
1394
- }
1552
+ get context() {
1553
+ return this._context;
1395
1554
  }
1396
- validateExtensionName(extensionName) {
1397
- if (!extensionName || !/^[a-z][a-z0-9-]*$/i.test(extensionName)) {
1398
- throw new HaexHubError(
1399
- "INVALID_EXTENSION_NAME" /* INVALID_EXTENSION_NAME */,
1400
- "errors.invalid_extension_name",
1401
- { extensionName }
1402
- );
1403
- }
1404
- if (extensionName.includes(TABLE_SEPARATOR)) {
1405
- throw new HaexHubError(
1406
- "INVALID_EXTENSION_NAME" /* INVALID_EXTENSION_NAME */,
1407
- "errors.extension_name_contains_separator",
1408
- { extensionName, separator: TABLE_SEPARATOR }
1409
- );
1555
+ // ==========================================================================
1556
+ // Subscriptions
1557
+ // ==========================================================================
1558
+ subscribe(callback) {
1559
+ this.reactiveSubscribers.add(callback);
1560
+ return () => {
1561
+ this.reactiveSubscribers.delete(callback);
1562
+ };
1563
+ }
1564
+ // ==========================================================================
1565
+ // Table Name Utilities
1566
+ // ==========================================================================
1567
+ getTableName(tableName) {
1568
+ return getExtensionTableName(this._extensionInfo, tableName);
1569
+ }
1570
+ getDependencyTableName(publicKey, extensionName, tableName) {
1571
+ return getDependencyTableName(publicKey, extensionName, tableName);
1572
+ }
1573
+ parseTableName(fullTableName) {
1574
+ return parseTableName(fullTableName);
1575
+ }
1576
+ // ==========================================================================
1577
+ // Database
1578
+ // ==========================================================================
1579
+ initializeDatabase(schema) {
1580
+ const db = createDrizzleInstance(schema, this._extensionInfo, this.request.bind(this), this.log.bind(this));
1581
+ this.orm = db;
1582
+ return db;
1583
+ }
1584
+ async query(sql, params = []) {
1585
+ return queryRaw(sql, params, this.request.bind(this), this.config.debug);
1586
+ }
1587
+ async select(sql, params = []) {
1588
+ return this.query(sql, params);
1589
+ }
1590
+ async execute(sql, params = []) {
1591
+ return executeRaw(sql, params, this.request.bind(this));
1592
+ }
1593
+ async registerMigrationsAsync(extensionVersion, migrations) {
1594
+ return this.database.registerMigrationsAsync(extensionVersion, migrations);
1595
+ }
1596
+ // ==========================================================================
1597
+ // Dependencies
1598
+ // ==========================================================================
1599
+ async getDependencies() {
1600
+ return this.request("extensions.getDependencies");
1601
+ }
1602
+ // ==========================================================================
1603
+ // Permissions
1604
+ // ==========================================================================
1605
+ async requestDatabasePermission(request) {
1606
+ return this.request("permissions.database.request", {
1607
+ resource: request.resource,
1608
+ operation: request.operation,
1609
+ reason: request.reason
1610
+ });
1611
+ }
1612
+ async checkDatabasePermission(resource, operation) {
1613
+ const response = await this.request("permissions.database.check", { resource, operation });
1614
+ return response.status === "granted";
1615
+ }
1616
+ // ==========================================================================
1617
+ // Search
1618
+ // ==========================================================================
1619
+ async respondToSearch(requestId, results) {
1620
+ await this.request("search.respond", { requestId, results });
1621
+ }
1622
+ // ==========================================================================
1623
+ // External Requests
1624
+ // ==========================================================================
1625
+ onExternalRequest(action, handler) {
1626
+ return registerExternalHandler(action, handler, this.externalRequestHandlers, this.log.bind(this));
1627
+ }
1628
+ async respondToExternalRequest(response) {
1629
+ await respondToExternalRequest(response, this.request.bind(this));
1630
+ }
1631
+ // ==========================================================================
1632
+ // Events
1633
+ // ==========================================================================
1634
+ on(eventType, callback) {
1635
+ addEventListener(eventType, callback, this.eventListeners);
1636
+ }
1637
+ off(eventType, callback) {
1638
+ removeEventListener(eventType, callback, this.eventListeners);
1639
+ }
1640
+ // ==========================================================================
1641
+ // Communication
1642
+ // ==========================================================================
1643
+ async request(method, params) {
1644
+ const resolvedParams = params ?? {};
1645
+ if (this.isNativeWindow && hasTauri()) {
1646
+ return sendInvoke(method, resolvedParams, this.config, this.log.bind(this));
1410
1647
  }
1648
+ const requestId = generateRequestId(++this.requestCounter);
1649
+ return sendPostMessage(method, resolvedParams, requestId, this.config, this._extensionInfo, this.pendingRequests);
1411
1650
  }
1412
- validateTableName(tableName) {
1413
- if (!tableName || typeof tableName !== "string") {
1414
- throw new HaexHubError(
1415
- "INVALID_TABLE_NAME" /* INVALID_TABLE_NAME */,
1416
- "errors.table_name_empty"
1417
- );
1651
+ // ==========================================================================
1652
+ // Private: Initialization
1653
+ // ==========================================================================
1654
+ async init() {
1655
+ if (this.initialized) return;
1656
+ if (!isInIframe() && hasTauri()) {
1657
+ try {
1658
+ await this.initNative();
1659
+ return;
1660
+ } catch (error) {
1661
+ this.log("Tauri commands failed, falling back to iframe mode", error);
1662
+ }
1418
1663
  }
1419
- if (tableName.includes(TABLE_SEPARATOR)) {
1420
- throw new HaexHubError(
1421
- "INVALID_TABLE_NAME" /* INVALID_TABLE_NAME */,
1422
- "errors.table_name_contains_separator",
1423
- { tableName, separator: TABLE_SEPARATOR }
1424
- );
1664
+ await this.initIframe();
1665
+ }
1666
+ async initNative() {
1667
+ const { extensionInfo, context } = await initNativeMode(
1668
+ {
1669
+ config: this.config,
1670
+ state: {
1671
+ initialized: this.initialized,
1672
+ isNativeWindow: this.isNativeWindow,
1673
+ requestCounter: this.requestCounter,
1674
+ setupCompleted: this._setupCompleted,
1675
+ extensionInfo: this._extensionInfo,
1676
+ context: this._context,
1677
+ orm: this.orm
1678
+ },
1679
+ collections: {
1680
+ pendingRequests: this.pendingRequests,
1681
+ eventListeners: this.eventListeners,
1682
+ externalRequestHandlers: this.externalRequestHandlers,
1683
+ reactiveSubscribers: this.reactiveSubscribers
1684
+ },
1685
+ promises: {
1686
+ readyPromise: this.readyPromise,
1687
+ resolveReady: this.resolveReady,
1688
+ setupPromise: this.setupPromise,
1689
+ setupHook: this.setupHook
1690
+ },
1691
+ handlers: {
1692
+ messageHandler: this.messageHandler
1693
+ }
1694
+ },
1695
+ this.log.bind(this),
1696
+ this.handleEvent.bind(this),
1697
+ (ctx) => {
1698
+ this._context = ctx;
1699
+ this.notifySubscribersInternal();
1700
+ }
1701
+ );
1702
+ this._extensionInfo = extensionInfo;
1703
+ this._context = context;
1704
+ this.isNativeWindow = true;
1705
+ this.initialized = true;
1706
+ this.notifySubscribersInternal();
1707
+ this.resolveReady();
1708
+ }
1709
+ async initIframe() {
1710
+ this.messageHandler = createMessageHandler(
1711
+ this.config,
1712
+ this.pendingRequests,
1713
+ () => this._extensionInfo,
1714
+ this.handleEvent.bind(this)
1715
+ );
1716
+ const { context } = await initIframeMode(
1717
+ {
1718
+ config: this.config,
1719
+ state: {
1720
+ initialized: this.initialized,
1721
+ isNativeWindow: this.isNativeWindow,
1722
+ requestCounter: this.requestCounter,
1723
+ setupCompleted: this._setupCompleted,
1724
+ extensionInfo: this._extensionInfo,
1725
+ context: this._context,
1726
+ orm: this.orm
1727
+ },
1728
+ collections: {
1729
+ pendingRequests: this.pendingRequests,
1730
+ eventListeners: this.eventListeners,
1731
+ externalRequestHandlers: this.externalRequestHandlers,
1732
+ reactiveSubscribers: this.reactiveSubscribers
1733
+ },
1734
+ promises: {
1735
+ readyPromise: this.readyPromise,
1736
+ resolveReady: this.resolveReady,
1737
+ setupPromise: this.setupPromise,
1738
+ setupHook: this.setupHook
1739
+ },
1740
+ handlers: {
1741
+ messageHandler: this.messageHandler
1742
+ }
1743
+ },
1744
+ this.log.bind(this),
1745
+ this.messageHandler,
1746
+ this.request.bind(this)
1747
+ );
1748
+ if (this.config.manifest) {
1749
+ this._extensionInfo = {
1750
+ publicKey: this.config.manifest.publicKey,
1751
+ name: this.config.manifest.name,
1752
+ version: this.config.manifest.version,
1753
+ displayName: this.config.manifest.name
1754
+ };
1755
+ this.notifySubscribersInternal();
1425
1756
  }
1426
- if (!/^[a-z][a-z0-9-_]*$/i.test(tableName)) {
1427
- throw new HaexHubError(
1428
- "INVALID_TABLE_NAME" /* INVALID_TABLE_NAME */,
1429
- "errors.table_name_format",
1430
- { tableName }
1431
- );
1757
+ this._context = context;
1758
+ this.isNativeWindow = false;
1759
+ this.initialized = true;
1760
+ this.notifySubscribersInternal();
1761
+ this.resolveReady();
1762
+ }
1763
+ // ==========================================================================
1764
+ // Private: Event Handling
1765
+ // ==========================================================================
1766
+ handleEvent(event) {
1767
+ processEvent(
1768
+ event,
1769
+ this.log.bind(this),
1770
+ this.eventListeners,
1771
+ (ctx) => {
1772
+ this._context = ctx;
1773
+ this.notifySubscribersInternal();
1774
+ },
1775
+ (extEvent) => this.handleExternalRequestInternal(extEvent.data)
1776
+ );
1777
+ }
1778
+ async handleExternalRequestInternal(request) {
1779
+ await handleExternalRequest(request, this.externalRequestHandlers, this.respondToExternalRequest.bind(this), this.log.bind(this));
1780
+ }
1781
+ // ==========================================================================
1782
+ // Private: Setup
1783
+ // ==========================================================================
1784
+ async runSetupAsync() {
1785
+ if (!this.setupHook) return;
1786
+ try {
1787
+ this.log("[HaexVault] Running setup hook...");
1788
+ await this.setupHook();
1789
+ this._setupCompleted = true;
1790
+ this.log("[HaexVault] Setup completed successfully");
1791
+ this.notifySubscribersInternal();
1792
+ } catch (error) {
1793
+ this.log("[HaexVault] Setup failed:", error);
1794
+ throw error;
1432
1795
  }
1433
1796
  }
1797
+ // ==========================================================================
1798
+ // Private: Utilities
1799
+ // ==========================================================================
1800
+ notifySubscribersInternal() {
1801
+ notifySubscribers(this.reactiveSubscribers);
1802
+ }
1434
1803
  log(...args) {
1435
1804
  if (this.config.debug) {
1436
- console.log("[HaexSpace SDK]", ...args);
1805
+ console.log("[HaexVault SDK]", ...args);
1437
1806
  }
1438
1807
  }
1439
1808
  };