@acmekit/utils 2.13.1

package/dist/auth/abstract-auth-provider.js

@@ -0,0 +1,306 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractAuthModuleProvider = void 0;
+/**
+ * ### constructor
+ *
+ * The constructor allows you to access resources from the module's container using the first parameter,
+ * and the module's options using the second parameter.
+ *
+ * If you're creating a client or establishing a connection with a third-party service, do it in the constructor.
+ *
+ * #### Example
+ *
+ * ```ts
+ * import { AbstractAuthModuleProvider } from "@acmekit/framework/utils"
+ * import { Logger } from "@acmekit/framework/types"
+ *
+ * type InjectedDependencies = {
+ *   logger: Logger
+ * }
+ *
+ * type Options = {
+ *   apiKey: string
+ * }
+ *
+ * class MyAuthProviderService extends AbstractAuthModuleProvider {
+ *   static identifier = "my-auth"
+ *   protected logger_: Logger
+ *   protected options_: Options
+ *   // assuming you're initializing a client
+ *   protected client
+ *
+ *   constructor (
+ *     { logger }: InjectedDependencies,
+ *     options: Options
+ *   ) {
+ *     super(...arguments)
+ *
+ *     this.logger_ = logger
+ *     this.options_ = options
+ *
+ *     // assuming you're initializing a client
+ *     this.client = new Client(options)
+ *   }
+ *
+ *   // ...
+ * }
+ *
+ * export default MyAuthProviderService
+ * ```
+ */
+class AbstractAuthModuleProvider {
+    /**
+     * @deprecated Use `identifier` instead.
+     * @ignore
+     */
+    get provider() {
+        return this.constructor.identifier;
+    }
+    /**
+     * @ignore
+     */
+    get identifier() {
+        return this.constructor.identifier;
+    }
+    /**
+     * @ignore
+     */
+    get displayName() {
+        return this.constructor.DISPLAY_NAME;
+    }
+    /**
+     * This method validates the options of the provider set in `acmekit-config.ts`.
+     * Implementing this method is optional. It's useful if your provider requires custom validation.
+     *
+     * If the options aren't valid, throw an error.
+     *
+     * @param options - The provider's options.
+     *
+     * @example
+     * class MyAuthProviderService extends AbstractAuthModuleProvider {
+     *   static validateOptions(options: Record<any, any>) {
+     *     if (!options.apiKey) {
+     *       throw new AcmeKitError(
+     *         AcmeKitError.Types.INVALID_DATA,
+     *         "API key is required in the provider's options."
+     *       )
+     *     }
+     *   }
+     *   // ...
+     * }
+     */
+    static validateOptions(options) { }
+    /**
+     * This method receives credentails to create a new auth identity. It performs any validation necessary
+     * before creating the auth identity.
+     *
+     * For example, in the `emailpass` provider, this method ensures that the provided email doesn't exist
+     * before creating the auth identity.
+     *
+     * This method is only used in a basic authentication flow, such as when using an email and password
+     * to register and authenticate a user.
+     *
+     * Related Read: [Learn about the different authentication flows in AcmeKit](https://docs.acmekit.com/resources/commerce-modules/auth/authentication-route).
+     *
+     * @param {AuthenticationInput} data - The details of the authentication request.
+     * @param {AuthIdentityProviderService} authIdentityProviderService - The service used to retrieve or
+     * create an auth identity. It has two methods: `create` to create an auth identity,
+     * and `retrieve` to retrieve an auth identity. When you authenticate the user, you can create an auth identity
+     * using this service.
+     * @returns The created authentication identity if no errors occur.
+     *
+     * @example
+     * import {
+     *   AuthIdentityProviderService,
+     *   AuthenticationInput,
+     *   AuthenticationResponse
+     * } from "@acmekit/framework/types"
+     * import { AcmeKitError } from "@acmekit/framework/utils"
+     * // ...
+     *
+     * class MyAuthProviderService extends AbstractAuthModuleProvider {
+     *   // ...
+     *   async register(
+     *     data: AuthenticationInput,
+     *     authIdentityProviderService: AuthIdentityProviderService
+     *   ): Promise<AuthenticationResponse> {
+     *     try {
+     *       await authIdentityService.retrieve({
+     *         entity_id: data.body.email, // email or some ID
+     *       })
+     *
+     *       return {
+     *         success: false,
+     *         error: "Identity with email already exists",
+     *       }
+     *     } catch (error) {
+     *       if (error.type === AcmeKitError.Types.NOT_FOUND) {
+     *         const createdAuthIdentity = await authIdentityProviderService.create({
+     *           entity_id: data.body.email, // email or some ID
+     *           provider: this.provider,
+     *           provider_metadata: {
+     *             // can include password or any other relevant information
+     *           }
+     *         })
+     *
+     *         return {
+     *           success: true,
+     *           authIdentity: createdAuthIdentity,
+     *         }
+     *       }
+     *
+     *       return { success: false, error: error.message }
+     *     }
+     *   }
+     * }
+     */
+    register(data, authIdentityProviderService) {
+        throw new Error(`Method 'register' not implemented for provider ${this.provider}`);
+    }
+    /**
+     * This method is used to update an auth identity's details.
+     *
+     * For example, the `emailpass` provider's implementation of this method updates a user's password.
+     *
+     * @param data - Data relevant to identify the auth identity and what to update in it. For example,
+     * the `emailpass` provider expects in this object an `email` and `password` properties.
+     * @param authIdentityProviderService - The service used to retrieve or
+     * create an auth identity. It has two methods: `create` to create an auth identity,
+     * and `retrieve` to retrieve an auth identity. When you authenticate the user, you can create an auth identity
+     * using this service.
+     * @returns The updated authentication identity if no errors occur.
+     *
+     * @example
+     * import {
+     *   AuthIdentityProviderService,
+     *   AuthenticationInput,
+     *   AuthenticationResponse
+     * } from "@acmekit/framework/types"
+     * import { AcmeKitError } from "@acmekit/framework/utils"
+     * // ...
+     *
+     * class MyAuthProviderService extends AbstractAuthModuleProvider {
+     *   // ...
+     *   async update(
+     *     data: Record<string, unknown>,
+     *     authIdentityProviderService: AuthIdentityProviderService
+     *   ): Promise<AuthenticationResponse> {
+     *     try {
+     *       const authIdentity = await authIdentityService.update(
+     *         data.email, // email or some ID used to identify the auth identity
+     *         {
+     *           user: data.user // example
+     *         }
+     *       )
+     *
+     *       return { success: true, authIdentity }
+     *     } catch (error) {
+     *       return { success: false, error: error.message }
+     *     }
+     *   }
+     * }
+     */
+    update(data, authIdentityProviderService) {
+        throw new Error(`Method 'update' not implemented for provider ${this.provider}`);
+    }
+    /**
+     * This method validates the callback of an authentication request.
+     *
+     * In an authentication flow that requires performing an action with a third-party service, such as login
+     * with a social account, the {@link authenticate} method is called first.
+     *
+     * Then, the third-party service redirects to a frontend URL passing it a `code` query parameter.
+     * The frontend should then send a request to the AcmeKit application's validate callback API route, passing it the code.
+     * That route uses this method to verify the callback's code.
+     *
+     * If the callback is verified successfully, the provider creates an auth identity for the user, or updates the auth identity's user information.
+     *
+     * In the auth identity, use the following properties to store additional data:
+     *
+     * - `provider_metadata`: Store metadata useful for the provider, such as a password hash.
+     * - `user_metadata`: Store metadata of the user's details. For example, if the third-party service returns the user's information such as email
+     * or name, you store this data in this property.
+     *
+     * Related Guide: [Learn about the different authentication flows in AcmeKit](https://docs.acmekit.com/resources/commerce-modules/auth/authentication-route).
+     *
+     * @param {AuthenticationInput} data - The details of the authentication request.
+     * @param {AuthIdentityProviderService} authIdentityProviderService - The service used to retrieve or
+     * create an auth identity. It has two methods: `create` to create an auth identity,
+     * and `retrieve` to retrieve an auth identity. When you authenticate the user, you can create an auth identity
+     * using this service.
+     * @returns {Promise<AuthenticationResponse>} The authentication response.
+     *
+     * @example
+     * import {
+     *   AuthIdentityProviderService,
+     *   AuthenticationInput,
+     *   AuthenticationResponse
+     * } from "@acmekit/framework/types"
+     * // ...
+     *
+     * class MyAuthProviderService extends AbstractAuthModuleProvider {
+     *   // ...
+     *   async validateCallback(
+     *     data: AuthenticationInput,
+     *     authIdentityProviderService: AuthIdentityProviderService
+     *   ): Promise<AuthenticationResponse> {
+     *     const isAuthenticated = false
+     *
+     *     // optional, useful for third-party providers that require a redirect URL
+     *     // to continue the authentication flow
+     *     // const stateKey = data.query?.state as string
+     *     // const state = await authIdentityService.getState(stateKey)
+     *     // if (!state) {
+     *     //   return { success: false, error: "No state provided, or session expired" }
+     *     // }
+     *     // // use callback URL with the third-party service
+     *     // const callbackUrl = state.callback_url
+     *     // TODO perform custom logic to authenticate the user
+     *     // ...
+     *
+     *     if (!isAuthenticated) {
+     *       // if the authentication didn't succeed, return
+     *       // an object of the following format
+     *       return {
+     *         success: false,
+     *         error: "Something went wrong"
+     *       }
+     *     }
+     *
+     *     // authentication is successful, create an auth identity
+     *     // if doesn't exist
+     *     let authIdentity
+     *
+     *     try {
+     *       authIdentity = await authIdentityProviderService.retrieve({
+     *         entity_id: data.body.email, // email or some ID
+     *         provider: this.provider
+     *       })
+     *     } catch (e) {
+     *       // The auth identity doesn't exist so create it
+     *       authIdentity = await authIdentityProviderService.create({
+     *         entity_id: data.body.email, // email or some ID
+     *         provider: this.provider,
+     *         provider_metadata: {
+     *           // can include password or any other relevant information
+     *         },
+     *         user_metadata: {
+     *           // can include data retrieved from the third-party service
+     *         }
+     *       })
+     *     }
+     *
+     *     return {
+     *       success: true,
+     *       authIdentity
+     *     }
+     *   }
+     * }
+     */
+    validateCallback(data, authIdentityProviderService) {
+        throw new Error(`Callback authentication not implemented for provider ${this.provider}`);
+    }
+}
+exports.AbstractAuthModuleProvider = AbstractAuthModuleProvider;
+//# sourceMappingURL=abstract-auth-provider.js.map

