@webiny/feature 0.0.0-unstable.61c048f412

package/Brand.d.ts

@@ -0,0 +1,5 @@
+declare const brand: unique symbol;
+export type Brand<T, B extends string> = T & {
+    [brand]: B;
+};
+export {};

package/Brand.js

@@ -0,0 +1,3 @@
+export {};
+
+//# sourceMappingURL=Brand.js.map

package/Brand.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["Brand.ts"],"sourcesContent":["declare const brand: unique symbol;\n\nexport type Brand<T, B extends string> = T & { [brand]: B };\n"],"mappings":"","ignoreList":[]}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Webiny
+
+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/README.md

@@ -0,0 +1,11 @@
+# @webiny/feature
+
+> [!NOTE]
+> This package is part of the [Webiny](https://www.webiny.com) monorepo.
+> It’s **included in every Webiny project by default** and is not meant to be used as a standalone package.
+
+📘 **Documentation:** [https://www.webiny.com/docs](https://www.webiny.com/docs)
+
+---
+
+_This README file is automatically generated during the publish process._

package/admin/BaseError.d.ts

@@ -0,0 +1,19 @@
+export interface IErrorOptions {
+    stack?: string;
+}
+type ErrorDataWithOptionalData<TData> = TData extends void ? {
+    message: string;
+    data?: never;
+} : {
+    message: string;
+    data: TData;
+};
+export declare abstract class BaseError<TData = void> extends Error {
+    abstract readonly code: string;
+    readonly data: TData extends void ? undefined : TData;
+    protected constructor(input: ErrorDataWithOptionalData<TData>, options?: IErrorOptions);
+}
+export declare namespace BaseError {
+    type ErrorOptions = IErrorOptions;
+}
+export {};

package/admin/BaseError.js

@@ -0,0 +1,9 @@
+export class BaseError extends Error {
+  constructor(input, options) {
+    super(input.message);
+    this.stack = options?.stack;
+    this.data = input.data;
+  }
+}
+
+//# sourceMappingURL=BaseError.js.map

package/admin/BaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BaseError","Error","constructor","input","options","message","stack","data"],"sources":["BaseError.ts"],"sourcesContent":["export interface IErrorOptions {\n    stack?: string;\n}\n\ntype ErrorDataWithOptionalData<TData> = TData extends void\n    ? { message: string; data?: never }\n    : { message: string; data: TData };\n\nexport abstract class BaseError<TData = void> extends Error {\n    public abstract readonly code: string;\n    public readonly data: TData extends void ? undefined : TData;\n\n    protected constructor(input: ErrorDataWithOptionalData<TData>, options?: IErrorOptions) {\n        super(input.message);\n        this.stack = options?.stack;\n        this.data = input.data as any;\n    }\n}\n\nexport namespace BaseError {\n    export type ErrorOptions = IErrorOptions;\n}\n"],"mappings":"AAQA,OAAO,MAAeA,SAAS,SAAuBC,KAAK,CAAC;EAI9CC,WAAWA,CAACC,KAAuC,EAAEC,OAAuB,EAAE;IACpF,KAAK,CAACD,KAAK,CAACE,OAAO,CAAC;IACpB,IAAI,CAACC,KAAK,GAAGF,OAAO,EAAEE,KAAK;IAC3B,IAAI,CAACC,IAAI,GAAGJ,KAAK,CAACI,IAAW;EACjC;AACJ","ignoreList":[]}

package/admin/createFeature.d.ts

@@ -0,0 +1,11 @@
+import { Container } from "@webiny/di";
+export interface FeatureDefinition<TExports = any, TParams extends any[] = []> {
+    name: string;
+    register: (container: Container, ...args: TParams) => void;
+    resolve: (container: Container) => TExports;
+}
+export declare function createFeature<TExports = any, TParams extends any[] = []>(def: {
+    name: string;
+    register: (container: Container, ...args: TParams) => void;
+    resolve?: (container: Container) => TExports;
+}): FeatureDefinition<TExports, TParams>;

package/admin/createFeature.js

@@ -0,0 +1,11 @@
+export function createFeature(def) {
+  return {
+    name: def.name,
+    register: def.register,
+    resolve: container => {
+      return def.resolve ? def.resolve(container) : undefined;
+    }
+  };
+}
+
+//# sourceMappingURL=createFeature.js.map

package/admin/createFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createFeature","def","name","register","resolve","container","undefined"],"sources":["createFeature.ts"],"sourcesContent":["import { Container } from \"@webiny/di\";\n\nexport interface FeatureDefinition<TExports = any, TParams extends any[] = []> {\n    name: string;\n    register: (container: Container, ...args: TParams) => void;\n    resolve: (container: Container) => TExports;\n}\n\nexport function createFeature<\n    TExports = any,\n    TParams extends any[] = [] // tuple for extra args\n>(def: {\n    name: string;\n    register: (container: Container, ...args: TParams) => void;\n    resolve?: (container: Container) => TExports;\n}): FeatureDefinition<TExports, TParams> {\n    return {\n        name: def.name,\n        register: def.register,\n        resolve: (container: Container): TExports => {\n            return (def.resolve ? def.resolve(container) : undefined) as TExports;\n        }\n    };\n}\n"],"mappings":"AAQA,OAAO,SAASA,aAAaA,CAG3BC,GAID,EAAwC;EACrC,OAAO;IACHC,IAAI,EAAED,GAAG,CAACC,IAAI;IACdC,QAAQ,EAAEF,GAAG,CAACE,QAAQ;IACtBC,OAAO,EAAGC,SAAoB,IAAe;MACzC,OAAQJ,GAAG,CAACG,OAAO,GAAGH,GAAG,CAACG,OAAO,CAACC,SAAS,CAAC,GAAGC,SAAS;IAC5D;EACJ,CAAC;AACL","ignoreList":[]}

