@codeleap/debug 7.0.0 → 7.0.2

package/dist/EnvironmentManager/class.js

@@ -0,0 +1,137 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentManager = void 0;
+const store_1 = require("@codeleap/store");
+const types_1 = require("@codeleap/types");
+const utils_1 = require("@codeleap/utils");
+const react_1 = require("react");
+const const_1 = require("./const");
+/**
+ * Runtime switchboard for backend environments in debug builds.
+ *
+ * The override is opt-in: until `setEnabled` is called the manager always
+ * returns `defaultEnvironment`, making it safe to instantiate unconditionally.
+ * State is persisted via `@codeleap/store` `globalState` so it survives page
+ * reloads, but the `enabledBy` flag gates whether that persisted state is
+ * actually honoured.
+ *
+ * When the active environment is `customEnvironment`, `serverUrl` validates the
+ * stored URL against a strict regex and falls back to `defaultEnvironment` if
+ * it fails — callers can rely on `serverUrl` always returning a usable value.
+ */
+class EnvironmentManager {
+    get environments() {
+        return this.config.environments;
+    }
+    get defaultConfig() {
+        return {
+            environment: this.config.defaultEnvironment,
+            customUrl: '',
+            enabledBy: null,
+        };
+    }
+    constructor(config) {
+        var _a;
+        this.config = config;
+        this.editors = const_1.EDITORS;
+        this.store = (0, store_1.globalState)(this.defaultConfig, { persistKey: (_a = config === null || config === void 0 ? void 0 : config.persistKey) !== null && _a !== void 0 ? _a : 'environment-manager' });
+        this.initialStoreValue = this.store.get();
+    }
+    testUrl(url) {
+        if (!url)
+            return false;
+        const urlValidator = /^https?:\/\/([a-zA-Z0-9.-]+|localhost|(\d{1,3}\.){3}\d{1,3})(?::\d+)?\/$/;
+        return urlValidator.test(url);
+    }
+    get env() {
+        var _a;
+        const value = (_a = this.store.get()) !== null && _a !== void 0 ? _a : this.defaultConfig;
+        if (value.enabledBy) {
+            if (value.environment === this.config.customEnvironment && !this.testUrl(value.customUrl)) {
+                value.environment = this.defaultConfig.environment;
+            }
+            return value;
+        }
+        return this.defaultConfig;
+    }
+    setEnabled(by = false) {
+        const disable = by === false || types_1.TypeGuards.isNil(by);
+        this.store.set({ enabledBy: disable ? null : by });
+        return !disable;
+    }
+    get isEnabled() {
+        return !types_1.TypeGuards.isNil(this.isEnabledBy);
+    }
+    get isEnabledBy() {
+        return this.store.get(s => s === null || s === void 0 ? void 0 : s.enabledBy);
+    }
+    get isEnabledBySystem() {
+        return this.isEnabledBy === const_1.EDITORS.SYSTEM;
+    }
+    get isEnabledByUser() {
+        return this.isEnabledBy === const_1.EDITORS.USER;
+    }
+    get is() {
+        const environment = this.store.get(s => { var _a; return (_a = s === null || s === void 0 ? void 0 : s.environment) !== null && _a !== void 0 ? _a : this.defaultConfig.environment; });
+        return Object.entries(this.environments).reduce((acc, [key, value]) => {
+            acc[(0, utils_1.capitalize)(key)] = environment === key;
+            return acc;
+        }, {});
+    }
+    get serverUrl() {
+        var _a;
+        const env = this.env;
+        if (env.environment === this.config.customEnvironment) {
+            if (!this.testUrl(env.customUrl)) {
+                return this.environments[this.defaultConfig.environment];
+            }
+            return env.customUrl;
+        }
+        return (_a = this.environments[env.environment]) !== null && _a !== void 0 ? _a : this.environments[this.defaultConfig.environment];
+    }
+    setEnvironment(environment) {
+        if (!this.isEnabled)
+            return;
+        this.store.set({ environment });
+    }
+    isEnvironment(env) {
+        const current = this.env;
+        return current.environment === env;
+    }
+    setCustomUrl(url) {
+        if (!url.endsWith('/')) {
+            url += '/';
+        }
+        if (!this.testUrl(url))
+            return;
+        this.store.set({ customUrl: url });
+    }
+    use() {
+        const value = this.store.use();
+        const _a = value !== null && value !== void 0 ? value : this.defaultConfig, { enabledBy } = _a, config = __rest(_a, ["enabledBy"]);
+        const [customUrl, setCustomUrl] = (0, react_1.useState)(config === null || config === void 0 ? void 0 : config.customUrl);
+        const changed = (0, react_1.useMemo)(() => !(0, utils_1.deepEqual)(value, this.initialStoreValue), [value]);
+        return {
+            enabled: !!enabledBy,
+            enabledByUser: enabledBy === const_1.EDITORS.USER,
+            enabledBySystem: enabledBy === const_1.EDITORS.SYSTEM,
+            config,
+            changed,
+            customUrl,
+            setCustomUrl,
+        };
+    }
+}
+exports.EnvironmentManager = EnvironmentManager;
+//# sourceMappingURL=class.js.map