package/dist/auth/abstract-auth-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-auth-provider.js","sourceRoot":"","sources":["../../src/auth/abstract-auth-provider.ts"],"names":[],"mappings":";;;AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAsB,0BAA0B;IA8B9C;;;OAGG;IACH,IAAW,QAAQ;QACjB,OAAQ,IAAI,CAAC,WAAiD,CAAC,UAAU,CAAA;IAC3E,CAAC;IAED;;OAEG;IACH,IAAW,UAAU;QACnB,OAAQ,IAAI,CAAC,WAAiD,CAAC,UAAU,CAAA;IAC3E,CAAC;IAED;;OAEG;IACH,IAAW,WAAW;QACpB,OAAQ,IAAI,CAAC,WAAiD,CAAC,YAAY,CAAA;IAC7E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,eAAe,CAAC,OAAyB,IAAiB,CAAC;IAgHlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+DG;IACH,QAAQ,CACN,IAAyB,EACzB,2BAAwD;QAExD,MAAM,IAAI,KAAK,CACb,kDAAkD,IAAI,CAAC,QAAQ,EAAE,CAClE,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH,MAAM,CACJ,IAA6B,EAC7B,2BAAwD;QAExD,MAAM,IAAI,KAAK,CACb,gDAAgD,IAAI,CAAC,QAAQ,EAAE,CAChE,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6FG;IACH,gBAAgB,CACd,IAAyB,EACzB,2BAAwD;QAExD,MAAM,IAAI,KAAK,CACb,wDAAwD,IAAI,CAAC,QAAQ,EAAE,CACxE,CAAA;IACH,CAAC;CACF;AA5ZD,gEA4ZC"}