package/admin/index.d.ts

@@ -0,0 +1,5 @@
+export { createDecorator, createImplementation } from "@webiny/di";
+export { createFeature } from "./createFeature.js";
+export type { FeatureDefinition } from "./createFeature.js";
+export { BaseError } from "./BaseError.js";
+export { createAbstraction } from "../createAbstraction.js";

package/admin/index.js

@@ -0,0 +1,6 @@
+export { createDecorator, createImplementation } from "@webiny/di";
+export { createFeature } from "./createFeature.js";
+export { BaseError } from "./BaseError.js";
+export { createAbstraction } from "../createAbstraction.js";
+
+//# sourceMappingURL=index.js.map

package/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createDecorator","createImplementation","createFeature","BaseError","createAbstraction"],"sources":["index.ts"],"sourcesContent":["export { createDecorator, createImplementation } from \"@webiny/di\";\nexport { createFeature } from \"./createFeature.js\";\nexport type { FeatureDefinition } from \"./createFeature.js\";\nexport { BaseError } from \"./BaseError.js\";\nexport { createAbstraction } from \"../createAbstraction.js\";\n"],"mappings":"AAAA,SAASA,eAAe,EAAEC,oBAAoB,QAAQ,YAAY;AAClE,SAASC,aAAa;AAEtB,SAASC,SAAS;AAClB,SAASC,iBAAiB","ignoreList":[]}

package/api/BaseError.d.ts

@@ -0,0 +1,16 @@
+export interface ErrorOptions {
+    stack?: string;
+}
+type ErrorDataWithOptionalData<TData> = TData extends void ? {
+    message: string;
+    data?: never;
+} : {
+    message: string;
+    data: TData;
+};
+export declare abstract class BaseError<TData = void> extends Error {
+    abstract readonly code: string;
+    readonly data: TData extends void ? undefined : TData;
+    protected constructor(input: ErrorDataWithOptionalData<TData>, options?: ErrorOptions);
+}
+export {};

package/api/BaseError.js

@@ -0,0 +1,9 @@
+export class BaseError extends Error {
+  constructor(input, options) {
+    super(input.message);
+    this.stack = options?.stack;
+    this.data = input.data;
+  }
+}
+
+//# sourceMappingURL=BaseError.js.map

package/api/BaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BaseError","Error","constructor","input","options","message","stack","data"],"sources":["BaseError.ts"],"sourcesContent":["export interface ErrorOptions {\n    stack?: string;\n}\n\ntype ErrorDataWithOptionalData<TData> = TData extends void\n    ? { message: string; data?: never }\n    : { message: string; data: TData };\n\nexport abstract class BaseError<TData = void> extends Error {\n    public abstract readonly code: string;\n    public readonly data: TData extends void ? undefined : TData;\n\n    protected constructor(input: ErrorDataWithOptionalData<TData>, options?: ErrorOptions) {\n        super(input.message);\n        this.stack = options?.stack;\n        this.data = input.data as any;\n    }\n}\n"],"mappings":"AAQA,OAAO,MAAeA,SAAS,SAAuBC,KAAK,CAAC;EAI9CC,WAAWA,CAACC,KAAuC,EAAEC,OAAsB,EAAE;IACnF,KAAK,CAACD,KAAK,CAACE,OAAO,CAAC;IACpB,IAAI,CAACC,KAAK,GAAGF,OAAO,EAAEE,KAAK;IAC3B,IAAI,CAACC,IAAI,GAAGJ,KAAK,CAACI,IAAW;EACjC;AACJ","ignoreList":[]}

package/api/Result.d.ts