package/dist/EnvironmentManager/class.js.map

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

package/dist/EnvironmentManager/const.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDITORS = void 0;
+/**
+ * Identifies who enabled the environment override — the application itself
+ * (`SYSTEM`) or an end user via a debug UI (`USER`). Used to gate which
+ * controls are exposed and whether the override survives a session reset.
+ */
+exports.EDITORS = {
+    SYSTEM: 'system',
+    USER: 'user',
+};
+//# sourceMappingURL=const.js.map

package/dist/EnvironmentManager/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../src/EnvironmentManager/const.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,OAAO,GAAG;IACrB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAA"}

package/dist/EnvironmentManager/factor.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEnvironmentManager = createEnvironmentManager;
+const class_1 = require("./class");
+/**
+ * Preferred entry point for instantiating an `EnvironmentManager`.
+ * Keeps call-sites free of the generic `new` syntax and makes the config
+ * shape the only public API surface that needs to be imported.
+ */
+function createEnvironmentManager(config) {
+    return new class_1.EnvironmentManager(config);
+}
+//# sourceMappingURL=factor.js.map

package/dist/EnvironmentManager/factor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factor.js","sourceRoot":"","sources":["../../src/EnvironmentManager/factor.ts"],"names":[],"mappings":";;AASA,4DAEC;AAVD,mCAA4C;AAG5C;;;;GAIG;AACH,SAAgB,wBAAwB,CAAyB,MAAmC;IAClG,OAAO,IAAI,0BAAkB,CAAI,MAAM,CAAC,CAAA;AAC1C,CAAC"}

package/dist/EnvironmentManager/index.js

