@imbricate/origin-loader 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WMXPY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/built-in-origin-loader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @author WMXPY
+ * @namespace OriginLoader
+ * @description Built-in Origin Loader
+ */
+import { IImbricateOrigin, ImbricateOriginPersistenceOrigin } from "@imbricate/core";
+/**
+ * Load imbricate origin from built-in origin
+ *  This function will load the origin from the built-in origin
+ *  and initialize the origin with the payloads
+ *
+ * @param origin origin to persistence to load
+ *
+ * @returns a promise of the loaded origin
+ *  if the origin is not found, return null
+ */
+export declare const loadImbricateOriginFromBuiltInOrigin: (origin: ImbricateOriginPersistenceOrigin) => Promise<IImbricateOrigin | null>;

package/built-in-origin-loader.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * @author WMXPY
+ * @namespace OriginLoader
+ * @description Built-in Origin Loader
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadImbricateOriginFromBuiltInOrigin = void 0;
+const core_1 = require("@imbricate/core");
+const origin_file_system_1 = __importDefault(require("@imbricate/origin-file-system"));
+const origin_quick_action_1 = __importDefault(require("@imbricate/origin-quick-action"));
+/**
+ * Load imbricate origin from built-in origin
+ *  This function will load the origin from the built-in origin
+ *  and initialize the origin with the payloads
+ *
+ * @param origin origin to persistence to load
+ *
+ * @returns a promise of the loaded origin
+ *  if the origin is not found, return null
+ */
+const loadImbricateOriginFromBuiltInOrigin = (origin) => __awaiter(void 0, void 0, void 0, function* () {
+    if (origin.originLoadType !== core_1.IMBRICATE_ORIGIN_LOAD_TYPE.BUILT_IN) {
+        return null;
+    }
+    switch (origin.originLoadValue) {
+        case core_1.IMBRICATE_ORIGIN_BUILT_IN.ORIGIN_FILE_SYSTEM: {
+            return (0, origin_file_system_1.default)(origin.originPayloads);
+        }
+        case core_1.IMBRICATE_ORIGIN_BUILT_IN.ORIGIN_QUICK_ACTION: {
+            return (0, origin_quick_action_1.default)(origin.originPayloads);
+        }
+        default: {
+            console.log(`Origin load value ${origin.originLoadValue} is not found`);
+            console.log(`Available built-in origin load values: ${core_1.ImbricateOriginBuiltInList.join(", ")}`);
+            return null;
+        }
+    }
+    return null;
+});
+exports.loadImbricateOriginFromBuiltInOrigin = loadImbricateOriginFromBuiltInOrigin;

package/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @author WMXPY
+ * @namespace OriginLoader
+ * @description Index
+ */
+export * from "./built-in-origin-loader";
+export * from "./origin-loader";
+export { IMBRICATE_ORIGIN_BUILT_IN, IMBRICATE_ORIGIN_LOAD_TYPE, } from "@imbricate/core";
+export type { ImbricateOriginLoader, ImbricateOriginPersistence, ImbricateOriginPersistenceOrigin, } from "@imbricate/core";

package/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * @author WMXPY
+ * @namespace OriginLoader
+ * @description Index
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMBRICATE_ORIGIN_LOAD_TYPE = exports.IMBRICATE_ORIGIN_BUILT_IN = void 0;
+__exportStar(require("./built-in-origin-loader"), exports);
+__exportStar(require("./origin-loader"), exports);
+// Re-export types from core for convenience
+var core_1 = require("@imbricate/core");
+Object.defineProperty(exports, "IMBRICATE_ORIGIN_BUILT_IN", { enumerable: true, get: function () { return core_1.IMBRICATE_ORIGIN_BUILT_IN; } });
+Object.defineProperty(exports, "IMBRICATE_ORIGIN_LOAD_TYPE", { enumerable: true, get: function () { return core_1.IMBRICATE_ORIGIN_LOAD_TYPE; } });