@@ -0,0 +1,102 @@
+/**
+ * A container type that represents either a successful result (`ok`) or a failure (`fail`).
+ * Inspired by functional programming constructs like `Either` or `Result` in other languages.
+ *
+ * @template TValue - The type of the success value.
+ * @template TError - The type of the error value.
+ */
+export declare class Result<TValue, TError = never> {
+    protected readonly _isOk: boolean;
+    protected readonly _value?: TValue;
+    protected readonly _error?: TError;
+    private constructor();
+    /**
+     * Creates a successful `Result` containing the provided value.
+     * If no value is provided, returns Result<void, never>.
+     *
+     * @param value - The value to wrap in a successful result (optional).
+     * @returns A `Result` instance with the value.
+     */
+    static ok<T>(value: T): Result<T, never>;
+    static ok(): Result<void, never>;
+    /**
+     * Creates a failed `Result` containing the provided error.
+     *
+     * @param error - The error to wrap in a failed result.
+     * @returns A `Result` instance with the error.
+     */
+    static fail<E>(error: E): Result<never, E>;
+    /**
+     * Checks whether the result is successful.
+     *
+     * @returns `true` if the result is `ok`, otherwise `false`.
+     *          Acts as a type guard to narrow the type to a successful result.
+     */
+    isOk(): this is {
+        _value: TValue;
+    } & Result<TValue, TError>;
+    /**
+     * Checks whether the result is a failure.
+     *
+     * @returns `true` if the result is `fail`, otherwise `false`.
+     *          Acts as a type guard to narrow the type to a failed result.
+     */
+    isFail(): this is {
+        _error: TError;
+    } & Result<TValue, TError>;
+    /**
+     * Gets the value inside a successful result.
+     *
+     * @throws If the result is a failure.
+     * @returns The success value.
+     */
+    get value(): TValue;
+    /**
+     * Gets the error inside a failed result.
+     *
+     * @throws If the result is successful.
+     * @returns The error value.
+     */
+    get error(): TError;
+    /**
+     * Transforms the success value using the provided mapping function.
+     *
+     * @template U - The type of the new success value.
+     * @param fn - Function to apply to the value if the result is successful.
+     * @returns A new `Result` containing the mapped value, or the original error if failed.
+     */
+    map<U>(fn: (value: TValue) => U): Result<U, TError>;
+    /**
+     * Transforms the error value using the provided mapping function.
+     *
+     * @template F - The type of the new error.
+     * @param fn - Function to apply to the error if the result is a failure.
+     * @returns A new `Result` containing the original value or the mapped error.
+     */
+    mapError<F>(fn: (error: TError) => F): Result<TValue, F>;
+    /**
+     * Chains another `Result`-producing function onto this result.
+     * If this result is successful, the function is applied to the value.
+     * If this result is a failure, the original error is returned.
+     *
+     * @template U - The type of the next success value.
+     * @param fn - A function that takes the current value and returns another `Result`.
+     * @returns A new `Result` from applying the function or the original failure.
+     */
+    flatMap<U>(fn: (value: TValue) => Result<U, TError>): Result<U, TError>;
+    /**
+     * Pattern-matches the result to handle both success and failure cases.
+     *
+     * @template U - The return type of both match functions.
+     * @param handlers - An object containing `ok` and `fail` handlers.
+     * @returns The return value from the corresponding handler.
+     */
+    match<U>(handlers: {
+        ok: (value: TValue) => U;
+        fail: (error: TError) => U;
+    }): U;
+}
+export declare namespace Result {
+    type UnwrapResult<T> = Awaited<T> extends Result<infer Ok, any> ? Ok : never;
+    type UnwrapError<T> = Awaited<T> extends Result<any, infer Err> ? Err : never;
+}

package/api/Result.js

@@ -0,0 +1,143 @@
+/**
+ * A container type that represents either a successful result (`ok`) or a failure (`fail`).
+ * Inspired by functional programming constructs like `Either` or `Result` in other languages.
+ *
+ * @template TValue - The type of the success value.
+ * @template TError - The type of the error value.
+ */
+export class Result {
+  constructor(isOk, value, error) {
+    this._isOk = isOk;
+    this._value = value;
+    this._error = error;
+  }
+
+  /**
+   * Creates a successful `Result` containing the provided value.
+   * If no value is provided, returns Result<void, never>.
+   *
+   * @param value - The value to wrap in a successful result (optional).
+   * @returns A `Result` instance with the value.
+   */
+
+  static ok(value) {
+    return new Result(true, value);
+  }
+
+  /**
+   * Creates a failed `Result` containing the provided error.
+   *
+   * @param error - The error to wrap in a failed result.
+   * @returns A `Result` instance with the error.
+   */
+  static fail(error) {
+    return new Result(false, undefined, error);
+  }
+
+  /**
+   * Checks whether the result is successful.
+   *
+   * @returns `true` if the result is `ok`, otherwise `false`.
+   *          Acts as a type guard to narrow the type to a successful result.
+   */
+  isOk() {
+    return this._isOk;
+  }
+
+  /**
+   * Checks whether the result is a failure.
+   *
+   * @returns `true` if the result is `fail`, otherwise `false`.
+   *          Acts as a type guard to narrow the type to a failed result.
+   */
+  isFail() {
+    return !this._isOk;
+  }
+
+  /**
+   * Gets the value inside a successful result.
+   *
+   * @throws If the result is a failure.
+   * @returns The success value.
+   */
+  get value() {
+    if (!this._isOk) {
+      console.error(this.error);
+      throw new Error("Tried to get value from a failed Result.");
+    }
+    return this._value;
+  }
+
+  /**
+   * Gets the error inside a failed result.
+   *
+   * @throws If the result is successful.
+   * @returns The error value.
+   */
+  get error() {
+    if (this._isOk) {
+      throw new Error("Tried to get error from a successful Result.");
+    }
+    return this._error;
+  }
+
+  /**
+   * Transforms the success value using the provided mapping function.
+   *
+   * @template U - The type of the new success value.
+   * @param fn - Function to apply to the value if the result is successful.
+   * @returns A new `Result` containing the mapped value, or the original error if failed.
+   */
+  map(fn) {
+    if (this.isOk()) {
+      return Result.ok(fn(this._value));
+    }
+    return Result.fail(this._error);
+  }
+
+  /**
+   * Transforms the error value using the provided mapping function.
+   *
+   * @template F - The type of the new error.
+   * @param fn - Function to apply to the error if the result is a failure.
+   * @returns A new `Result` containing the original value or the mapped error.
+   */
+  mapError(fn) {
+    if (this.isFail()) {
+      return Result.fail(fn(this._error));
+    }
+    return Result.ok(this._value);
+  }
+
+  /**
+   * Chains another `Result`-producing function onto this result.
+   * If this result is successful, the function is applied to the value.
+   * If this result is a failure, the original error is returned.
+   *
+   * @template U - The type of the next success value.
+   * @param fn - A function that takes the current value and returns another `Result`.
+   * @returns A new `Result` from applying the function or the original failure.
+   */
+  flatMap(fn) {
+    if (this.isOk()) {
+      return fn(this._value);
+    }
+    return Result.fail(this._error);
+  }
+
+  /**
+   * Pattern-matches the result to handle both success and failure cases.
+   *
+   * @template U - The return type of both match functions.
+   * @param handlers - An object containing `ok` and `fail` handlers.
+   * @returns The return value from the corresponding handler.
+   */
+  match(handlers) {
+    if (this.isOk()) {
+      return handlers.ok(this._value);
+    }
+    return handlers.fail(this._error);
+  }
+}
+
+//# sourceMappingURL=Result.js.map