package/dist/auth/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./abstract-auth-provider";
+export * from "./token";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,SAAS,CAAA"}

package/dist/auth/index.js

@@ -0,0 +1,19 @@
+"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 __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 });
+__exportStar(require("./abstract-auth-provider"), exports);
+__exportStar(require("./token"), exports);
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAwC;AACxC,0CAAuB"}

package/dist/auth/token.d.ts

@@ -0,0 +1,7 @@
+import { type Secret, type SignOptions } from "jsonwebtoken";
+export declare const generateJwtToken: (tokenPayload: Record<string, unknown>, jwtConfig: {
+    secret?: Secret;
+    expiresIn?: number | string;
+    jwtOptions?: SignOptions;
+}) => string;
+//# sourceMappingURL=token.d.ts.map

package/dist/auth/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/auth/token.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAGjE,eAAO,MAAM,gBAAgB,GAC3B,cAAc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,WAAW;IACT,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,WAAW,CAAA;CACzB,WAiBF,CAAA"}

package/dist/auth/token.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateJwtToken = void 0;
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const common_1 = require("../common");
+const generateJwtToken = (tokenPayload, jwtConfig) => {
+    if (!jwtConfig.secret ||
+        (!jwtConfig.expiresIn && !jwtConfig.jwtOptions?.expiresIn)) {
+        throw new common_1.AcmeKitError(common_1.AcmeKitError.Types.INVALID_ARGUMENT, "JWT secret and expiresIn must be provided when generating a token");
+    }
+    const expiresIn = jwtConfig.expiresIn ?? jwtConfig.jwtOptions?.expiresIn;
+    return jsonwebtoken_1.default.sign(tokenPayload, jwtConfig.secret, {
+        ...jwtConfig.jwtOptions,
+        expiresIn,
+    });
+};
+exports.generateJwtToken = generateJwtToken;
+//# sourceMappingURL=token.js.map