package/origin-loader.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @author WMXPY
+ * @namespace OriginLoader
+ * @description Origin Loader
+ */
+import { IImbricateOrigin, ImbricateOriginPersistence, ImbricateOriginPersistenceOrigin } from "@imbricate/core";
+/**
+ * Load imbricate origin from persistence origin
+ *  This function will load the origin from the persistence origin
+ *  and initialize the origin with the payloads
+ *
+ * @param origin origin to persistence to load
+ *
+ * @returns a promise of the loaded origin
+ *  if the origin is not found, return null
+ */
+export declare const loadImbricateOriginFromPersistenceOrigin: (origin: ImbricateOriginPersistenceOrigin) => Promise<IImbricateOrigin | null>;
+/**
+ * Load imbricate origins from persistence
+ *  This function will load all origins from the persistence
+ *  and initialize the origins with the payloads
+ *  If the origin is not found, it will be ignored
+ *
+ * @param persistence persistence to load origins
+ *
+ * @returns a promise of the loaded origins, if the origin is not found, return empty array
+ */
+export declare const loadImbricateOriginsFromPersistence: (persistence: ImbricateOriginPersistence) => Promise<IImbricateOrigin[]>;

package/origin-loader.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * @author WMXPY
+ * @namespace OriginLoader
+ * @description Origin Loader
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadImbricateOriginsFromPersistence = exports.loadImbricateOriginFromPersistenceOrigin = void 0;
+const core_1 = require("@imbricate/core");
+const built_in_origin_loader_1 = require("./built-in-origin-loader");
+/**
+ * Load imbricate origin from persistence origin
+ *  This function will load the origin from the persistence origin
+ *  and initialize the origin with the payloads
+ *
+ * @param origin origin to persistence to load
+ *
+ * @returns a promise of the loaded origin
+ *  if the origin is not found, return null
+ */
+const loadImbricateOriginFromPersistenceOrigin = (origin) => __awaiter(void 0, void 0, void 0, function* () {
+    switch (origin.originLoadType) {
+        case core_1.IMBRICATE_ORIGIN_LOAD_TYPE.BUILT_IN: {
+            return (0, built_in_origin_loader_1.loadImbricateOriginFromBuiltInOrigin)(origin);
+        }
+        case core_1.IMBRICATE_ORIGIN_LOAD_TYPE.NPM_PACKAGE: {
+            const originPackage = yield Promise.resolve(`${origin.originLoadValue}`).then(s => __importStar(require(s)));
+            if (typeof originPackage.default === "function") {
+                const initialized = originPackage.default.call(null, origin.originPayloads);
+                return initialized;
+            }
+            break;
+        }
+        case core_1.IMBRICATE_ORIGIN_LOAD_TYPE.FILE_SYSTEM: {
+            const originPackage = yield Promise.resolve(`${origin.originLoadValue}`).then(s => __importStar(require(s)));
+            if (typeof originPackage.default === "function") {
+                const initialized = originPackage.default.call(null, origin.originPayloads);
+                return initialized;
+            }
+            break;
+        }
+        default: {
+            console.log(`Origin load type ${origin.originLoadType} is not found`);
+            console.log(`Available origin load types: ${core_1.ImbricateOriginLoadTypeList.join(", ")}`);
+            return null;
+        }
+    }
+    return null;
+});
+exports.loadImbricateOriginFromPersistenceOrigin = loadImbricateOriginFromPersistenceOrigin;
+/**
+ * Load imbricate origins from persistence
+ *  This function will load all origins from the persistence
+ *  and initialize the origins with the payloads
+ *  If the origin is not found, it will be ignored
+ *
+ * @param persistence persistence to load origins
+ *
+ * @returns a promise of the loaded origins, if the origin is not found, return empty array
+ */
+const loadImbricateOriginsFromPersistence = (persistence) => __awaiter(void 0, void 0, void 0, function* () {
+    const origins = [];
+    for (const origin of persistence.origins) {
+        const originInstance = yield (0, exports.loadImbricateOriginFromPersistenceOrigin)(origin);
+        if (originInstance) {
+            origins.push(originInstance);
+        }
+    }
+    return origins;
+});
+exports.loadImbricateOriginsFromPersistence = loadImbricateOriginsFromPersistence;

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@imbricate/origin-loader",
+  "main": "index.js",
+  "version": "1.0.0",
+  "description": "Origin Loader for Imbricate",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Imbricate/Imbricate.git"
+  },
+  "keywords": [
+    "imbricate",
+    "loader"
+  ],
+  "author": "WMXPY",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Imbricate/Imbricate/issues"
+  },
+  "homepage": "https://imbricate.io",
+  "dependencies": {
+    "@imbricate/origin-file-system": "^3.20.0",
+    "@imbricate/origin-quick-action": "^0.0.0"
+  },
+  "peerDependencies": {
+    "@imbricate/core": "*"
+  }
+}