package/api/Result.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Result","constructor","isOk","value","error","_isOk","_value","_error","ok","fail","undefined","isFail","console","Error","map","fn","mapError","flatMap","match","handlers"],"sources":["Result.ts"],"sourcesContent":["/**\n * A container type that represents either a successful result (`ok`) or a failure (`fail`).\n * Inspired by functional programming constructs like `Either` or `Result` in other languages.\n *\n * @template TValue - The type of the success value.\n * @template TError - The type of the error value.\n */\nexport class Result<TValue, TError = never> {\n    protected readonly _isOk: boolean;\n    protected readonly _value?: TValue;\n    protected readonly _error?: TError;\n\n    private constructor(isOk: boolean, value?: TValue, error?: TError) {\n        this._isOk = isOk;\n        this._value = value;\n        this._error = error;\n    }\n\n    /**\n     * Creates a successful `Result` containing the provided value.\n     * If no value is provided, returns Result<void, never>.\n     *\n     * @param value - The value to wrap in a successful result (optional).\n     * @returns A `Result` instance with the value.\n     */\n    public static ok<T>(value: T): Result<T, never>;\n    public static ok(): Result<void, never>;\n    public static ok<T>(value?: T): Result<T | void, never> {\n        return new Result<T | void, never>(true, value);\n    }\n\n    /**\n     * Creates a failed `Result` containing the provided error.\n     *\n     * @param error - The error to wrap in a failed result.\n     * @returns A `Result` instance with the error.\n     */\n    public static fail<E>(error: E): Result<never, E> {\n        return new Result<never, E>(false, undefined, error);\n    }\n\n    /**\n     * Checks whether the result is successful.\n     *\n     * @returns `true` if the result is `ok`, otherwise `false`.\n     *          Acts as a type guard to narrow the type to a successful result.\n     */\n    public isOk(): this is { _value: TValue } & Result<TValue, TError> {\n        return this._isOk;\n    }\n\n    /**\n     * Checks whether the result is a failure.\n     *\n     * @returns `true` if the result is `fail`, otherwise `false`.\n     *          Acts as a type guard to narrow the type to a failed result.\n     */\n    public isFail(): this is { _error: TError } & Result<TValue, TError> {\n        return !this._isOk;\n    }\n\n    /**\n     * Gets the value inside a successful result.\n     *\n     * @throws If the result is a failure.\n     * @returns The success value.\n     */\n    public get value(): TValue {\n        if (!this._isOk) {\n            console.error(this.error);\n            throw new Error(\"Tried to get value from a failed Result.\");\n        }\n\n        return this._value as TValue;\n    }\n\n    /**\n     * Gets the error inside a failed result.\n     *\n     * @throws If the result is successful.\n     * @returns The error value.\n     */\n    public get error(): TError {\n        if (this._isOk) {\n            throw new Error(\"Tried to get error from a successful Result.\");\n        }\n\n        return this._error as TError;\n    }\n\n    /**\n     * Transforms the success value using the provided mapping function.\n     *\n     * @template U - The type of the new success value.\n     * @param fn - Function to apply to the value if the result is successful.\n     * @returns A new `Result` containing the mapped value, or the original error if failed.\n     */\n    public map<U>(fn: (value: TValue) => U): Result<U, TError> {\n        if (this.isOk()) {\n            return Result.ok(fn(this._value as TValue));\n        }\n\n        return Result.fail(this._error as TError);\n    }\n\n    /**\n     * Transforms the error value using the provided mapping function.\n     *\n     * @template F - The type of the new error.\n     * @param fn - Function to apply to the error if the result is a failure.\n     * @returns A new `Result` containing the original value or the mapped error.\n     */\n    public mapError<F>(fn: (error: TError) => F): Result<TValue, F> {\n        if (this.isFail()) {\n            return Result.fail(fn(this._error as TError));\n        }\n\n        return Result.ok(this._value as TValue);\n    }\n\n    /**\n     * Chains another `Result`-producing function onto this result.\n     * If this result is successful, the function is applied to the value.\n     * If this result is a failure, the original error is returned.\n     *\n     * @template U - The type of the next success value.\n     * @param fn - A function that takes the current value and returns another `Result`.\n     * @returns A new `Result` from applying the function or the original failure.\n     */\n    public flatMap<U>(fn: (value: TValue) => Result<U, TError>): Result<U, TError> {\n        if (this.isOk()) {\n            return fn(this._value as TValue);\n        }\n\n        return Result.fail(this._error as TError);\n    }\n\n    /**\n     * Pattern-matches the result to handle both success and failure cases.\n     *\n     * @template U - The return type of both match functions.\n     * @param handlers - An object containing `ok` and `fail` handlers.\n     * @returns The return value from the corresponding handler.\n     */\n    public match<U>(handlers: { ok: (value: TValue) => U; fail: (error: TError) => U }): U {\n        if (this.isOk()) {\n            return handlers.ok(this._value as TValue);\n        }\n\n        return handlers.fail(this._error as TError);\n    }\n}\n\nexport namespace Result {\n    export type UnwrapResult<T> = Awaited<T> extends Result<infer Ok, any> ? Ok : never;\n    export type UnwrapError<T> = Awaited<T> extends Result<any, infer Err> ? Err : never;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,MAAM,CAAyB;EAKhCC,WAAWA,CAACC,IAAa,EAAEC,KAAc,EAAEC,KAAc,EAAE;IAC/D,IAAI,CAACC,KAAK,GAAGH,IAAI;IACjB,IAAI,CAACI,MAAM,GAAGH,KAAK;IACnB,IAAI,CAACI,MAAM,GAAGH,KAAK;EACvB;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;;EAGI,OAAcI,EAAEA,CAAIL,KAAS,EAA2B;IACpD,OAAO,IAAIH,MAAM,CAAkB,IAAI,EAAEG,KAAK,CAAC;EACnD;;EAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAcM,IAAIA,CAAIL,KAAQ,EAAoB;IAC9C,OAAO,IAAIJ,MAAM,CAAW,KAAK,EAAEU,SAAS,EAAEN,KAAK,CAAC;EACxD;;EAEA;AACJ;AACA;AACA;AACA;AACA;EACWF,IAAIA,CAAA,EAAwD;IAC/D,OAAO,IAAI,CAACG,KAAK;EACrB;;EAEA;AACJ;AACA;AACA;AACA;AACA;EACWM,MAAMA,CAAA,EAAwD;IACjE,OAAO,CAAC,IAAI,CAACN,KAAK;EACtB;;EAEA;AACJ;AACA;AACA;AACA;AACA;EACI,IAAWF,KAAKA,CAAA,EAAW;IACvB,IAAI,CAAC,IAAI,CAACE,KAAK,EAAE;MACbO,OAAO,CAACR,KAAK,CAAC,IAAI,CAACA,KAAK,CAAC;MACzB,MAAM,IAAIS,KAAK,CAAC,0CAA0C,CAAC;IAC/D;IAEA,OAAO,IAAI,CAACP,MAAM;EACtB;;EAEA;AACJ;AACA;AACA;AACA;AACA;EACI,IAAWF,KAAKA,CAAA,EAAW;IACvB,IAAI,IAAI,CAACC,KAAK,EAAE;MACZ,MAAM,IAAIQ,KAAK,CAAC,8CAA8C,CAAC;IACnE;IAEA,OAAO,IAAI,CAACN,MAAM;EACtB;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACWO,GAAGA,CAAIC,EAAwB,EAAqB;IACvD,IAAI,IAAI,CAACb,IAAI,CAAC,CAAC,EAAE;MACb,OAAOF,MAAM,CAACQ,EAAE,CAACO,EAAE,CAAC,IAAI,CAACT,MAAgB,CAAC,CAAC;IAC/C;IAEA,OAAON,MAAM,CAACS,IAAI,CAAC,IAAI,CAACF,MAAgB,CAAC;EAC7C;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACWS,QAAQA,CAAID,EAAwB,EAAqB;IAC5D,IAAI,IAAI,CAACJ,MAAM,CAAC,CAAC,EAAE;MACf,OAAOX,MAAM,CAACS,IAAI,CAACM,EAAE,CAAC,IAAI,CAACR,MAAgB,CAAC,CAAC;IACjD;IAEA,OAAOP,MAAM,CAACQ,EAAE,CAAC,IAAI,CAACF,MAAgB,CAAC;EAC3C;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACWW,OAAOA,CAAIF,EAAwC,EAAqB;IAC3E,IAAI,IAAI,CAACb,IAAI,CAAC,CAAC,EAAE;MACb,OAAOa,EAAE,CAAC,IAAI,CAACT,MAAgB,CAAC;IACpC;IAEA,OAAON,MAAM,CAACS,IAAI,CAAC,IAAI,CAACF,MAAgB,CAAC;EAC7C;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACWW,KAAKA,CAAIC,QAAkE,EAAK;IACnF,IAAI,IAAI,CAACjB,IAAI,CAAC,CAAC,EAAE;MACb,OAAOiB,QAAQ,CAACX,EAAE,CAAC,IAAI,CAACF,MAAgB,CAAC;IAC7C;IAEA,OAAOa,QAAQ,CAACV,IAAI,CAAC,IAAI,CAACF,MAAgB,CAAC;EAC/C;AACJ","ignoreList":[]}

package/api/ResultAsync.d.ts

@@ -0,0 +1,16 @@
+import { Result } from "./Result.js";
+export declare class ResultAsync<TValue, TError = never> {
+    private readonly promise;
+    constructor(promise: Promise<Result<TValue, TError>>);
+    static from<T, E>(fn: () => Promise<Result<T, E>>): ResultAsync<T, E>;
+    static ok<T>(value: T): ResultAsync<T, never>;
+    static fail<E>(error: E): ResultAsync<never, E>;
+    unwrap(): Promise<Result<TValue, TError>>;
+    mapAsync<U>(fn: (value: TValue) => U | Promise<U>): ResultAsync<U, TError>;
+    mapErrorAsync<F>(fn: (error: TError) => F | Promise<F>): ResultAsync<TValue, F>;
+    flatMapAsync<U>(fn: (value: TValue) => ResultAsync<U, TError>): ResultAsync<U, TError>;
+    match<U>(handlers: {
+        ok: (value: TValue) => U;
+        fail: (error: TError) => U;
+    }): Promise<U>;
+}

package/api/ResultAsync.js

@@ -0,0 +1,70 @@
+import { Result } from "./Result.js";
+export class ResultAsync {
+  constructor(promise) {
+    this.promise = promise;
+  }
+
+  // Wrap a function returning a Promise<Result<T, E>>.
+  static from(fn) {
+    return new ResultAsync(fn());
+  }
+
+  // Wrap a successful value.
+  static ok(value) {
+    return new ResultAsync(Promise.resolve(Result.ok(value)));
+  }
+
+  // Wrap a failure.
+  static fail(error) {
+    return new ResultAsync(Promise.resolve(Result.fail(error)));
+  }
+
+  // Await the wrapped result.
+  async unwrap() {
+    return this.promise;
+  }
+
+  // Transform the success value.
+  mapAsync(fn) {
+    const newPromise = this.promise.then(async res => {
+      if (res.isOk()) {
+        return Result.ok(await fn(res.value));
+      }
+      return Result.fail(res.error);
+    });
+    return new ResultAsync(newPromise);
+  }
+
+  // Transform the error value.
+  mapErrorAsync(fn) {
+    const newPromise = this.promise.then(async res => {
+      if (res.isFail()) {
+        return Result.fail(await fn(res.error));
+      }
+      return Result.ok(res.value);
+    });
+    return new ResultAsync(newPromise);
+  }
+
+  // Chain another async Result.
+  flatMapAsync(fn) {
+    const newPromise = this.promise.then(async res => {
+      if (res.isFail()) {
+        return Result.fail(res.error);
+      }
+      return await fn(res.value).unwrap();
+    });
+    return new ResultAsync(newPromise);
+  }
+
+  // Match success/failure (like sync Result).
+  async match(handlers) {
+    const result = await this.unwrap();
+    if (result.isOk()) {
+      return handlers.ok(result.value);
+    }
+    return handlers.fail(result.error);
+  }
+}
+
+//# sourceMappingURL=ResultAsync.js.map

package/api/ResultAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Result","ResultAsync","constructor","promise","from","fn","ok","value","Promise","resolve","fail","error","unwrap","mapAsync","newPromise","then","res","isOk","mapErrorAsync","isFail","flatMapAsync","match","handlers","result"],"sources":["ResultAsync.ts"],"sourcesContent":["import { Result } from \"./Result.js\";\n\nexport class ResultAsync<TValue, TError = never> {\n    constructor(private readonly promise: Promise<Result<TValue, TError>>) {}\n\n    // Wrap a function returning a Promise<Result<T, E>>.\n    public static from<T, E>(fn: () => Promise<Result<T, E>>): ResultAsync<T, E> {\n        return new ResultAsync(fn());\n    }\n\n    // Wrap a successful value.\n    public static ok<T>(value: T): ResultAsync<T, never> {\n        return new ResultAsync(Promise.resolve(Result.ok(value)));\n    }\n\n    // Wrap a failure.\n    public static fail<E>(error: E): ResultAsync<never, E> {\n        return new ResultAsync(Promise.resolve(Result.fail(error)));\n    }\n\n    // Await the wrapped result.\n    public async unwrap(): Promise<Result<TValue, TError>> {\n        return this.promise;\n    }\n\n    // Transform the success value.\n    public mapAsync<U>(fn: (value: TValue) => U | Promise<U>): ResultAsync<U, TError> {\n        const newPromise = this.promise.then(async res => {\n            if (res.isOk()) {\n                return Result.ok(await fn(res.value));\n            }\n\n            return Result.fail(res.error);\n        });\n\n        return new ResultAsync(newPromise);\n    }\n\n    // Transform the error value.\n    public mapErrorAsync<F>(fn: (error: TError) => F | Promise<F>): ResultAsync<TValue, F> {\n        const newPromise = this.promise.then(async res => {\n            if (res.isFail()) {\n                return Result.fail(await fn(res.error));\n            }\n\n            return Result.ok(res.value);\n        });\n\n        return new ResultAsync(newPromise);\n    }\n\n    // Chain another async Result.\n    public flatMapAsync<U>(fn: (value: TValue) => ResultAsync<U, TError>): ResultAsync<U, TError> {\n        const newPromise = this.promise.then(async res => {\n            if (res.isFail()) {\n                return Result.fail(res.error);\n            }\n\n            return await fn(res.value).unwrap();\n        });\n\n        return new ResultAsync(newPromise);\n    }\n\n    // Match success/failure (like sync Result).\n    public async match<U>(handlers: {\n        ok: (value: TValue) => U;\n        fail: (error: TError) => U;\n    }): Promise<U> {\n        const result = await this.unwrap();\n\n        if (result.isOk()) {\n            return handlers.ok(result.value);\n        }\n\n        return handlers.fail(result.error);\n    }\n}\n"],"mappings":"AAAA,SAASA,MAAM;AAEf,OAAO,MAAMC,WAAW,CAAyB;EAC7CC,WAAWA,CAAkBC,OAAwC,EAAE;IAAA,KAA1CA,OAAwC,GAAxCA,OAAwC;EAAG;;EAExE;EACA,OAAcC,IAAIA,CAAOC,EAA+B,EAAqB;IACzE,OAAO,IAAIJ,WAAW,CAACI,EAAE,CAAC,CAAC,CAAC;EAChC;;EAEA;EACA,OAAcC,EAAEA,CAAIC,KAAQ,EAAyB;IACjD,OAAO,IAAIN,WAAW,CAACO,OAAO,CAACC,OAAO,CAACT,MAAM,CAACM,EAAE,CAACC,KAAK,CAAC,CAAC,CAAC;EAC7D;;EAEA;EACA,OAAcG,IAAIA,CAAIC,KAAQ,EAAyB;IACnD,OAAO,IAAIV,WAAW,CAACO,OAAO,CAACC,OAAO,CAACT,MAAM,CAACU,IAAI,CAACC,KAAK,CAAC,CAAC,CAAC;EAC/D;;EAEA;EACA,MAAaC,MAAMA,CAAA,EAAoC;IACnD,OAAO,IAAI,CAACT,OAAO;EACvB;;EAEA;EACOU,QAAQA,CAAIR,EAAqC,EAA0B;IAC9E,MAAMS,UAAU,GAAG,IAAI,CAACX,OAAO,CAACY,IAAI,CAAC,MAAMC,GAAG,IAAI;MAC9C,IAAIA,GAAG,CAACC,IAAI,CAAC,CAAC,EAAE;QACZ,OAAOjB,MAAM,CAACM,EAAE,CAAC,MAAMD,EAAE,CAACW,GAAG,CAACT,KAAK,CAAC,CAAC;MACzC;MAEA,OAAOP,MAAM,CAACU,IAAI,CAACM,GAAG,CAACL,KAAK,CAAC;IACjC,CAAC,CAAC;IAEF,OAAO,IAAIV,WAAW,CAACa,UAAU,CAAC;EACtC;;EAEA;EACOI,aAAaA,CAAIb,EAAqC,EAA0B;IACnF,MAAMS,UAAU,GAAG,IAAI,CAACX,OAAO,CAACY,IAAI,CAAC,MAAMC,GAAG,IAAI;MAC9C,IAAIA,GAAG,CAACG,MAAM,CAAC,CAAC,EAAE;QACd,OAAOnB,MAAM,CAACU,IAAI,CAAC,MAAML,EAAE,CAACW,GAAG,CAACL,KAAK,CAAC,CAAC;MAC3C;MAEA,OAAOX,MAAM,CAACM,EAAE,CAACU,GAAG,CAACT,KAAK,CAAC;IAC/B,CAAC,CAAC;IAEF,OAAO,IAAIN,WAAW,CAACa,UAAU,CAAC;EACtC;;EAEA;EACOM,YAAYA,CAAIf,EAA6C,EAA0B;IAC1F,MAAMS,UAAU,GAAG,IAAI,CAACX,OAAO,CAACY,IAAI,CAAC,MAAMC,GAAG,IAAI;MAC9C,IAAIA,GAAG,CAACG,MAAM,CAAC,CAAC,EAAE;QACd,OAAOnB,MAAM,CAACU,IAAI,CAACM,GAAG,CAACL,KAAK,CAAC;MACjC;MAEA,OAAO,MAAMN,EAAE,CAACW,GAAG,CAACT,KAAK,CAAC,CAACK,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,OAAO,IAAIX,WAAW,CAACa,UAAU,CAAC;EACtC;;EAEA;EACA,MAAaO,KAAKA,CAAIC,QAGrB,EAAc;IACX,MAAMC,MAAM,GAAG,MAAM,IAAI,CAACX,MAAM,CAAC,CAAC;IAElC,IAAIW,MAAM,CAACN,IAAI,CAAC,CAAC,EAAE;MACf,OAAOK,QAAQ,CAAChB,EAAE,CAACiB,MAAM,CAAChB,KAAK,CAAC;IACpC;IAEA,OAAOe,QAAQ,CAACZ,IAAI,CAACa,MAAM,CAACZ,KAAK,CAAC;EACtC;AACJ","ignoreList":[]}

package/api/createFeature.d.ts

@@ -0,0 +1,9 @@
+import type { Container } from "@webiny/di";
+export interface FeatureDefinition<TRegister> {
+    name: string;
+    register(container: Container, context?: TRegister): void;
+}
+export declare function createFeature<TRegister>(def: {
+    name: string;
+    register(container: Container, context?: TRegister): void;
+}): FeatureDefinition<TRegister>;

package/api/createFeature.js

@@ -0,0 +1,10 @@
+export function createFeature(def) {
+  const feature = {
+    name: def.name,
+    register: def.register
+  };
+  Reflect.defineMetadata("wby:isFeature", true, feature);
+  return feature;
+}
+
+//# sourceMappingURL=createFeature.js.map

package/api/createFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createFeature","def","feature","name","register","Reflect","defineMetadata"],"sources":["createFeature.ts"],"sourcesContent":["import type { Container } from \"@webiny/di\";\n\nexport interface FeatureDefinition<TRegister> {\n    name: string;\n    register(container: Container, context?: TRegister): void;\n}\n\nexport function createFeature<TRegister>(def: {\n    name: string;\n    register(container: Container, context?: TRegister): void;\n}): FeatureDefinition<TRegister> {\n    const feature = {\n        name: def.name,\n        register: def.register\n    };\n\n    Reflect.defineMetadata(\"wby:isFeature\", true, feature);\n\n    return feature as FeatureDefinition<TRegister>;\n}\n"],"mappings":"AAOA,OAAO,SAASA,aAAaA,CAAYC,GAGxC,EAAgC;EAC7B,MAAMC,OAAO,GAAG;IACZC,IAAI,EAAEF,GAAG,CAACE,IAAI;IACdC,QAAQ,EAAEH,GAAG,CAACG;EAClB,CAAC;EAEDC,OAAO,CAACC,cAAc,CAAC,eAAe,EAAE,IAAI,EAAEJ,OAAO,CAAC;EAEtD,OAAOA,OAAO;AAClB","ignoreList":[]}