package/dist/auth/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/auth/token.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAiE;AACjE,sCAAwC;AAEjC,MAAM,gBAAgB,GAAG,CAC9B,YAAqC,EACrC,SAIC,EACD,EAAE;IACF,IACE,CAAC,SAAS,CAAC,MAAM;QACjB,CAAC,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,EAC1D,CAAC;QACD,MAAM,IAAI,qBAAY,CACpB,qBAAY,CAAC,KAAK,CAAC,gBAAgB,EACnC,mEAAmE,CACpE,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,UAAU,EAAE,SAAS,CAAA;IACxE,OAAO,sBAAG,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE;QAC9C,GAAG,SAAS,CAAC,UAAU;QACvB,SAAS;KACV,CAAC,CAAA;AACJ,CAAC,CAAA;AAvBY,QAAA,gBAAgB,oBAuB5B"}

package/dist/bundles.d.ts

@@ -0,0 +1,24 @@
+export * as ApiKeyUtils from "./api-key";
+export * as CoreFlowsUitls from "./core-flows";
+export * as DALUtils from "./dal";
+export * as DefaultsUtils from "./defaults";
+export * as DMLUtils from "./dml";
+export * as EventBusUtils from "./event-bus";
+export * as FeatureFlagUtils from "./feature-flags";
+export * as FulfillmentUtils from "./fulfillment";
+export * as GraphQLUtils from "./graphql";
+export * as InventoryUtils from "./inventory";
+export * as LinkUtils from "./link";
+export * as ModulesSdkUtils from "./modules-sdk";
+export * as OrchestrationUtils from "./orchestration";
+export * as OrderUtils from "./order";
+export * as PricingUtils from "./pricing";
+export * as ProductUtils from "./product";
+export * as PromotionUtils from "./promotion";
+export * as SearchUtils from "./search";
+export * as ShippingProfileUtils from "./shipping";
+export * as UserUtils from "./user";
+export * as CachingUtils from "./caching";
+export * as TranslationsUtils from "./translations";
+export * as DevServerUtils from "./dev-server";
+//# sourceMappingURL=bundles.d.ts.map

