@acmekit/acmekit 2.13.1

package/dist/index.js

@@ -0,0 +1,44 @@
+"use strict";
+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 __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.Commands = void 0;
+exports.Commands = __importStar(require("./commands"));
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./instrumentation"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAAsC;AACtC,0CAAuB;AACvB,0CAAuB;AACvB,oDAAiC"}

package/dist/instrumentation/index.d.ts

@@ -0,0 +1,41 @@
+import type { NodeSDKConfiguration } from "@acmekit/framework/opentelemetry/sdk-node";
+import type { SpanExporter } from "@acmekit/framework/opentelemetry/sdk-trace-node";
+/**
+ * Instrument the first touch point of the HTTP layer to report traces to
+ * OpenTelemetry
+ */
+export declare function instrumentHttpLayer(): void;
+/**
+ * Instrument the queries made using the remote query
+ */
+export declare function instrumentRemoteQuery(): void;
+/**
+ * Instrument the workflows and steps execution
+ */
+export declare function instrumentWorkflows(): void;
+export declare function instrumentCache(): void;
+/**
+ * A helper function to configure the OpenTelemetry SDK with some defaults.
+ * For better/more control, please configure the SDK manually.
+ *
+ * You will have to install the following packages within your app for
+ * telemetry to work
+ *
+ * - @opentelemetry/sdk-node
+ * - @opentelemetry/resources
+ * - @opentelemetry/sdk-trace-node
+ * - @opentelemetry/instrumentation-pg
+ * - @opentelemetry/instrumentation
+ */
+export declare function registerOtel(options: Partial<NodeSDKConfiguration> & {
+    serviceName: string;
+    exporter?: SpanExporter;
+    instrument?: Partial<{
+        http: boolean;
+        query: boolean;
+        workflows: boolean;
+        db: boolean;
+        cache: boolean;
+    }>;
+}): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/instrumentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAA;AAenF;;;GAGG;AACH,wBAAgB,mBAAmB,SAoGlC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,SAqFpC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,SAuClC;AAED,wBAAgB,eAAe,SAsG9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,EAAE,OAAO,CAAA;QACb,KAAK,EAAE,OAAO,CAAA;QACd,SAAS,EAAE,OAAO,CAAA;QAClB,EAAE,EAAE,OAAO,CAAA;QACX,KAAK,EAAE,OAAO,CAAA;KACf,CAAC,CAAA;CACH,OA4DF"}

package/dist/instrumentation/index.js