package/api/index.d.ts

@@ -0,0 +1,6 @@
+export { createDecorator, createImplementation } from "@webiny/di";
+export { createFeature } from "./createFeature.js";
+export { createAbstraction } from "../createAbstraction.js";
+export { Result } from "./Result.js";
+export { ResultAsync } from "./ResultAsync.js";
+export { BaseError } from "./BaseError.js";

package/api/index.js

@@ -0,0 +1,8 @@
+export { createDecorator, createImplementation } from "@webiny/di";
+export { createFeature } from "./createFeature.js";
+export { createAbstraction } from "../createAbstraction.js";
+export { Result } from "./Result.js";
+export { ResultAsync } from "./ResultAsync.js";
+export { BaseError } from "./BaseError.js";
+
+//# sourceMappingURL=index.js.map

package/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createDecorator","createImplementation","createFeature","createAbstraction","Result","ResultAsync","BaseError"],"sources":["index.ts"],"sourcesContent":["export { createDecorator, createImplementation } from \"@webiny/di\";\nexport { createFeature } from \"./createFeature.js\";\nexport { createAbstraction } from \"../createAbstraction.js\";\nexport { Result } from \"./Result.js\";\nexport { ResultAsync } from \"./ResultAsync.js\";\nexport { BaseError } from \"./BaseError.js\";\n"],"mappings":"AAAA,SAASA,eAAe,EAAEC,oBAAoB,QAAQ,YAAY;AAClE,SAASC,aAAa;AACtB,SAASC,iBAAiB;AAC1B,SAASC,MAAM;AACf,SAASC,WAAW;AACpB,SAASC,SAAS","ignoreList":[]}