package/dist/bundles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundles.d.ts","sourceRoot":"","sources":["../src/bundles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,cAAc,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,QAAQ,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,aAAa,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,aAAa,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,gBAAgB,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,gBAAgB,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,YAAY,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,cAAc,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,SAAS,MAAM,QAAQ,CAAA;AACnC,OAAO,KAAK,eAAe,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,kBAAkB,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,UAAU,MAAM,SAAS,CAAA;AACrC,OAAO,KAAK,YAAY,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,YAAY,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,cAAc,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,WAAW,MAAM,UAAU,CAAA;AACvC,OAAO,KAAK,oBAAoB,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,QAAQ,CAAA;AACnC,OAAO,KAAK,YAAY,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,iBAAiB,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,cAAc,MAAM,cAAc,CAAA"}

package/dist/bundles.js

@@ -0,0 +1,60 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevServerUtils = exports.TranslationsUtils = exports.CachingUtils = exports.UserUtils = exports.ShippingProfileUtils = exports.SearchUtils = exports.PromotionUtils = exports.ProductUtils = exports.PricingUtils = exports.OrderUtils = exports.OrchestrationUtils = exports.ModulesSdkUtils = exports.LinkUtils = exports.InventoryUtils = exports.GraphQLUtils = exports.FulfillmentUtils = exports.FeatureFlagUtils = exports.EventBusUtils = exports.DMLUtils = exports.DefaultsUtils = exports.DALUtils = exports.CoreFlowsUitls = exports.ApiKeyUtils = void 0;
+exports.ApiKeyUtils = __importStar(require("./api-key"));
+exports.CoreFlowsUitls = __importStar(require("./core-flows"));
+exports.DALUtils = __importStar(require("./dal"));
+exports.DefaultsUtils = __importStar(require("./defaults"));
+exports.DMLUtils = __importStar(require("./dml"));
+exports.EventBusUtils = __importStar(require("./event-bus"));
+exports.FeatureFlagUtils = __importStar(require("./feature-flags"));
+exports.FulfillmentUtils = __importStar(require("./fulfillment"));
+exports.GraphQLUtils = __importStar(require("./graphql"));
+exports.InventoryUtils = __importStar(require("./inventory"));
+exports.LinkUtils = __importStar(require("./link"));
+exports.ModulesSdkUtils = __importStar(require("./modules-sdk"));
+exports.OrchestrationUtils = __importStar(require("./orchestration"));
+exports.OrderUtils = __importStar(require("./order"));
+exports.PricingUtils = __importStar(require("./pricing"));
+exports.ProductUtils = __importStar(require("./product"));
+exports.PromotionUtils = __importStar(require("./promotion"));
+exports.SearchUtils = __importStar(require("./search"));
+exports.ShippingProfileUtils = __importStar(require("./shipping"));
+exports.UserUtils = __importStar(require("./user"));
+exports.CachingUtils = __importStar(require("./caching"));
+exports.TranslationsUtils = __importStar(require("./translations"));
+exports.DevServerUtils = __importStar(require("./dev-server"));
+//# sourceMappingURL=bundles.js.map

package/dist/bundles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundles.js","sourceRoot":"","sources":["../src/bundles.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAAwC;AACxC,+DAA8C;AAC9C,kDAAiC;AACjC,4DAA2C;AAC3C,kDAAiC;AACjC,6DAA4C;AAC5C,oEAAmD;AACnD,kEAAiD;AACjD,0DAAyC;AACzC,8DAA6C;AAC7C,oDAAmC;AACnC,iEAAgD;AAChD,sEAAqD;AACrD,sDAAqC;AACrC,0DAAyC;AACzC,0DAAyC;AACzC,8DAA6C;AAC7C,wDAAuC;AACvC,mEAAkD;AAClD,oDAAmC;AACnC,0DAAyC;AACzC,oEAAmD;AACnD,+DAA8C"}

package/dist/caching/index.d.ts