@@ -0,0 +1,340 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentHttpLayer = instrumentHttpLayer;
+exports.instrumentRemoteQuery = instrumentRemoteQuery;
+exports.instrumentWorkflows = instrumentWorkflows;
+exports.instrumentCache = instrumentCache;
+exports.registerOtel = registerOtel;
+const framework_1 = require("@acmekit/framework");
+const http_1 = require("@acmekit/framework/http");
+const api_1 = require("@acmekit/framework/opentelemetry/api");
+const orchestration_1 = require("@acmekit/framework/orchestration");
+const telemetry_1 = require("@acmekit/framework/telemetry");
+const utils_1 = require("@acmekit/framework/utils");
+const caching_1 = __importDefault(require("../modules/caching"));
+const EXCLUDED_RESOURCES = [".vite", "virtual:"];
+function shouldExcludeResource(resource) {
+    return EXCLUDED_RESOURCES.some((excludedResource) => resource.includes(excludedResource));
+}
+/**
+ * Instrument the first touch point of the HTTP layer to report traces to
+ * OpenTelemetry
+ */
+function instrumentHttpLayer() {
+    const startCommand = require("../commands/start");
+    const HTTPTracer = new telemetry_1.Tracer("@acmekit/http", "2.0.0");
+    startCommand.traceRequestHandler = async (requestHandler, req, res, handlerPath) => {
+        if (shouldExcludeResource(req.url)) {
+            return await requestHandler();
+        }
+        const traceName = handlerPath ?? `${req.method} ${req.url}`;
+        await HTTPTracer.trace(traceName, async (span) => {
+            span.setAttributes({
+                "http.route": handlerPath,
+                "http.url": req.url,
+                "http.method": req.method,
+                ...req.headers,
+            });
+            try {
+                await requestHandler();
+            }
+            finally {
+                if (res.statusCode >= 500) {
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: `Failed with ${res.statusMessage}`,
+                    });
+                }
+                span.setAttributes({ "http.statusCode": res.statusCode });
+                span.end();
+            }
+        });
+    };
+    /**
+     * Instrumenting the route handler to report traces to
+     * OpenTelemetry
+     */
+    http_1.ApiLoader.traceRoute = (handler) => {
+        return async (req, res) => {
+            if (shouldExcludeResource(req.originalUrl)) {
+                return await handler(req, res);
+            }
+            const label = req.route?.path ?? `${req.method} ${req.originalUrl}`;
+            const traceName = `route handler: ${label}`;
+            await HTTPTracer.trace(traceName, async (span) => {
+                try {
+                    await handler(req, res);
+                }
+                catch (error) {
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: error.message || "Failed",
+                    });
+                    throw error;
+                }
+                finally {
+                    span.end();
+                }
+            });
+        };
+    };
+    /**
+     * Instrumenting the middleware handler to report traces to
+     * OpenTelemetry
+     */
+    http_1.ApiLoader.traceMiddleware = (handler) => {
+        return async (req, res, next) => {
+            if (shouldExcludeResource(req.originalUrl)) {
+                return handler(req, res, next);
+            }
+            const traceName = `middleware: ${handler.name ? (0, utils_1.camelToSnakeCase)(handler.name) : `anonymous`}`;
+            await HTTPTracer.trace(traceName, async (span) => {
+                try {
+                    await handler(req, res, next);
+                }
+                catch (error) {
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: error.message || "Failed",
+                    });
+                    throw error;
+                }
+                finally {
+                    span.end();
+                }
+            });
+        };
+    };
+}
+/**
+ * Instrument the queries made using the remote query
+ */
+function instrumentRemoteQuery() {
+    const QueryTracer = new telemetry_1.Tracer("@acmekit/query", "2.0.0");
+    framework_1.Query.instrument.graphQuery(async function (queryFn, queryOptions) {
+        return await QueryTracer.trace(`query.graph: ${queryOptions.entity}`, async (span) => {
+            span.setAttributes({
+                "query.fields": queryOptions.fields,
+            });
+            try {
+                return await queryFn();
+            }
+            catch (err) {
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: err.message,
+                });
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        });
+    });
+    framework_1.Query.instrument.remoteQuery(async function (queryFn, queryOptions) {
+        const traceIdentifier = "entryPoint" in queryOptions
+            ? queryOptions.entryPoint
+            : "service" in queryOptions
+                ? queryOptions.service
+                : "__value" in queryOptions
+                    ? Object.keys(queryOptions.__value)[0]
+                    : "unknown source";
+        return await QueryTracer.trace(`remoteQuery: ${traceIdentifier}`, async (span) => {
+            span.setAttributes({
+                "query.fields": "fields" in queryOptions ? queryOptions.fields : [],
+            });
+            try {
+                return await queryFn();
+            }
+            catch (error) {
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: error.message,
+                });
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    });
+    framework_1.Query.instrument.remoteDataFetch(async function (fetchFn, serviceName, method, options) {
+        return await QueryTracer.trace(`${(0, utils_1.camelToSnakeCase)(serviceName)}.${(0, utils_1.camelToSnakeCase)(method)}`, async (span) => {
+            span.setAttributes({
+                "fetch.select": options.select,
+                "fetch.relations": options.relations,
+            });
+            try {
+                return await fetchFn();
+            }
+            catch (error) {
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: error.message,
+                });
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    });
+}
+/**
+ * Instrument the workflows and steps execution
+ */
+function instrumentWorkflows() {
+    const WorkflowsTracer = new telemetry_1.Tracer("@acmekit/framework/workflows-sdk", "2.0.0");
+    orchestration_1.TransactionOrchestrator.traceTransaction = async (transactionResumeFn, metadata) => {
+        return await WorkflowsTracer.trace(`workflow:${(0, utils_1.camelToSnakeCase)(metadata.model_id)}`, async function (span) {
+            span.setAttribute("workflow.transaction_id", metadata.transaction_id);
+            if (metadata.flow_metadata) {
+                Object.entries(metadata.flow_metadata).forEach(([key, value]) => {
+                    span.setAttribute(`workflow.flow_metadata.${key}`, value);
+                });
+            }
+            return await transactionResumeFn().finally(() => span.end());
+        });
+    };
+    orchestration_1.TransactionOrchestrator.traceStep = async (stepHandler, metadata) => {
+        return await WorkflowsTracer.trace(`step:${(0, utils_1.camelToSnakeCase)(metadata.action)}:${metadata.type}`, async function (span) {
+            Object.entries(metadata).forEach(([key, value]) => {
+                span.setAttribute(`workflow.step.${key}`, value);
+            });
+            // TODO: should we report error and re throw it?
+            return await stepHandler().finally(() => span.end());
+        });
+    };
+}
+function instrumentCache() {
+    if (!utils_1.FeatureFlag.isFeatureEnabled("caching")) {
+        return;
+    }
+    const CacheTracer = new telemetry_1.Tracer("@acmekit/caching", "2.0.0");
+    const cacheModule_ = caching_1.default;
+    cacheModule_.service.traceGet = async function (cacheGetFn, key, tags) {
+        return await CacheTracer.trace(`cache.get`, async (span) => {
+            span.setAttributes({
+                "cache.key": key,
+                "cache.tags": tags,
+            });
+            try {
+                return await cacheGetFn();
+            }
+            catch (error) {
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: error.message,
+                });
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    };
+    cacheModule_.service.traceSet = async function (cacheSetFn, key, tags, options = {}) {
+        return await CacheTracer.trace(`cache.set`, async (span) => {
+            span.setAttributes({
+                "cache.key": key,
+                "cache.tags": tags,
+                "cache.options": JSON.stringify(options),
+            });
+            try {
+                return await cacheSetFn();
+            }
+            catch (error) {
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: error.message,
+                });
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    };
+    cacheModule_.service.traceClear = async function (cacheClearFn, key, tags, options = {}) {
+        return await CacheTracer.trace(`cache.clear`, async (span) => {
+            span.setAttributes({
+                "cache.key": key,
+                "cache.tags": tags,
+                "cache.options": JSON.stringify(options),
+            });
+            try {
+                return await cacheClearFn();
+            }
+            catch (error) {
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: error.message,
+                });
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    };
+}
+/**
+ * A helper function to configure the OpenTelemetry SDK with some defaults.
+ * For better/more control, please configure the SDK manually.
+ *
+ * You will have to install the following packages within your app for
+ * telemetry to work
+ *
+ * - @opentelemetry/sdk-node
+ * - @opentelemetry/resources
+ * - @opentelemetry/sdk-trace-node
+ * - @opentelemetry/instrumentation-pg
+ * - @opentelemetry/instrumentation
+ */
+function registerOtel(options) {
+    const { exporter, serviceName, instrument, instrumentations, ...nodeSdkOptions } = {
+        instrument: {},
+        instrumentations: [],
+        ...options,
+    };
+    const { Resource, resourceFromAttributes, } = require("@acmekit/framework/opentelemetry/resources");
+    const { NodeSDK } = require("@acmekit/framework/opentelemetry/sdk-node");
+    const { SimpleSpanProcessor, } = require("@acmekit/framework/opentelemetry/sdk-trace-node");
+    if (instrument.db) {
+        const { PgInstrumentation, } = require("@acmekit/framework/opentelemetry/instrumentation-pg");
+        instrumentations.push(new PgInstrumentation());
+    }
+    if (instrument.http) {
+        instrumentHttpLayer();
+    }
+    if (instrument.query) {
+        instrumentRemoteQuery();
+    }
+    if (instrument.workflows) {
+        instrumentWorkflows();
+    }
+    if (instrument.cache) {
+        instrumentCache();
+    }
+    const sdk = new NodeSDK({
+        serviceName,
+        /**
+         * Older version of "@opentelemetry/resources" exports the "Resource" class.
+         * Whereas, the new one exports the "resourceFromAttributes" method.
+         */
+        resource: resourceFromAttributes
+            ? resourceFromAttributes({
+                "service.name": serviceName,
+            })
+            : new Resource({ "service.name": serviceName }),
+        spanProcessor: new SimpleSpanProcessor(exporter),
+        ...nodeSdkOptions,
+        instrumentations: instrumentations,
+    });
+    sdk.start();
+    return sdk;
+}
+//# sourceMappingURL=index.js.map

package/dist/instrumentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"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"}

package/dist/loaders/admin.d.ts

@@ -0,0 +1,11 @@
+import { ConfigModule, PluginDetails } from "@acmekit/framework/types";
+import { Express } from "express";
+type Options = {
+    app: Express;
+    configModule: ConfigModule;
+    rootDirectory: string;
+    plugins: PluginDetails[];
+};
+export default function adminLoader({ app, configModule, rootDirectory, plugins, }: Options): Promise<Express>;
+export {};
+//# sourceMappingURL=admin.d.ts.map

package/dist/loaders/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/loaders/admin.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,YAAY,EACZ,aAAa,EACd,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAIjC,KAAK,OAAO,GAAG;IACb,GAAG,EAAE,OAAO,CAAA;IACZ,YAAY,EAAE,YAAY,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB,CAAA;AAWD,wBAA8B,WAAW,CAAC,EACxC,GAAG,EACH,YAAY,EACZ,aAAa,EACb,OAAO,GACR,EAAE,OAAO,oBA0CT"}

package/dist/loaders/admin.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = adminLoader;
+const logger_1 = require("@acmekit/framework/logger");
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("../utils");
+const NOT_ALLOWED_PATHS = ["/auth", "/store", "/admin"];
+async function adminLoader({ app, configModule, rootDirectory, plugins, }) {
+    const { admin } = configModule;
+    const sources = [];
+    const pluginAdminPaths = [];
+    for (const plugin of plugins) {
+        if (!plugin.admin) {
+            continue;
+        }
+        if (plugin.admin.type === "local") {
+            sources.push(plugin.admin.resolve);
+        }
+        else {
+            pluginAdminPaths.push(plugin.admin.resolve);
+        }
+    }
+    const adminOptions = {
+        disable: false,
+        sources,
+        plugins: pluginAdminPaths,
+        ...admin,
+        outDir: path_1.default.join(rootDirectory, utils_1.ADMIN_RELATIVE_OUTPUT_DIR),
+    };
+    if (adminOptions?.disable) {
+        return app;
+    }
+    if (NOT_ALLOWED_PATHS.includes(adminOptions.path)) {
+        logger_1.logger.error(`The 'admin.path' in 'acmekit-config.js' is set to a value that is not allowed. This can prevent your server from working correctly. Please set 'admin.path' to a value that is not one of the following: ${NOT_ALLOWED_PATHS.join(", ")}.`);
+    }
+    if (process.env.NODE_ENV === "development") {
+        return initDevelopmentServer(app, adminOptions);
+    }
+    return serveProductionBuild(app, adminOptions);
+}
+async function initDevelopmentServer(app, options) {
+    const { develop } = await import("@acmekit/admin-bundler");
+    const adminMiddleware = await develop(options);
+    app.use(options.path, adminMiddleware);
+    return app;
+}
+async function serveProductionBuild(app, options) {
+    const { serve } = await import("@acmekit/admin-bundler");
+    const adminRoute = await serve(options);
+    app.use(options.path, adminRoute);
+    return app;
+}
+//# sourceMappingURL=admin.js.map

package/dist/loaders/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/loaders/admin.ts"],"names":[],"mappings":";;;;;AA0BA,8BA+CC;AAzED,sDAAkD;AAOlD,gDAAuB;AACvB,oCAAoD;AAgBpD,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAExC,KAAK,UAAU,WAAW,CAAC,EACxC,GAAG,EACH,YAAY,EACZ,aAAa,EACb,OAAO,GACC;IACR,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAAA;IAE9B,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,gBAAgB,GAAa,EAAE,CAAA;IACrC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,SAAQ;QACV,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACpC,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAuB;QACvC,OAAO,EAAE,KAAK;QACd,OAAO;QACP,OAAO,EAAE,gBAAgB;QACzB,GAAG,KAAK;QACR,MAAM,EAAE,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,iCAAyB,CAAC;KAC5D,CAAA;IAED,IAAI,YAAY,EAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,IAAI,iBAAiB,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,eAAM,CAAC,KAAK,CACV,4MAA4M,iBAAiB,CAAC,IAAI,CAChO,IAAI,CACL,GAAG,CACL,CAAA;IACH,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC3C,OAAO,qBAAqB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;AAChD,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,GAAY,EACZ,OAA2B;IAE3B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;IAE1D,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9C,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IACtC,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,GAAY,EAAE,OAA2B;IAC3E,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;IAExD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAA;IAEvC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAEjC,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/loaders/api.d.ts

@@ -0,0 +1,10 @@
+import { AcmeKitContainer, PluginDetails } from "@acmekit/framework/types";
+import { Express } from "express";
+type Options = {
+    app: Express;
+    plugins: PluginDetails[];
+    container: AcmeKitContainer;
+};
+declare const _default: ({ app, container, plugins }: Options) => Promise<Express>;
+export default _default;
+//# sourceMappingURL=api.d.ts.map

package/dist/loaders/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/loaders/api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAIjC,KAAK,OAAO,GAAG;IACb,GAAG,EAAE,OAAO,CAAA;IACZ,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,SAAS,EAAE,gBAAgB,CAAA;CAC5B,CAAA;yBAEqB,6BAA6B,OAAO;AAA1D,wBA+DC"}

package/dist/loaders/api.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const http_1 = require("@acmekit/framework/http");
+const utils_1 = require("@acmekit/framework/utils");
+const path_1 = require("path");
+const qs_1 = __importDefault(require("qs"));
+exports.default = async ({ app, container, plugins }) => {
+    // This is a workaround for the issue described here: https://github.com/expressjs/express/issues/3454
+    // We parse the url and get the qs to be parsed and override the query prop from the request
+    app.use(function (req, res, next) {
+        const parsedUrl = req.url.split("?");
+        parsedUrl.shift();
+        const queryParamsStr = parsedUrl.join("?");
+        if (queryParamsStr) {
+            req.query = qs_1.default.parse(queryParamsStr, { arrayLimit: Infinity });
+        }
+        next();
+    });
+    // Store the initial router stack length before loading API resources for HMR
+    if (utils_1.FeatureFlag.isFeatureEnabled("backend_hmr")) {
+        const initialStackLength = app._router?.stack?.length ?? 0;
+        global.__MEDUSA_HMR_INITIAL_STACK_LENGTH__ = initialStackLength;
+    }
+    const sourcePaths = [];
+    /**
+     * Always load plugin routes before the AcmeKit core routes, since it
+     * will allow the plugin to define routes with higher priority
+     * than AcmeKit. Here are couple of examples.
+     *
+     * - Plugin registers a route called "/products/active"
+     * - AcmeKit registers a route called "/products/:id"
+     *
+     * Now, if AcmeKit routes gets registered first, then the "/products/active"
+     * route will never be resolved, because it will be handled by the
+     * "/products/:id" route.
+     */
+    sourcePaths.push((0, path_1.join)(__dirname, "../api"), ...plugins.map((pluginDetails) => {
+        return (0, path_1.join)(pluginDetails.resolve, "api");
+    }));
+    const { projectConfig: { http: { restrictedFields }, }, } = container.resolve("configModule");
+    // TODO: Figure out why this is causing issues with test when placed inside ./api.ts
+    // Adding this here temporarily
+    // Test: (packages/acmekit/src/api/routes/admin/currencies/update-currency.ts)
+    try {
+        await new http_1.ApiLoader({
+            app: app,
+            sourceDir: sourcePaths,
+            baseRestrictedFields: restrictedFields?.store,
+            container,
+        }).load();
+    }
+    catch (err) {
+        throw Error(`An error occurred while registering API Routes. Error: ${err.message}`);
+    }
+    return app;
+};
+//# sourceMappingURL=api.js.map

package/dist/loaders/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/loaders/api.ts"],"names":[],"mappings":";;;;;AACA,kDAAmD;AAEnD,oDAAsD;AAEtD,+BAA2B;AAC3B,4CAAmB;AAQnB,kBAAe,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAW,EAAE,EAAE;IAC5D,sGAAsG;IACtG,4FAA4F;IAC5F,GAAG,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,GAAG,EAAE,IAAI;QAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACpC,SAAS,CAAC,KAAK,EAAE,CAAA;QACjB,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC1C,IAAI,cAAc,EAAE,CAAC;YACnB,GAAG,CAAC,KAAK,GAAG,YAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,IAAI,EAAE,CAAA;IACR,CAAC,CAAC,CAAA;IAEF,6EAA6E;IAC7E,IAAI,mBAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;QAChD,MAAM,kBAAkB,GAAI,GAAW,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,CAClE;QAAC,MAAc,CAAC,mCAAmC,GAAG,kBAAkB,CAAA;IAC3E,CAAC;IAED,MAAM,WAAW,GAAa,EAAE,CAAA;IAEhC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,IAAI,CACd,IAAA,WAAI,EAAC,SAAS,EAAE,QAAQ,CAAC,EACzB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE;QAC/B,OAAO,IAAA,WAAI,EAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC,CAAC,CACH,CAAA;IAED,MAAM,EACJ,aAAa,EAAE,EACb,IAAI,EAAE,EAAE,gBAAgB,EAAE,GAC3B,GACF,GAAG,SAAS,CAAC,OAAO,CAAe,cAAc,CAAC,CAAA;IAEnD,oFAAoF;IACpF,+BAA+B;IAC/B,8EAA8E;IAC9E,IAAI,CAAC;QACH,MAAM,IAAI,gBAAS,CAAC;YAClB,GAAG,EAAE,GAAG;YACR,SAAS,EAAE,WAAW;YACtB,oBAAoB,EAAE,gBAAgB,EAAE,KAAK;YAC7C,SAAS;SACV,CAAC,CAAC,IAAI,EAAE,CAAA;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,CACT,0DAA0D,GAAG,CAAC,OAAO,EAAE,CACxE,CAAA;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/dist/loaders/index.d.ts

@@ -0,0 +1,21 @@
+import { LoadedModule, AcmeKitContainer } from "@acmekit/framework/types";
+import { GraphQLSchema } from "@acmekit/framework/utils";
+import { Express } from "express";
+type Options = {
+    directory: string;
+    expressApp: Express;
+    skipLoadingEntryPoints?: boolean;
+};
+export declare function initializeContainer(rootDirectory: string, options?: {
+    skipDbConnection?: boolean;
+    throwOnError?: boolean;
+}): Promise<AcmeKitContainer>;
+declare const _default: ({ directory: rootDirectory, expressApp, skipLoadingEntryPoints, }: Options) => Promise<{
+    container: AcmeKitContainer;
+    app: Express;
+    modules: Record<string, LoadedModule | LoadedModule[]>;
+    shutdown: () => Promise<void>;
+    gqlSchema?: GraphQLSchema;
+}>;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/loaders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,YAAY,EACZ,gBAAgB,EAEjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAGL,aAAa,EAId,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAA;AAOlE,KAAK,OAAO,GAAG;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC,CAAA;AAgGD,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IACR,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,GACA,OAAO,CAAC,gBAAgB,CAAC,CAsB3B;yBAEqB,mEAInB,OAAO,KAAG,OAAO,CAAC;IACnB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,GAAG,EAAE,OAAO,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC,CAAA;IACtD,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,SAAS,CAAC,EAAE,aAAa,CAAA;CAC1B,CAAC;AAVF,wBAqFC"}