package/createAbstraction.d.ts

@@ -0,0 +1,2 @@
+import { Abstraction } from "@webiny/di";
+export declare function createAbstraction<T>(name: string): Abstraction<T>;

package/createAbstraction.js

@@ -0,0 +1,6 @@
+import { Abstraction } from "@webiny/di";
+export function createAbstraction(name) {
+  return new Abstraction(name);
+}
+
+//# sourceMappingURL=createAbstraction.js.map

package/createAbstraction.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Abstraction","createAbstraction","name"],"sources":["createAbstraction.ts"],"sourcesContent":["import { Abstraction } from \"@webiny/di\";\n\nexport function createAbstraction<T>(name: string) {\n    return new Abstraction<T>(name);\n}\n"],"mappings":"AAAA,SAASA,WAAW,QAAQ,YAAY;AAExC,OAAO,SAASC,iBAAiBA,CAAIC,IAAY,EAAE;EAC/C,OAAO,IAAIF,WAAW,CAAIE,IAAI,CAAC;AACnC","ignoreList":[]}

package/exports/admin.d.ts

@@ -0,0 +1 @@
+export { createFeature, createAbstraction, BaseError } from "../admin/index.js";

package/exports/admin.js

@@ -0,0 +1,3 @@
+export { createFeature, createAbstraction, BaseError } from "../admin/index.js";
+
+//# sourceMappingURL=admin.js.map