@@ -0,0 +1,59 @@
+import { ICachingModuleService, AcmeKitContainer } from "@acmekit/types";
+/**
+ * This function is used to cache the result of a function call.
+ *
+ * @param cb - The callback to execute.
+ * @param options - The options for the cache.
+ * @returns The result of the callback.
+ */
+export declare function useCache<T>(cb: (...args: any[]) => Promise<T>, options: {
+    enable?: boolean;
+    key: string | any[];
+    tags?: string[];
+    ttl?: number;
+    /**
+     * Whethere the default strategy should auto invalidate the cache whenever it is possible.
+     */
+    autoInvalidate?: boolean;
+    providers?: string[];
+    container: AcmeKitContainer;
+}): Promise<T>;
+type TargetMethodArgs<Target, PropertyKey> = Target[PropertyKey & keyof Target] extends (...args: any[]) => any ? Parameters<Target[PropertyKey & keyof Target]> : never;
+/**
+ * This function is used to cache the result of a method call.
+ *
+ * @param options - The options for the cache.
+ * @returns The original method with the cache applied.
+ */
+export declare function Cached<const Target extends object, const PropertyKey extends keyof Target>(options: {
+    /**
+     * The key to use for the cache.
+     * If a function is provided, it will be called with the arguments as the first argument and the
+     * container as the second argument.
+     */
+    key?: string | ((args: TargetMethodArgs<Target, PropertyKey>, cachingModule: ICachingModuleService) => string | Promise<string> | Promise<any[]> | any[]);
+    /**
+     * Whether to enable the cache. This is only useful if you want to enable without providing any
+     * other options.
+     */
+    enable?: boolean | ((args: TargetMethodArgs<Target, PropertyKey>) => boolean | undefined);
+    /**
+     * The tags to use for the cache.
+     */
+    tags?: string[] | ((args: TargetMethodArgs<Target, PropertyKey>) => string[] | undefined);
+    /**
+     * The time-to-live (TTL) value in seconds.
+     */
+    ttl?: number | ((args: TargetMethodArgs<Target, PropertyKey>) => number | undefined);
+    /**
+     * Whether to auto invalidate the cache whenever it is possible.
+     */
+    autoInvalidate?: boolean | ((args: TargetMethodArgs<Target, PropertyKey>) => boolean | undefined);
+    /**
+     * The providers to use for the cache.
+     */
+    providers?: string[] | ((args: TargetMethodArgs<Target, PropertyKey>) => string[] | undefined);
+    container: AcmeKitContainer | ((this: Target) => AcmeKitContainer);
+}): (target: Target, propertyKey: PropertyKey, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/caching/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAU,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAKhF;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,gBAAgB,CAAA;CAC5B,GACA,OAAO,CAAC,CAAC,CAAC,CAuDZ;AAED,KAAK,gBAAgB,CAAC,MAAM,EAAE,WAAW,IAAI,MAAM,CAAC,WAAW,GAC7D,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAC3C,UAAU,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,MAAM,CAAC,CAAC,GAC9C,KAAK,CAAA;AAET;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,KAAK,CAAC,MAAM,SAAS,MAAM,EAC3B,KAAK,CAAC,WAAW,SAAS,MAAM,MAAM,EACtC,OAAO,EAAE;IACT;;;;OAIG;IACH,GAAG,CAAC,EACA,MAAM,GACN,CAAC,CACC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,EAC3C,aAAa,EAAE,qBAAqB,KACjC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CAAA;IAC3D;;;OAGG;IACH,MAAM,CAAC,EACH,OAAO,GACP,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,OAAO,GAAG,SAAS,CAAC,CAAA;IAC1E;;OAEG;IACH,IAAI,CAAC,EACD,MAAM,EAAE,GACR,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IAC3E;;OAEG;IACH,GAAG,CAAC,EACA,MAAM,GACN,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC,CAAA;IACzE;;OAEG;IACH,cAAc,CAAC,EACX,OAAO,GACP,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,OAAO,GAAG,SAAS,CAAC,CAAA;IAC1E;;OAEG;IACH,SAAS,CAAC,EACN,MAAM,EAAE,GACR,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IAE3E,SAAS,EAAE,gBAAgB,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAC,CAAA;CACnE,IAEG,QAAQ,MAAM,EACd,aAAa,WAAW,EACxB,YAAY,kBAAkB,wBAsGjC"}