@@ -0,0 +1,20 @@
+"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("./factor"), exports);
+__exportStar(require("./class"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/EnvironmentManager/index.js.map

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

package/dist/EnvironmentManager/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/EnvironmentManager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/EnvironmentManager/types.ts"],"names":[],"mappings":""}

package/dist/FakeRestApi/class.js

@@ -0,0 +1,217 @@
+"use strict";
+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.FakeRestApi = void 0;
+/**
+ * A fake REST API implementation for testing and prototyping.
+ * Provides CRUD operations with pagination support and optional request delays.
+ * @template T - The type of items to manage, must extend FakeItem
+ * @template F - The type of filters to apply when listing items
+ */
+class FakeRestApi {
+    /**
+     * Gets the ID of the last item in the data array.
+     * @private
+     * @returns The highest ID or 0 if no items exist
+     */
+    get lastId() {
+        return this.data.length > 0 ? Math.max(...this.data.map((i) => i.id)) : 0;
+    }
+    /**
+     * Gets the name of the API.
+     * @returns The API name
+     */
+    get name() {
+        return this.options.name;
+    }
+    /**
+     * Gets the current count of items.
+     * @returns The number of items in the data array
+     */
+    get count() {
+        return this.data.length;
+    }
+    /**
+     * Creates a new FakeRestApi instance.
+     * @param options - Configuration options for the API
+     */
+    constructor(options) {
+        this.data = [];
+        this.options = Object.assign({ delayMs: 2500, maxCount: 100, enableDelay: false, filterFn: () => true }, options);
+        this.initialize();
+    }
+    /**
+     * Initializes the data array with items up to maxCount.
+     * @private
+     */
+    initialize() {
+        this.data = Array.from({ length: this.options.maxCount }, (_, i) => this.generateItem(i + 1));
+    }
+    /**
+     * Updates the API options partially.
+     * @param newOptions - Partial options to update
+     */
+    setOptions(newOptions) {
+        this.options = Object.assign(Object.assign({}, this.options), newOptions);
+    }
+    /**
+     * Generates a new item using the generator function.
+     * @param id - The ID for the new item (defaults to lastId + 1)
+     * @returns A newly generated item
+     */
+    generateItem(id = this.lastId + 1) {
+        return this.options.generatorFn(id);
+    }
+    /**
+     * Introduces an artificial delay if enabled in options.
+     * @private
+     * @returns A promise that resolves after the delay period
+     */
+    delay() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.options.enableDelay)
+                return;
+            return new Promise((resolve) => {
+                setTimeout(resolve, this.options.delayMs);
+            });
+        });
+    }
+    /**
+     * Builds a URL with pagination parameters.
+     * @private
+     * @param limit - Number of items per page
+     * @param offset - Starting position
+     * @returns A formatted URL string
+     */
+    buildUrl(limit, offset) {
+        return `https://api.${this.name}?limit=${limit}&offset=${offset}`;
+    }
+    /**
+     * Retrieves a paginated list of items with optional filtering.
+     * @param limit - Number of items to return (default: 10)
+     * @param offset - Starting position (default: 0)
+     * @param filters - Optional filters to apply
+     * @returns A promise that resolves to a paginated response
+     */
+    listItems() {
+        return __awaiter(this, arguments, void 0, function* (limit = 10, offset = 0, filters) {
+            yield this.delay();
+            const hasFilters = filters && Object.keys(filters).length > 0;
+            const items = hasFilters
+                ? this.data.filter((item) => this.options.filterFn(item, filters))
+                : this.data;
+            const total = items.length;
+            const start = Math.max(0, offset);
+            const end = Math.min(start + limit, total);
+            const results = items.slice(start, end);
+            return {
+                count: total,
+                next: end < total ? this.buildUrl(limit, end) : null,
+                previous: start > 0 ? this.buildUrl(limit, Math.max(0, start - limit)) : null,
+                results,
+            };
+        });
+    }
+    /**
+     * Retrieves a single item by ID.
+     * @param id - The ID of the item to retrieve
+     * @returns A promise that resolves to the requested item
+     * @throws {Error} If the item is not found
+     */
+    retrieveItem(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.delay();
+            const item = this.data.find((i) => i.id === id);
+            if (!item) {
+                throw new Error(`${this.name} with id ${id} not found`);
+            }
+            return item;
+        });
+    }
+    /**
+     * Creates a new item and adds it to the data array.
+     * @param item - Optional partial item data (ID will be auto-generated)
+     * @returns A promise that resolves to the created item
+     */
+    createItem(item) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.delay();
+            const id = this.lastId + 1;
+            const newItem = item ? Object.assign(Object.assign({}, item), { id }) : this.generateItem(id);
+            this.data.push(newItem);
+            return newItem;
+        });
+    }
+    /**
+     * Updates an existing item by ID.
+     * @param id - The ID of the item to update
+     * @param updates - Partial item data to update
+     * @returns A promise that resolves to the updated item
+     * @throws {Error} If the item is not found
+     */
+    updateItem(id, updates) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.delay();
+            const index = this.data.findIndex((i) => i.id === id);
+            if (index === -1) {
+                throw new Error(`${this.name} with id ${id} not found`);
+            }
+            this.data[index] = Object.assign(Object.assign(Object.assign({}, this.data[index]), updates), { id });
+            return this.data[index];
+        });
+    }
+    /**
+     * Deletes an item by ID.
+     * @param id - The ID of the item to delete
+     * @returns A promise that resolves to the deleted item
+     * @throws {Error} If the item is not found
+     */
+    deleteItem(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.delay();
+            const index = this.data.findIndex((i) => i.id === id);
+            if (index === -1) {
+                throw new Error(`${this.name} with id ${id} not found`);
+            }
+            const [deleted] = this.data.splice(index, 1);
+            return deleted;
+        });
+    }
+    /**
+     * Resets the data array to its initial state by regenerating all items.
+     */
+    reset() {
+        this.initialize();
+    }
+    /**
+     * Clears all items from the data array.
+     */
+    clear() {
+        this.data = [];
+    }
+    /**
+     * Gets a readonly copy of all items in the data array.
+     * @returns A frozen array of all items
+     */
+    getData() {
+        return Object.freeze([...this.data]);
+    }
+    /**
+     * Gets a single item by ID without delay.
+     * @param id - The ID of the item to retrieve
+     * @returns The item if found, undefined otherwise
+     */
+    getItem(id) {
+        return this.data.find((i) => i.id === id);
+    }
+}
+exports.FakeRestApi = FakeRestApi;
+//# sourceMappingURL=class.js.map