package/exports/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createFeature","createAbstraction","BaseError"],"sources":["admin.ts"],"sourcesContent":["export { createFeature, createAbstraction, BaseError } from \"~/admin/index.js\";\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,iBAAiB,EAAEC,SAAS","ignoreList":[]}

package/exports/api.d.ts

@@ -0,0 +1 @@
+export { createFeature, createAbstraction, Result, BaseError } from "../api/index.js";

package/exports/api.js

@@ -0,0 +1,3 @@
+export { createFeature, createAbstraction, Result, BaseError } from "../api/index.js";
+
+//# sourceMappingURL=api.js.map

package/exports/api.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createFeature","createAbstraction","Result","BaseError"],"sources":["api.ts"],"sourcesContent":["export { createFeature, createAbstraction, Result, BaseError } from \"~/api/index.js\";\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,iBAAiB,EAAEC,MAAM,EAAEC,SAAS","ignoreList":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "@webiny/feature",
+	"description": "A small utility library to build application features in a Webiny project.",
+	"version": "0.0.0-unstable.61c048f412",
+	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/webiny/webiny-js.git"
+	},
+	"author": "Webiny LTD",
+	"license": "MIT",
+	"exports": {
+		"./api": "./api/index.js",
+		"./admin": "./admin/index.js",
+		"./*": "./*"
+	},
+	"webiny": {
+		"exports": {
+			"./api/index.ts": {
+				"exportPath": "./api",
+				"namedExports": [
+					"createFeature",
+					"createAbstraction",
+					"BaseError",
+					"Result",
+					"ResultAsync"
+				]
+			},
+			"./admin/index.ts": {
+				"exportPath": "./admin",
+				"namedExports": [
+					"createFeature",
+					"createAbstraction",
+					"BaseError"
+				]
+			}
+		}
+	},
+	"dependencies": {
+		"@webiny/di": "0.2.3"
+	},
+	"devDependencies": {
+		"@webiny/build-tools": "0.0.0-unstable.61c048f412",
+		"typescript": "5.9.3"
+	},
+	"publishConfig": {
+		"access": "public",
+		"directory": "dist"
+	},
+	"gitHead": "61c048f412d6b4aa70c1d105aab21e3fa69730f3"
+}