package/dist/FakeRestApi/class.js.map

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

package/dist/FakeRestApi/factor.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFakeRestApi = createFakeRestApi;
+const class_1 = require("./class");
+/**
+ * Factory function to create a new FakeRestApi instance.
+ * @template T - The type of items to manage, must extend FakeItem
+ * @template F - The type of filters to apply when listing items
+ * @param options - Configuration options for the API
+ * @returns A new FakeRestApi instance
+ * @example
+ * ```typescript
+ * type User = { id: number; name: string; email: string }
+ *
+ * const api = createFakeRestApi<User>({
+ *   name: 'users',
+ *   maxCount: 50,
+ *   generatorFn: (id) => ({
+ *     id,
+ *     name: `User ${id}`,
+ *     email: `user${id}@example.com`
+ *   })
+ * })
+ * ```
+ */
+function createFakeRestApi(options) {
+    return new class_1.FakeRestApi(options);
+}
+//# sourceMappingURL=factor.js.map

package/dist/FakeRestApi/factor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factor.js","sourceRoot":"","sources":["../../src/FakeRestApi/factor.ts"],"names":[],"mappings":";;AAwBA,8CAIC;AA5BD,mCAAqC;AAGrC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,iBAAiB,CAC/B,OAAiC;IAEjC,OAAO,IAAI,mBAAW,CAAO,OAAO,CAAC,CAAA;AACvC,CAAC"}

package/dist/FakeRestApi/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("./factor"), exports);
+__exportStar(require("./class"), exports);
+//# sourceMappingURL=index.js.map

package/dist/FakeRestApi/index.js.map

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

package/dist/FakeRestApi/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/FakeRestApi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/FakeRestApi/types.ts"],"names":[],"mappings":""}

package/dist/faker.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.faker = void 0;
+const names = [
+    'James', 'John', 'Robert', 'Michael', 'William', 'David', 'Richard', 'Joseph', 'Thomas',
+    'Charles', 'Christopher', 'Daniel', 'Matthew', 'Anthony', 'Donald', 'Mark', 'Paul', 'Steven',
+    'Andrew', 'Kenneth', 'Joshua', 'Kevin', 'Brian', 'George', 'Edward', 'Ronald', 'Timothy',
+    'Jason', 'Jeffrey', 'Ryan', 'Gary', 'Jacob'
+];
+const surnames = [
+    'Smith', 'Johnson', 'Williams', 'Brown', 'Jones', 'Garcia', 'Miller', 'Davis',
+    'Lopez', 'Wilson', 'Anderson', 'Thomas', 'Taylor', 'Moore',
+    'Jackson', 'Martin', 'Lee', 'Perez', 'Thompson', 'White', 'Harris', 'Sanchez', 'Clark',
+    'Ramirez', 'Lewis', 'Robinson', 'Walker', 'Young', 'Allen', 'King', 'Wright', 'Scott', 'Torres',
+];
+const animals = [
+    'lion', 'tiger', 'zebra', 'panda', 'koala', 'bear',
+    'wolf', 'fox', 'rabbit', 'bat', 'spider', 'frog', 'shark'
+];
+function getRandom(list) {
+    return list[Math.floor(Math.random() * list.length)];
+}
+function number(min = 0, max = 100) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+/**
+ * Lightweight fixture-data helper for tests and Storybook stories.
+ * All string generators draw from fixed lists, so output is deterministic
+ * in terms of domain (real-looking names/animals) but random in selection —
+ * not suitable as a seed-based reproducible faker. Use `number(min, max)`
+ * for bounded integers.
+ */
+exports.faker = {
+    lastName: () => getRandom(surnames),
+    firstName: () => getRandom(names),
+    animal: () => getRandom(animals),
+    number,
+    name: () => `${getRandom(names)} ${getRandom(surnames)}`
+};
+//# sourceMappingURL=faker.js.map

package/dist/faker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faker.js","sourceRoot":"","sources":["../src/faker.ts"],"names":[],"mappings":";;;AAAA,MAAM,KAAK,GAAG;IACZ,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ;IACvF,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;IAC5F,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS;IACxF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;CAC5C,CAAA;AAED,MAAM,QAAQ,GAAG;IACf,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;IAC7E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;IAC1D,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO;IACtF,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ;CAChG,CAAA;AAED,MAAM,OAAO,GAAG;IACd,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IAClD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO;CAC1D,CAAA;AAED,SAAS,SAAS,CAAC,IAAmB;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,CAAC,EAAE,MAAc,GAAG;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AAC1D,CAAC;AAED;;;;;;GAMG;AACU,QAAA,KAAK,GAAG;IACnB,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;IACnC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;IACjC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC;IAChC,MAAM;IACN,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE;CACzD,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"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("./FakeRestApi"), exports);
+__exportStar(require("./EnvironmentManager"), exports);
+__exportStar(require("./faker"), 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,gDAA6B;AAC7B,uDAAoC;AACpC,0CAAuB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codeleap/debug",
-  "version": "7.0.0",
-  "main": "src/index.ts",
+  "version": "7.0.2",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
@@ -22,10 +22,10 @@
     "directory": "packages/debug"
   },
   "devDependencies": {
-    "@codeleap/config": "7.0.0",
-    "@codeleap/store": "7.0.0",
-    "@codeleap/types": "7.0.0",
-    "@codeleap/utils": "7.0.0",
+    "@codeleap/config": "7.0.1",
+    "@codeleap/store": "7.0.1",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/utils": "7.0.1",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {
@@ -34,9 +34,9 @@
   },
   "peerDependencies": {
     "typescript": "5.5.2",
-    "@codeleap/config": "7.0.0",
-    "@codeleap/store": "7.0.0",
-    "@codeleap/types": "7.0.0",
-    "@codeleap/utils": "7.0.0"
+    "@codeleap/config": "7.0.1",
+    "@codeleap/store": "7.0.1",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/utils": "7.0.1"
   }
 }