@uql/core 1.0.11 → 3.0.0

package/dist/type/querierPool.d.ts

@@ -0,0 +1,22 @@
+import type { Dialect, ExtraOptions, Querier } from './querier.js';
+/**
+ * querier pool.
+ */
+export type QuerierPool<Q extends Querier = Querier> = {
+    /**
+     * the database dialect.
+     */
+    readonly dialect: Dialect;
+    /**
+     * extra options
+     */
+    readonly extra?: ExtraOptions;
+    /**
+     * get a querier from the pool.
+     */
+    getQuerier: () => Promise<Q>;
+    /**
+     * end the pool.
+     */
+    end(): Promise<void>;
+};

package/dist/type/querierPool.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicXVlcmllclBvb2wuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZS9xdWVyaWVyUG9vbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHR5cGUgeyBEaWFsZWN0LCBFeHRyYU9wdGlvbnMsIFF1ZXJpZXIgfSBmcm9tICcuL3F1ZXJpZXIuanMnO1xuXG4vKipcbiAqIHF1ZXJpZXIgcG9vbC5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcmllclBvb2w8USBleHRlbmRzIFF1ZXJpZXIgPSBRdWVyaWVyPiA9IHtcbiAgLyoqXG4gICAqIHRoZSBkYXRhYmFzZSBkaWFsZWN0LlxuICAgKi9cbiAgcmVhZG9ubHkgZGlhbGVjdDogRGlhbGVjdDtcblxuICAvKipcbiAgICogZXh0cmEgb3B0aW9uc1xuICAgKi9cbiAgcmVhZG9ubHkgZXh0cmE/OiBFeHRyYU9wdGlvbnM7XG5cbiAgLyoqXG4gICAqIGdldCBhIHF1ZXJpZXIgZnJvbSB0aGUgcG9vbC5cbiAgICovXG4gIGdldFF1ZXJpZXI6ICgpID0+IFByb21pc2U8UT47XG5cbiAgLyoqXG4gICAqIGVuZCB0aGUgcG9vbC5cbiAgICovXG4gIGVuZCgpOiBQcm9taXNlPHZvaWQ+O1xufTtcbiJdfQ==

package/dist/type/query.d.ts

@@ -0,0 +1,456 @@
+import type { FieldKey, IdValue, Key, RelationKey } from './entity.js';
+import type { BooleanLike, ExpandScalar, Scalar, Type, Unpacked } from './utility.js';
+export type QueryOptions = {
+    /**
+     * use or omit `softDelete` attribute.
+     */
+    softDelete?: boolean;
+    /**
+     * prefix the query with this.
+     */
+    prefix?: string;
+    /**
+     * automatically infer the prefix for the query.
+     */
+    autoPrefix?: boolean;
+};
+export type QuerySelectOptions = {
+    /**
+     * prefix the query with this.
+     */
+    prefix?: string;
+    /**
+     * automatically add the prefix for the alias.
+     */
+    autoPrefixAlias?: boolean;
+};
+/**
+ * query selection as an array.
+ */
+export type QuerySelectArray<E> = (Key<E> | QueryRaw)[];
+/**
+ * query selection as a map.
+ */
+export type QuerySelectMap<E> = QuerySelectFieldMap<E> | QuerySelectRelationMap<E>;
+/**
+ * query selection.
+ */
+export type QuerySelect<E> = QuerySelectArray<E> | QuerySelectMap<E>;
+/**
+ * query selection of fields as a map.
+ */
+export type QuerySelectFieldMap<E> = {
+    [K in FieldKey<E>]?: BooleanLike;
+};
+/**
+ * query conflict paths map.
+ */
+export type QueryConflictPathsMap<E> = {
+    [K in FieldKey<E>]?: true;
+};
+/**
+ * query conflict paths.
+ */
+export type QueryConflictPaths<E> = QueryConflictPathsMap<E>;
+/**
+ * query selection of relations as a map.
+ */
+export type QuerySelectRelationMap<E> = {
+    [K in RelationKey<E>]?: BooleanLike | Key<Unpacked<E[K]>>[] | QuerySelectRelationOptions<E[K]>;
+};
+/**
+ * options to select a relation.
+ */
+export type QuerySelectRelationOptions<E> = (E extends unknown[] ? Query<Unpacked<E>> : QueryUnique<Unpacked<E>>) & {
+    $required?: boolean;
+};
+/**
+ * options for full-text-search operator.
+ */
+export type QueryTextSearchOptions<E> = {
+    /**
+     * text to search for.
+     */
+    $value: string;
+    /**
+     * list of fields to search on.
+     */
+    $fields?: FieldKey<E>[];
+};
+/**
+ * comparison by fields.
+ */
+export type QueryWhereFieldMap<E> = {
+    [K in FieldKey<E>]?: QueryWhereFieldValue<E[K]>;
+};
+/**
+ * complex operators.
+ */
+export type QueryWhereMap<E> = QueryWhereFieldMap<E> & QueryWhereRootOperator<E>;
+export type QueryWhereRootOperator<E> = {
+    /**
+     * joins query clauses with a logical `AND`, returns records that match all the clauses.
+     */
+    $and?: QueryWhereArray<E>;
+    /**
+     * joins query clauses with a logical `OR`, returns records that match any of the clauses.
+     */
+    $or?: QueryWhereArray<E>;
+    /**
+     * joins query clauses with a logical `AND`, returns records that do not match all the clauses.
+     */
+    $not?: QueryWhereArray<E>;
+    /**
+     * joins query clauses with a logical `OR`, returns records that do not match any of the clauses.
+     */
+    $nor?: QueryWhereArray<E>;
+    /**
+     * whether the specified fields match against a full-text search of the given string.
+     */
+    $text?: QueryTextSearchOptions<E>;
+    /**
+     * whether the record exists in the given sub-query.
+     */
+    $exists?: QueryRaw;
+    /**
+     * whether the record does not exists in the given sub-query.
+     */
+    $nexists?: QueryRaw;
+};
+export type QueryWhereFieldOperatorMap<T> = {
+    /**
+     * whether a value is equal to the given value.
+     */
+    $eq?: ExpandScalar<T>;
+    /**
+     * whether a value is not equal to the given value.
+     */
+    $ne?: ExpandScalar<T>;
+    /**
+     * negates the given comparison.
+     */
+    $not?: QueryWhereFieldValue<T>;
+    /**
+     * whether a value is less than the given value.
+     */
+    $lt?: ExpandScalar<T>;
+    /**
+     * whether a value is less than or equal to the given value.
+     */
+    $lte?: ExpandScalar<T>;
+    /**
+     * whether a value is greater than the given value.
+     */
+    $gt?: ExpandScalar<T>;
+    /**
+     * whether a value is greater than or equal to the given value.
+     */
+    $gte?: ExpandScalar<T>;
+    /**
+     * whether a string begins with the given string (case sensitive).
+     */
+    $startsWith?: string;
+    /**
+     * whether a string begins with the given string (case insensitive).
+     */
+    $istartsWith?: string;
+    /**
+     * whether a string ends with the given string (case sensitive).
+     */
+    $endsWith?: string;
+    /**
+     * whether a string ends with the given string (case insensitive).
+     */
+    $iendsWith?: string;
+    /**
+     * whether a string is contained within the given string (case sensitive).
+     */
+    $includes?: string;
+    /**
+     * whether a string is contained within the given string (case insensitive).
+     */
+    $iincludes?: string;
+    /**
+     * whether a string fulfills the given pattern (case sensitive).
+     */
+    $like?: string;
+    /**
+     * whether a string fulfills the given pattern (case insensitive).
+     */
+    $ilike?: string;
+    /**
+     * whether a string matches the given regular expression.
+     */
+    $regex?: string;
+    /**
+     * whether a value matches any of the given values.
+     */
+    $in?: ExpandScalar<T>[];
+    /**
+     * whether a value does not match any of the given values.
+     */
+    $nin?: ExpandScalar<T>[];
+};
+/**
+ * Value for a field comparison.
+ */
+export type QueryWhereFieldValue<T> = T | T[] | QueryWhereFieldOperatorMap<T> | QueryRaw;
+/**
+ * query single filter.
+ */
+export type QueryWhereSingle<E> = IdValue<E> | IdValue<E>[] | QueryWhereMap<E> | QueryRaw;
+/**
+ * query filter array.
+ */
+export type QueryWhereArray<E> = QueryWhereSingle<E>[];
+/**
+ * query filter.
+ */
+export type QueryWhere<E> = QueryWhereSingle<E> | QueryWhereArray<E>;
+/**
+ * direction for the sort.
+ */
+export type QuerySortDirection = -1 | 1 | 'asc' | 'desc';
+/**
+ * sort by tuples
+ */
+export type QuerySortTuples<E> = [FieldKey<E>, QuerySortDirection][];
+/**
+ * sort by objects.
+ */
+export type QuerySortObjects<E> = {
+    field: FieldKey<E>;
+    sort: QuerySortDirection;
+}[];
+/**
+ * sort by fields.
+ */
+export type QuerySortFieldMap<E> = {
+    [K in FieldKey<E>]?: QuerySortDirection;
+};
+/**
+ * sort by relations fields.
+ */
+export type QuerySortRelationMap<E> = {
+    [K in RelationKey<E>]?: QuerySortMap<Unpacked<E[K]>>;
+};
+/**
+ * sort by map.
+ */
+export type QuerySortMap<E> = QuerySortFieldMap<E> | QuerySortRelationMap<E>;
+/**
+ * sort options.
+ */
+export type QuerySort<E> = QuerySortMap<E> | QuerySortTuples<E> | QuerySortObjects<E>;
+/**
+ * pager options.
+ */
+export type QueryPager = {
+    /**
+     * Index from where start the search
+     */
+    $skip?: number;
+    /**
+     * Max number of records to retrieve
+     */
+    $limit?: number;
+};
+/**
+ * search options.
+ */
+export type QuerySearch<E> = {
+    /**
+     * filtering options.
+     */
+    $where?: QueryWhere<E>;
+    /**
+     * sorting options.
+     */
+    $sort?: QuerySort<E>;
+} & QueryPager;
+/**
+ * criteria one options.
+ */
+export type QuerySearchOne<E> = Omit<QuerySearch<E>, '$limit'>;
+/**
+ * query options.
+ */
+export type Query<E> = {
+    /**
+     * selection options.
+     */
+    $select?: QuerySelect<E>;
+} & QuerySearch<E>;
+/**
+ * options to get a single record.
+ */
+export type QueryOne<E> = Omit<Query<E>, '$limit'>;
+/**
+ * options to get an unique record.
+ */
+export type QueryUnique<E> = Pick<QueryOne<E>, '$select' | '$where'>;
+/**
+ * stringified query.
+ */
+export type QueryStringified = {
+    [K in keyof Query<unknown>]?: string;
+};
+/**
+ * result of an update operation.
+ */
+export type QueryUpdateResult = {
+    /**
+     * number of affected records.
+     */
+    changes?: number;
+    /**
+     * the inserted IDs.
+     */
+    ids?: number[] | string[];
+    /**
+     * first inserted ID.
+     */
+    firstId?: number | string;
+};
+/**
+ * options for the `raw` function.
+ */
+export type QueryRawFnOptions = {
+    /**
+     * the current dialect.
+     */
+    dialect?: QueryDialect;
+    /**
+     * the prefix.
+     */
+    prefix?: string;
+    /**
+     * the escaped prefix.
+     */
+    escapedPrefix?: string;
+    /**
+     * the query context.
+     */
+    ctx?: QueryContext;
+};
+/**
+ * a `raw` function
+ */
+export type QueryRawFn = (opts?: QueryRawFnOptions) => void | Scalar;
+export declare class QueryRaw {
+    readonly value: Scalar | QueryRawFn;
+    readonly alias?: string;
+    constructor(value: Scalar | QueryRawFn, alias?: string);
+}
+/**
+ * comparison options.
+ */
+export type QueryComparisonOptions = QueryOptions & {
+    /**
+     * use precedence for the comparison or not.
+     */
+    usePrecedence?: boolean;
+};
+/**
+ * query filter options.
+ */
+export type QueryWhereOptions = QueryComparisonOptions & {
+    /**
+     * clause to be used in the filter.
+     */
+    clause?: 'WHERE' | false;
+};
+export interface QueryContext {
+    append(sql: string): this;
+    addValue(value: unknown): this;
+    pushValue(value: unknown): this;
+    readonly sql: string;
+    readonly values: unknown[];
+}
+export interface QueryDialect {
+    /**
+     * obtains the records matching the given search parameters.
+     * @param ctx the query context
+     * @param entity the target entity
+     * @param q the criteria options
+     * @param opts the query options
+     */
+    find<E>(ctx: QueryContext, entity: Type<E>, q: Query<E>, opts?: QueryOptions): void;
+    /**
+     * counts the number of records matching the given search parameters.
+     * @param ctx the query context
+     * @param entity the target entity
+     * @param q the criteria options
+     * @param opts the query options
+     */
+    count<E>(ctx: QueryContext, entity: Type<E>, q: QuerySearch<E>, opts?: QueryOptions): void;
+    /**
+     * insert records.
+     * @param ctx the query context
+     * @param entity the target entity
+     * @param payload the payload
+     * @param opts the query options
+     */
+    insert<E>(ctx: QueryContext, entity: Type<E>, payload: E | E[], opts?: QueryOptions): void;
+    /**
+     * update records.
+     * @param ctx the query context
+     * @param entity the target entity
+     * @param q the criteria options
+     * @param payload
+     * @param opts the query options
+     */
+    update<E>(ctx: QueryContext, entity: Type<E>, q: QuerySearch<E>, payload: E, opts?: QueryOptions): void;
+    /**
+     * upsert records.
+     * @param ctx the query context
+     * @param entity the target entity
+     * @param conflictPaths the conflict paths
+     * @param payload
+     */
+    upsert<E>(ctx: QueryContext, entity: Type<E>, conflictPaths: QueryConflictPaths<E>, payload: E): void;
+    /**
+     * delete records.
+     * @param ctx the query context
+     * @param entity the target entity
+     * @param q the criteria options
+     * @param opts the query options
+     */
+    delete<E>(ctx: QueryContext, entity: Type<E>, q: QuerySearch<E>, opts?: QueryOptions): void;
+    /**
+     * escape an identifier.
+     * @param val the value to be escaped
+     * @param forbidQualified don't escape dots
+     * @param addDot use a dot as suffix
+     */
+    escapeId(val: string, forbidQualified?: boolean, addDot?: boolean): string;
+    /**
+     * escape a value.
+     * @param val the value to escape
+     */
+    escape(val: unknown): string;
+    /**
+     * add a value to the query.
+     * @param values the values array
+     * @param value the value to add
+     */
+    addValue(values: unknown[], value: unknown): string;
+    /**
+     * create a new query context.
+     */
+    createContext(): QueryContext;
+}
+/**
+ * Minimal dialect interface exposing escapeIdChar for SQL operations
+ */
+export interface SqlQueryDialect extends QueryDialect {
+    /**
+     * the escape character for identifiers.
+     */
+    readonly escapeIdChar: '"' | '`';
+    /**
+     * Get the placeholder for a parameter at the given index (1-based).
+     * Default: '?' for MySQL/MariaDB/SQLite, '$n' for PostgreSQL.
+     */
+    placeholder(index: number): string;
+}

package/dist/type/query.js

@@ -0,0 +1,9 @@
+export class QueryRaw {
+    value;
+    alias;
+    constructor(value, alias) {
+        this.value = value;
+        this.alias = alias;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicXVlcnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZS9xdWVyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFxWEEsTUFBTSxPQUFPLFFBQVE7SUFFUjtJQUNBO0lBRlgsWUFDVyxLQUEwQixFQUMxQixLQUFjO1FBRGQsVUFBSyxHQUFMLEtBQUssQ0FBcUI7UUFDMUIsVUFBSyxHQUFMLEtBQUssQ0FBUztJQUN0QixDQUFDO0NBQ0wiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgdHlwZSB7IEZpZWxkS2V5LCBJZFZhbHVlLCBLZXksIFJlbGF0aW9uS2V5IH0gZnJvbSAnLi9lbnRpdHkuanMnO1xuaW1wb3J0IHR5cGUgeyBCb29sZWFuTGlrZSwgRXhwYW5kU2NhbGFyLCBTY2FsYXIsIFR5cGUsIFVucGFja2VkIH0gZnJvbSAnLi91dGlsaXR5LmpzJztcblxuZXhwb3J0IHR5cGUgUXVlcnlPcHRpb25zID0ge1xuICAvKipcbiAgICogdXNlIG9yIG9taXQgYHNvZnREZWxldGVgIGF0dHJpYnV0ZS5cbiAgICovXG4gIHNvZnREZWxldGU/OiBib29sZWFuO1xuICAvKipcbiAgICogcHJlZml4IHRoZSBxdWVyeSB3aXRoIHRoaXMuXG4gICAqL1xuICBwcmVmaXg/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiBhdXRvbWF0aWNhbGx5IGluZmVyIHRoZSBwcmVmaXggZm9yIHRoZSBxdWVyeS5cbiAgICovXG4gIGF1dG9QcmVmaXg/OiBib29sZWFuO1xufTtcblxuZXhwb3J0IHR5cGUgUXVlcnlTZWxlY3RPcHRpb25zID0ge1xuICAvKipcbiAgICogcHJlZml4IHRoZSBxdWVyeSB3aXRoIHRoaXMuXG4gICAqL1xuICBwcmVmaXg/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiBhdXRvbWF0aWNhbGx5IGFkZCB0aGUgcHJlZml4IGZvciB0aGUgYWxpYXMuXG4gICAqL1xuICBhdXRvUHJlZml4QWxpYXM/OiBib29sZWFuO1xufTtcblxuLyoqXG4gKiBxdWVyeSBzZWxlY3Rpb24gYXMgYW4gYXJyYXkuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5U2VsZWN0QXJyYXk8RT4gPSAoS2V5PEU+IHwgUXVlcnlSYXcpW107XG5cbi8qKlxuICogcXVlcnkgc2VsZWN0aW9uIGFzIGEgbWFwLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVNlbGVjdE1hcDxFPiA9IFF1ZXJ5U2VsZWN0RmllbGRNYXA8RT4gfCBRdWVyeVNlbGVjdFJlbGF0aW9uTWFwPEU+O1xuXG4vKipcbiAqIHF1ZXJ5IHNlbGVjdGlvbi5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlTZWxlY3Q8RT4gPSBRdWVyeVNlbGVjdEFycmF5PEU+IHwgUXVlcnlTZWxlY3RNYXA8RT47XG5cbi8qKlxuICogcXVlcnkgc2VsZWN0aW9uIG9mIGZpZWxkcyBhcyBhIG1hcC5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlTZWxlY3RGaWVsZE1hcDxFPiA9IHtcbiAgW0sgaW4gRmllbGRLZXk8RT5dPzogQm9vbGVhbkxpa2U7XG59O1xuXG4vKipcbiAqIHF1ZXJ5IGNvbmZsaWN0IHBhdGhzIG1hcC5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlDb25mbGljdFBhdGhzTWFwPEU+ID0ge1xuICBbSyBpbiBGaWVsZEtleTxFPl0/OiB0cnVlO1xufTtcblxuLyoqXG4gKiBxdWVyeSBjb25mbGljdCBwYXRocy5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlDb25mbGljdFBhdGhzPEU+ID0gUXVlcnlDb25mbGljdFBhdGhzTWFwPEU+O1xuXG4vKipcbiAqIHF1ZXJ5IHNlbGVjdGlvbiBvZiByZWxhdGlvbnMgYXMgYSBtYXAuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5U2VsZWN0UmVsYXRpb25NYXA8RT4gPSB7XG4gIFtLIGluIFJlbGF0aW9uS2V5PEU+XT86IEJvb2xlYW5MaWtlIHwgS2V5PFVucGFja2VkPEVbS10+PltdIHwgUXVlcnlTZWxlY3RSZWxhdGlvbk9wdGlvbnM8RVtLXT47XG59O1xuXG4vKipcbiAqIG9wdGlvbnMgdG8gc2VsZWN0IGEgcmVsYXRpb24uXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5U2VsZWN0UmVsYXRpb25PcHRpb25zPEU+ID0gKEUgZXh0ZW5kcyB1bmtub3duW10gPyBRdWVyeTxVbnBhY2tlZDxFPj4gOiBRdWVyeVVuaXF1ZTxVbnBhY2tlZDxFPj4pICYge1xuICAkcmVxdWlyZWQ/OiBib29sZWFuO1xufTtcblxuLyoqXG4gKiBvcHRpb25zIGZvciBmdWxsLXRleHQtc2VhcmNoIG9wZXJhdG9yLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVRleHRTZWFyY2hPcHRpb25zPEU+ID0ge1xuICAvKipcbiAgICogdGV4dCB0byBzZWFyY2ggZm9yLlxuICAgKi9cbiAgJHZhbHVlOiBzdHJpbmc7XG4gIC8qKlxuICAgKiBsaXN0IG9mIGZpZWxkcyB0byBzZWFyY2ggb24uXG4gICAqL1xuICAkZmllbGRzPzogRmllbGRLZXk8RT5bXTtcbn07XG5cbi8qKlxuICogY29tcGFyaXNvbiBieSBmaWVsZHMuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5V2hlcmVGaWVsZE1hcDxFPiA9IHsgW0sgaW4gRmllbGRLZXk8RT5dPzogUXVlcnlXaGVyZUZpZWxkVmFsdWU8RVtLXT4gfTtcblxuLyoqXG4gKiBjb21wbGV4IG9wZXJhdG9ycy5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlXaGVyZU1hcDxFPiA9IFF1ZXJ5V2hlcmVGaWVsZE1hcDxFPiAmIFF1ZXJ5V2hlcmVSb290T3BlcmF0b3I8RT47XG5cbmV4cG9ydCB0eXBlIFF1ZXJ5V2hlcmVSb290T3BlcmF0b3I8RT4gPSB7XG4gIC8qKlxuICAgKiBqb2lucyBxdWVyeSBjbGF1c2VzIHdpdGggYSBsb2dpY2FsIGBBTkRgLCByZXR1cm5zIHJlY29yZHMgdGhhdCBtYXRjaCBhbGwgdGhlIGNsYXVzZXMuXG4gICAqL1xuICAkYW5kPzogUXVlcnlXaGVyZUFycmF5PEU+O1xuICAvKipcbiAgICogam9pbnMgcXVlcnkgY2xhdXNlcyB3aXRoIGEgbG9naWNhbCBgT1JgLCByZXR1cm5zIHJlY29yZHMgdGhhdCBtYXRjaCBhbnkgb2YgdGhlIGNsYXVzZXMuXG4gICAqL1xuICAkb3I/OiBRdWVyeVdoZXJlQXJyYXk8RT47XG4gIC8qKlxuICAgKiBqb2lucyBxdWVyeSBjbGF1c2VzIHdpdGggYSBsb2dpY2FsIGBBTkRgLCByZXR1cm5zIHJlY29yZHMgdGhhdCBkbyBub3QgbWF0Y2ggYWxsIHRoZSBjbGF1c2VzLlxuICAgKi9cbiAgJG5vdD86IFF1ZXJ5V2hlcmVBcnJheTxFPjtcbiAgLyoqXG4gICAqIGpvaW5zIHF1ZXJ5IGNsYXVzZXMgd2l0aCBhIGxvZ2ljYWwgYE9SYCwgcmV0dXJucyByZWNvcmRzIHRoYXQgZG8gbm90IG1hdGNoIGFueSBvZiB0aGUgY2xhdXNlcy5cbiAgICovXG4gICRub3I/OiBRdWVyeVdoZXJlQXJyYXk8RT47XG4gIC8qKlxuICAgKiB3aGV0aGVyIHRoZSBzcGVjaWZpZWQgZmllbGRzIG1hdGNoIGFnYWluc3QgYSBmdWxsLXRleHQgc2VhcmNoIG9mIHRoZSBnaXZlbiBzdHJpbmcuXG4gICAqL1xuICAkdGV4dD86IFF1ZXJ5VGV4dFNlYXJjaE9wdGlvbnM8RT47XG4gIC8qKlxuICAgKiB3aGV0aGVyIHRoZSByZWNvcmQgZXhpc3RzIGluIHRoZSBnaXZlbiBzdWItcXVlcnkuXG4gICAqL1xuICAkZXhpc3RzPzogUXVlcnlSYXc7XG4gIC8qKlxuICAgKiB3aGV0aGVyIHRoZSByZWNvcmQgZG9lcyBub3QgZXhpc3RzIGluIHRoZSBnaXZlbiBzdWItcXVlcnkuXG4gICAqL1xuICAkbmV4aXN0cz86IFF1ZXJ5UmF3O1xufTtcblxuZXhwb3J0IHR5cGUgUXVlcnlXaGVyZUZpZWxkT3BlcmF0b3JNYXA8VD4gPSB7XG4gIC8qKlxuICAgKiB3aGV0aGVyIGEgdmFsdWUgaXMgZXF1YWwgdG8gdGhlIGdpdmVuIHZhbHVlLlxuICAgKi9cbiAgJGVxPzogRXhwYW5kU2NhbGFyPFQ+O1xuICAvKipcbiAgICogd2hldGhlciBhIHZhbHVlIGlzIG5vdCBlcXVhbCB0byB0aGUgZ2l2ZW4gdmFsdWUuXG4gICAqL1xuICAkbmU/OiBFeHBhbmRTY2FsYXI8VD47XG4gIC8qKlxuICAgKiBuZWdhdGVzIHRoZSBnaXZlbiBjb21wYXJpc29uLlxuICAgKi9cbiAgJG5vdD86IFF1ZXJ5V2hlcmVGaWVsZFZhbHVlPFQ+O1xuICAvKipcbiAgICogd2hldGhlciBhIHZhbHVlIGlzIGxlc3MgdGhhbiB0aGUgZ2l2ZW4gdmFsdWUuXG4gICAqL1xuICAkbHQ/OiBFeHBhbmRTY2FsYXI8VD47XG4gIC8qKlxuICAgKiB3aGV0aGVyIGEgdmFsdWUgaXMgbGVzcyB0aGFuIG9yIGVxdWFsIHRvIHRoZSBnaXZlbiB2YWx1ZS5cbiAgICovXG4gICRsdGU/OiBFeHBhbmRTY2FsYXI8VD47XG4gIC8qKlxuICAgKiB3aGV0aGVyIGEgdmFsdWUgaXMgZ3JlYXRlciB0aGFuIHRoZSBnaXZlbiB2YWx1ZS5cbiAgICovXG4gICRndD86IEV4cGFuZFNjYWxhcjxUPjtcbiAgLyoqXG4gICAqIHdoZXRoZXIgYSB2YWx1ZSBpcyBncmVhdGVyIHRoYW4gb3IgZXF1YWwgdG8gdGhlIGdpdmVuIHZhbHVlLlxuICAgKi9cbiAgJGd0ZT86IEV4cGFuZFNjYWxhcjxUPjtcbiAgLyoqXG4gICAqIHdoZXRoZXIgYSBzdHJpbmcgYmVnaW5zIHdpdGggdGhlIGdpdmVuIHN0cmluZyAoY2FzZSBzZW5zaXRpdmUpLlxuICAgKi9cbiAgJHN0YXJ0c1dpdGg/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiB3aGV0aGVyIGEgc3RyaW5nIGJlZ2lucyB3aXRoIHRoZSBnaXZlbiBzdHJpbmcgKGNhc2UgaW5zZW5zaXRpdmUpLlxuICAgKi9cbiAgJGlzdGFydHNXaXRoPzogc3RyaW5nO1xuICAvKipcbiAgICogd2hldGhlciBhIHN0cmluZyBlbmRzIHdpdGggdGhlIGdpdmVuIHN0cmluZyAoY2FzZSBzZW5zaXRpdmUpLlxuICAgKi9cbiAgJGVuZHNXaXRoPzogc3RyaW5nO1xuICAvKipcbiAgICogd2hldGhlciBhIHN0cmluZyBlbmRzIHdpdGggdGhlIGdpdmVuIHN0cmluZyAoY2FzZSBpbnNlbnNpdGl2ZSkuXG4gICAqL1xuICAkaWVuZHNXaXRoPzogc3RyaW5nO1xuICAvKipcbiAgICogd2hldGhlciBhIHN0cmluZyBpcyBjb250YWluZWQgd2l0aGluIHRoZSBnaXZlbiBzdHJpbmcgKGNhc2Ugc2Vuc2l0aXZlKS5cbiAgICovXG4gICRpbmNsdWRlcz86IHN0cmluZztcbiAgLyoqXG4gICAqIHdoZXRoZXIgYSBzdHJpbmcgaXMgY29udGFpbmVkIHdpdGhpbiB0aGUgZ2l2ZW4gc3RyaW5nIChjYXNlIGluc2Vuc2l0aXZlKS5cbiAgICovXG4gICRpaW5jbHVkZXM/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiB3aGV0aGVyIGEgc3RyaW5nIGZ1bGZpbGxzIHRoZSBnaXZlbiBwYXR0ZXJuIChjYXNlIHNlbnNpdGl2ZSkuXG4gICAqL1xuICAkbGlrZT86IHN0cmluZztcbiAgLyoqXG4gICAqIHdoZXRoZXIgYSBzdHJpbmcgZnVsZmlsbHMgdGhlIGdpdmVuIHBhdHRlcm4gKGNhc2UgaW5zZW5zaXRpdmUpLlxuICAgKi9cbiAgJGlsaWtlPzogc3RyaW5nO1xuICAvKipcbiAgICogd2hldGhlciBhIHN0cmluZyBtYXRjaGVzIHRoZSBnaXZlbiByZWd1bGFyIGV4cHJlc3Npb24uXG4gICAqL1xuICAkcmVnZXg/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiB3aGV0aGVyIGEgdmFsdWUgbWF0Y2hlcyBhbnkgb2YgdGhlIGdpdmVuIHZhbHVlcy5cbiAgICovXG4gICRpbj86IEV4cGFuZFNjYWxhcjxUPltdO1xuICAvKipcbiAgICogd2hldGhlciBhIHZhbHVlIGRvZXMgbm90IG1hdGNoIGFueSBvZiB0aGUgZ2l2ZW4gdmFsdWVzLlxuICAgKi9cbiAgJG5pbj86IEV4cGFuZFNjYWxhcjxUPltdO1xufTtcblxuLyoqXG4gKiBWYWx1ZSBmb3IgYSBmaWVsZCBjb21wYXJpc29uLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVdoZXJlRmllbGRWYWx1ZTxUPiA9IFQgfCBUW10gfCBRdWVyeVdoZXJlRmllbGRPcGVyYXRvck1hcDxUPiB8IFF1ZXJ5UmF3O1xuXG4vKipcbiAqIHF1ZXJ5IHNpbmdsZSBmaWx0ZXIuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5V2hlcmVTaW5nbGU8RT4gPSBJZFZhbHVlPEU+IHwgSWRWYWx1ZTxFPltdIHwgUXVlcnlXaGVyZU1hcDxFPiB8IFF1ZXJ5UmF3O1xuXG4vKipcbiAqIHF1ZXJ5IGZpbHRlciBhcnJheS5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlXaGVyZUFycmF5PEU+ID0gUXVlcnlXaGVyZVNpbmdsZTxFPltdO1xuXG4vKipcbiAqIHF1ZXJ5IGZpbHRlci5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlXaGVyZTxFPiA9IFF1ZXJ5V2hlcmVTaW5nbGU8RT4gfCBRdWVyeVdoZXJlQXJyYXk8RT47XG5cbi8qKlxuICogZGlyZWN0aW9uIGZvciB0aGUgc29ydC5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlTb3J0RGlyZWN0aW9uID0gLTEgfCAxIHwgJ2FzYycgfCAnZGVzYyc7XG5cbi8qKlxuICogc29ydCBieSB0dXBsZXNcbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlTb3J0VHVwbGVzPEU+ID0gW0ZpZWxkS2V5PEU+LCBRdWVyeVNvcnREaXJlY3Rpb25dW107XG5cbi8qKlxuICogc29ydCBieSBvYmplY3RzLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVNvcnRPYmplY3RzPEU+ID0geyBmaWVsZDogRmllbGRLZXk8RT47IHNvcnQ6IFF1ZXJ5U29ydERpcmVjdGlvbiB9W107XG5cbi8qKlxuICogc29ydCBieSBmaWVsZHMuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5U29ydEZpZWxkTWFwPEU+ID0ge1xuICBbSyBpbiBGaWVsZEtleTxFPl0/OiBRdWVyeVNvcnREaXJlY3Rpb247XG59O1xuXG4vKipcbiAqIHNvcnQgYnkgcmVsYXRpb25zIGZpZWxkcy5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlTb3J0UmVsYXRpb25NYXA8RT4gPSB7XG4gIFtLIGluIFJlbGF0aW9uS2V5PEU+XT86IFF1ZXJ5U29ydE1hcDxVbnBhY2tlZDxFW0tdPj47XG59O1xuXG4vKipcbiAqIHNvcnQgYnkgbWFwLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVNvcnRNYXA8RT4gPSBRdWVyeVNvcnRGaWVsZE1hcDxFPiB8IFF1ZXJ5U29ydFJlbGF0aW9uTWFwPEU+O1xuXG4vKipcbiAqIHNvcnQgb3B0aW9ucy5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlTb3J0PEU+ID0gUXVlcnlTb3J0TWFwPEU+IHwgUXVlcnlTb3J0VHVwbGVzPEU+IHwgUXVlcnlTb3J0T2JqZWN0czxFPjtcblxuLyoqXG4gKiBwYWdlciBvcHRpb25zLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVBhZ2VyID0ge1xuICAvKipcbiAgICogSW5kZXggZnJvbSB3aGVyZSBzdGFydCB0aGUgc2VhcmNoXG4gICAqL1xuICAkc2tpcD86IG51bWJlcjtcblxuICAvKipcbiAgICogTWF4IG51bWJlciBvZiByZWNvcmRzIHRvIHJldHJpZXZlXG4gICAqL1xuICAkbGltaXQ/OiBudW1iZXI7XG59O1xuXG4vKipcbiAqIHNlYXJjaCBvcHRpb25zLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVNlYXJjaDxFPiA9IHtcbiAgLyoqXG4gICAqIGZpbHRlcmluZyBvcHRpb25zLlxuICAgKi9cbiAgJHdoZXJlPzogUXVlcnlXaGVyZTxFPjtcblxuICAvKipcbiAgICogc29ydGluZyBvcHRpb25zLlxuICAgKi9cbiAgJHNvcnQ/OiBRdWVyeVNvcnQ8RT47XG59ICYgUXVlcnlQYWdlcjtcblxuLyoqXG4gKiBjcml0ZXJpYSBvbmUgb3B0aW9ucy5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlTZWFyY2hPbmU8RT4gPSBPbWl0PFF1ZXJ5U2VhcmNoPEU+LCAnJGxpbWl0Jz47XG5cbi8qKlxuICogcXVlcnkgb3B0aW9ucy5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnk8RT4gPSB7XG4gIC8qKlxuICAgKiBzZWxlY3Rpb24gb3B0aW9ucy5cbiAgICovXG4gICRzZWxlY3Q/OiBRdWVyeVNlbGVjdDxFPjtcbn0gJiBRdWVyeVNlYXJjaDxFPjtcblxuLyoqXG4gKiBvcHRpb25zIHRvIGdldCBhIHNpbmdsZSByZWNvcmQuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5T25lPEU+ID0gT21pdDxRdWVyeTxFPiwgJyRsaW1pdCc+O1xuXG4vKipcbiAqIG9wdGlvbnMgdG8gZ2V0IGFuIHVuaXF1ZSByZWNvcmQuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5VW5pcXVlPEU+ID0gUGljazxRdWVyeU9uZTxFPiwgJyRzZWxlY3QnIHwgJyR3aGVyZSc+O1xuXG4vKipcbiAqIHN0cmluZ2lmaWVkIHF1ZXJ5LlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVN0cmluZ2lmaWVkID0ge1xuICBbSyBpbiBrZXlvZiBRdWVyeTx1bmtub3duPl0/OiBzdHJpbmc7XG59O1xuXG4vKipcbiAqIHJlc3VsdCBvZiBhbiB1cGRhdGUgb3BlcmF0aW9uLlxuICovXG5leHBvcnQgdHlwZSBRdWVyeVVwZGF0ZVJlc3VsdCA9IHtcbiAgLyoqXG4gICAqIG51bWJlciBvZiBhZmZlY3RlZCByZWNvcmRzLlxuICAgKi9cbiAgY2hhbmdlcz86IG51bWJlcjtcbiAgLyoqXG4gICAqIHRoZSBpbnNlcnRlZCBJRHMuXG4gICAqL1xuICBpZHM/OiBudW1iZXJbXSB8IHN0cmluZ1tdO1xuICAvKipcbiAgICogZmlyc3QgaW5zZXJ0ZWQgSUQuXG4gICAqL1xuICBmaXJzdElkPzogbnVtYmVyIHwgc3RyaW5nO1xufTtcblxuLyoqXG4gKiBvcHRpb25zIGZvciB0aGUgYHJhd2AgZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5UmF3Rm5PcHRpb25zID0ge1xuICAvKipcbiAgICogdGhlIGN1cnJlbnQgZGlhbGVjdC5cbiAgICovXG4gIGRpYWxlY3Q/OiBRdWVyeURpYWxlY3Q7XG4gIC8qKlxuICAgKiB0aGUgcHJlZml4LlxuICAgKi9cbiAgcHJlZml4Pzogc3RyaW5nO1xuICAvKipcbiAgICogdGhlIGVzY2FwZWQgcHJlZml4LlxuICAgKi9cbiAgZXNjYXBlZFByZWZpeD86IHN0cmluZztcbiAgLyoqXG4gICAqIHRoZSBxdWVyeSBjb250ZXh0LlxuICAgKi9cbiAgY3R4PzogUXVlcnlDb250ZXh0O1xufTtcblxuLyoqXG4gKiBhIGByYXdgIGZ1bmN0aW9uXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5UmF3Rm4gPSAob3B0cz86IFF1ZXJ5UmF3Rm5PcHRpb25zKSA9PiB2b2lkIHwgU2NhbGFyO1xuXG5leHBvcnQgY2xhc3MgUXVlcnlSYXcge1xuICBjb25zdHJ1Y3RvcihcbiAgICByZWFkb25seSB2YWx1ZTogU2NhbGFyIHwgUXVlcnlSYXdGbixcbiAgICByZWFkb25seSBhbGlhcz86IHN0cmluZyxcbiAgKSB7fVxufVxuXG4vKipcbiAqIGNvbXBhcmlzb24gb3B0aW9ucy5cbiAqL1xuZXhwb3J0IHR5cGUgUXVlcnlDb21wYXJpc29uT3B0aW9ucyA9IFF1ZXJ5T3B0aW9ucyAmIHtcbiAgLyoqXG4gICAqIHVzZSBwcmVjZWRlbmNlIGZvciB0aGUgY29tcGFyaXNvbiBvciBub3QuXG4gICAqL1xuICB1c2VQcmVjZWRlbmNlPzogYm9vbGVhbjtcbn07XG5cbi8qKlxuICogcXVlcnkgZmlsdGVyIG9wdGlvbnMuXG4gKi9cbmV4cG9ydCB0eXBlIFF1ZXJ5V2hlcmVPcHRpb25zID0gUXVlcnlDb21wYXJpc29uT3B0aW9ucyAmIHtcbiAgLyoqXG4gICAqIGNsYXVzZSB0byBiZSB1c2VkIGluIHRoZSBmaWx0ZXIuXG4gICAqL1xuICBjbGF1c2U/OiAnV0hFUkUnIHwgZmFsc2U7XG59O1xuXG5leHBvcnQgaW50ZXJmYWNlIFF1ZXJ5Q29udGV4dCB7XG4gIGFwcGVuZChzcWw6IHN0cmluZyk6IHRoaXM7XG4gIGFkZFZhbHVlKHZhbHVlOiB1bmtub3duKTogdGhpcztcbiAgcHVzaFZhbHVlKHZhbHVlOiB1bmtub3duKTogdGhpcztcbiAgcmVhZG9ubHkgc3FsOiBzdHJpbmc7XG4gIHJlYWRvbmx5IHZhbHVlczogdW5rbm93bltdO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFF1ZXJ5RGlhbGVjdCB7XG4gIC8qKlxuICAgKiBvYnRhaW5zIHRoZSByZWNvcmRzIG1hdGNoaW5nIHRoZSBnaXZlbiBzZWFyY2ggcGFyYW1ldGVycy5cbiAgICogQHBhcmFtIGN0eCB0aGUgcXVlcnkgY29udGV4dFxuICAgKiBAcGFyYW0gZW50aXR5IHRoZSB0YXJnZXQgZW50aXR5XG4gICAqIEBwYXJhbSBxIHRoZSBjcml0ZXJpYSBvcHRpb25zXG4gICAqIEBwYXJhbSBvcHRzIHRoZSBxdWVyeSBvcHRpb25zXG4gICAqL1xuICBmaW5kPEU+KGN0eDogUXVlcnlDb250ZXh0LCBlbnRpdHk6IFR5cGU8RT4sIHE6IFF1ZXJ5PEU+LCBvcHRzPzogUXVlcnlPcHRpb25zKTogdm9pZDtcblxuICAvKipcbiAgICogY291bnRzIHRoZSBudW1iZXIgb2YgcmVjb3JkcyBtYXRjaGluZyB0aGUgZ2l2ZW4gc2VhcmNoIHBhcmFtZXRlcnMuXG4gICAqIEBwYXJhbSBjdHggdGhlIHF1ZXJ5IGNvbnRleHRcbiAgICogQHBhcmFtIGVudGl0eSB0aGUgdGFyZ2V0IGVudGl0eVxuICAgKiBAcGFyYW0gcSB0aGUgY3JpdGVyaWEgb3B0aW9uc1xuICAgKiBAcGFyYW0gb3B0cyB0aGUgcXVlcnkgb3B0aW9uc1xuICAgKi9cbiAgY291bnQ8RT4oY3R4OiBRdWVyeUNvbnRleHQsIGVudGl0eTogVHlwZTxFPiwgcTogUXVlcnlTZWFyY2g8RT4sIG9wdHM/OiBRdWVyeU9wdGlvbnMpOiB2b2lkO1xuXG4gIC8qKlxuICAgKiBpbnNlcnQgcmVjb3Jkcy5cbiAgICogQHBhcmFtIGN0eCB0aGUgcXVlcnkgY29udGV4dFxuICAgKiBAcGFyYW0gZW50aXR5IHRoZSB0YXJnZXQgZW50aXR5XG4gICAqIEBwYXJhbSBwYXlsb2FkIHRoZSBwYXlsb2FkXG4gICAqIEBwYXJhbSBvcHRzIHRoZSBxdWVyeSBvcHRpb25zXG4gICAqL1xuICBpbnNlcnQ8RT4oY3R4OiBRdWVyeUNvbnRleHQsIGVudGl0eTogVHlwZTxFPiwgcGF5bG9hZDogRSB8IEVbXSwgb3B0cz86IFF1ZXJ5T3B0aW9ucyk6IHZvaWQ7XG5cbiAgLyoqXG4gICAqIHVwZGF0ZSByZWNvcmRzLlxuICAgKiBAcGFyYW0gY3R4IHRoZSBxdWVyeSBjb250ZXh0XG4gICAqIEBwYXJhbSBlbnRpdHkgdGhlIHRhcmdldCBlbnRpdHlcbiAgICogQHBhcmFtIHEgdGhlIGNyaXRlcmlhIG9wdGlvbnNcbiAgICogQHBhcmFtIHBheWxvYWRcbiAgICogQHBhcmFtIG9wdHMgdGhlIHF1ZXJ5IG9wdGlvbnNcbiAgICovXG4gIHVwZGF0ZTxFPihjdHg6IFF1ZXJ5Q29udGV4dCwgZW50aXR5OiBUeXBlPEU+LCBxOiBRdWVyeVNlYXJjaDxFPiwgcGF5bG9hZDogRSwgb3B0cz86IFF1ZXJ5T3B0aW9ucyk6IHZvaWQ7XG5cbiAgLyoqXG4gICAqIHVwc2VydCByZWNvcmRzLlxuICAgKiBAcGFyYW0gY3R4IHRoZSBxdWVyeSBjb250ZXh0XG4gICAqIEBwYXJhbSBlbnRpdHkgdGhlIHRhcmdldCBlbnRpdHlcbiAgICogQHBhcmFtIGNvbmZsaWN0UGF0aHMgdGhlIGNvbmZsaWN0IHBhdGhzXG4gICAqIEBwYXJhbSBwYXlsb2FkXG4gICAqL1xuICB1cHNlcnQ8RT4oY3R4OiBRdWVyeUNvbnRleHQsIGVudGl0eTogVHlwZTxFPiwgY29uZmxpY3RQYXRoczogUXVlcnlDb25mbGljdFBhdGhzPEU+LCBwYXlsb2FkOiBFKTogdm9pZDtcblxuICAvKipcbiAgICogZGVsZXRlIHJlY29yZHMuXG4gICAqIEBwYXJhbSBjdHggdGhlIHF1ZXJ5IGNvbnRleHRcbiAgICogQHBhcmFtIGVudGl0eSB0aGUgdGFyZ2V0IGVudGl0eVxuICAgKiBAcGFyYW0gcSB0aGUgY3JpdGVyaWEgb3B0aW9uc1xuICAgKiBAcGFyYW0gb3B0cyB0aGUgcXVlcnkgb3B0aW9uc1xuICAgKi9cbiAgZGVsZXRlPEU+KGN0eDogUXVlcnlDb250ZXh0LCBlbnRpdHk6IFR5cGU8RT4sIHE6IFF1ZXJ5U2VhcmNoPEU+LCBvcHRzPzogUXVlcnlPcHRpb25zKTogdm9pZDtcblxuICAvKipcbiAgICogZXNjYXBlIGFuIGlkZW50aWZpZXIuXG4gICAqIEBwYXJhbSB2YWwgdGhlIHZhbHVlIHRvIGJlIGVzY2FwZWRcbiAgICogQHBhcmFtIGZvcmJpZFF1YWxpZmllZCBkb24ndCBlc2NhcGUgZG90c1xuICAgKiBAcGFyYW0gYWRkRG90IHVzZSBhIGRvdCBhcyBzdWZmaXhcbiAgICovXG4gIGVzY2FwZUlkKHZhbDogc3RyaW5nLCBmb3JiaWRRdWFsaWZpZWQ/OiBib29sZWFuLCBhZGREb3Q/OiBib29sZWFuKTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBlc2NhcGUgYSB2YWx1ZS5cbiAgICogQHBhcmFtIHZhbCB0aGUgdmFsdWUgdG8gZXNjYXBlXG4gICAqL1xuICBlc2NhcGUodmFsOiB1bmtub3duKTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBhZGQgYSB2YWx1ZSB0byB0aGUgcXVlcnkuXG4gICAqIEBwYXJhbSB2YWx1ZXMgdGhlIHZhbHVlcyBhcnJheVxuICAgKiBAcGFyYW0gdmFsdWUgdGhlIHZhbHVlIHRvIGFkZFxuICAgKi9cbiAgYWRkVmFsdWUodmFsdWVzOiB1bmtub3duW10sIHZhbHVlOiB1bmtub3duKTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBjcmVhdGUgYSBuZXcgcXVlcnkgY29udGV4dC5cbiAgICovXG4gIGNyZWF0ZUNvbnRleHQoKTogUXVlcnlDb250ZXh0O1xufVxuXG4vKipcbiAqIE1pbmltYWwgZGlhbGVjdCBpbnRlcmZhY2UgZXhwb3NpbmcgZXNjYXBlSWRDaGFyIGZvciBTUUwgb3BlcmF0aW9uc1xuICovXG5leHBvcnQgaW50ZXJmYWNlIFNxbFF1ZXJ5RGlhbGVjdCBleHRlbmRzIFF1ZXJ5RGlhbGVjdCB7XG4gIC8qKlxuICAgKiB0aGUgZXNjYXBlIGNoYXJhY3RlciBmb3IgaWRlbnRpZmllcnMuXG4gICAqL1xuICByZWFkb25seSBlc2NhcGVJZENoYXI6ICdcIicgfCAnYCc7XG5cbiAgLyoqXG4gICAqIEdldCB0aGUgcGxhY2Vob2xkZXIgZm9yIGEgcGFyYW1ldGVyIGF0IHRoZSBnaXZlbiBpbmRleCAoMS1iYXNlZCkuXG4gICAqIERlZmF1bHQ6ICc/JyBmb3IgTXlTUUwvTWFyaWFEQi9TUUxpdGUsICckbicgZm9yIFBvc3RncmVTUUwuXG4gICAqL1xuICBwbGFjZWhvbGRlcihpbmRleDogbnVtYmVyKTogc3RyaW5nO1xufVxuIl19

package/{type → dist/type}/repository.d.ts

@@ -1,105 +1,112 @@
-import { IdValue } from './entity';
-import { Querier } from './querier';
-import { Query, QueryCriteria, QueryOne, QueryOptions, QuerySearch, QueryUnique } from './query';
-import { Type } from './utility';
+import type { IdValue } from './entity.js';
+import type { Query, QueryConflictPaths, QueryOne, QueryOptions, QuerySearch, QueryUpdateResult } from './query.js';
+import type { UniversalQuerier } from './universalQuerier.js';
+import type { Type } from './utility.js';
 /**
  * A `repository` allows to interact with the datasource to perform persistence operations on a specific entity.
  */
-export declare type UniversalRepository<E> = {
+export type UniversalRepository<E> = {
     /**
-     * counts the number of records matching the given search parameters.
-     * @param qm the search options
+     * the `entity` class to which this `repository` is linked to.
+     */
+    readonly entity: Type<E>;
+    /**
+     * the `querier` instance to which this `repository` is linked to.
      */
-    count(qm: QuerySearch<E>): Promise<any>;
+    readonly querier: UniversalQuerier;
     /**
      * obtains the record with the given primary key.
      * @param id the primary key value
-     * @param qm the criteria options
+     * @param q the criteria options
      */
-    findOneById(id: IdValue<E>, qm?: QueryUnique<E>): Promise<any>;
+    findOneById(id: IdValue<E>, q?: QueryOne<E>): Promise<unknown>;
     /**
      * obtains the first record matching the given search parameters.
-     * @param qm the criteria options
+     * @param q the criteria options
      */
-    findOne(qm: QueryOne<E>): Promise<any>;
+    findOne(q: QueryOne<E>): Promise<unknown>;
     /**
      * obtains the records matching the given search parameters.
-     * @param qm the criteria options
+     * @param q the criteria options
      */
-    findMany(qm: Query<E>): Promise<any>;
+    findMany(q: Query<E>): Promise<unknown>;
     /**
      * obtains the records matching the given search parameters,
      * also counts the number of matches ignoring pagination.
-     * @param qm the criteria options
+     * @param q the criteria options
+     */
+    findManyAndCount(q: Query<E>): Promise<unknown>;
+    /**
+     * counts the number of records matching the given search parameters.
+     * @param q the search options
      */
-    findManyAndCount(qm: Query<E>): Promise<any>;
+    count(q: QuerySearch<E>): Promise<unknown>;
     /**
      * inserts a record.
      * @param payload the data to be persisted
      */
-    insertOne(payload: E): Promise<any>;
+    insertOne(payload: E): Promise<unknown>;
     /**
      * Inserts many records.
      * @param entity the entity to persist on
      * @param payload the data to be persisted
      */
-    insertMany?(payload: E[]): Promise<any>;
+    insertMany?(payload: E[]): Promise<unknown>;
     /**
      * updates a record partially.
      * @param id the primary key of the record to be updated
      * @param payload the data to be persisted
      */
-    updateOneById(id: IdValue<E>, payload: E): Promise<any>;
+    updateOneById(id: IdValue<E>, payload: E): Promise<unknown>;
     /**
      * updates many records partially.
      * @param qm the criteria to look for the records
      * @param payload the data to be persisted
      */
-    updateMany?(qm: QueryCriteria<E>, payload: E): Promise<any>;
+    updateMany?(qm: QuerySearch<E>, payload: E): Promise<unknown>;
+    /**
+     * Insert or update a record given a search criteria.
+     * @param conflictPaths the keys to use for the unique search.
+     * @param payload the data to insert or update.
+     */
+    upsertOne?(conflictPaths: QueryConflictPaths<E>, payload: E): Promise<unknown>;
     /**
      * Insert or update a record.
      * @param payload the data to be persisted
      */
-    saveOne(payload: E): Promise<any>;
+    saveOne(payload: E): Promise<unknown>;
     /**
      * insert or update records.
      * @param payload the data to be persisted
      */
-    saveMany?(payload: E[]): Promise<any>;
+    saveMany?(payload: E[]): Promise<unknown>;
     /**
      * delete or SoftDelete a record.
      * @param id the primary key of the record
      */
-    deleteOneById(id: IdValue<E>, opts?: QueryOptions): Promise<any>;
+    deleteOneById(id: IdValue<E>, opts?: QueryOptions): Promise<unknown>;
     /**
      * delete or SoftDelete records.
      * @param qm the criteria to look for the records
      */
-    deleteMany(qm: QueryCriteria<E>, opts?: QueryOptions): Promise<any>;
+    deleteMany(qm: QuerySearch<E>, opts?: QueryOptions): Promise<unknown>;
 };
 /**
  * base contract for the backend repositories.
  */
 export interface Repository<E> extends UniversalRepository<E> {
-    /**
-     * the `entity` type to which this `repository` is linked to.
-     */
-    readonly entity: Type<E>;
-    /**
-     * the `querier` instance to which this `repository` is linked to.
-     */
-    readonly querier: Querier;
-    count(qm: QueryCriteria<E>): Promise<number>;
-    findOneById(id: IdValue<E>, qm?: QueryUnique<E>): Promise<E>;
+    findOneById(id: IdValue<E>, q?: QueryOne<E>): Promise<E>;
     findOne(qm: QueryOne<E>): Promise<E>;
     findMany(qm: Query<E>): Promise<E[]>;
     findManyAndCount(qm: Query<E>): Promise<[E[], number]>;
+    count(q?: QuerySearch<E>): Promise<number>;
     insertOne(payload: E): Promise<IdValue<E>>;
     insertMany(payload: E[]): Promise<IdValue<E>[]>;
     updateOneById(id: IdValue<E>, payload: E): Promise<number>;
-    updateMany(qm: QueryCriteria<E>, payload: E): Promise<number>;
+    updateMany(qm: QuerySearch<E>, payload: E): Promise<number>;
+    upsertOne(conflictPaths: QueryConflictPaths<E>, payload: E): Promise<QueryUpdateResult>;
     saveOne(payload: E): Promise<IdValue<E>>;
     saveMany?(payload: E[]): Promise<IdValue<E>[]>;
     deleteOneById(id: IdValue<E>, opts?: QueryOptions): Promise<number>;
-    deleteMany(qm: QueryCriteria<E>, opts?: QueryOptions): Promise<number>;
+    deleteMany(qm: QuerySearch<E>, opts?: QueryOptions): Promise<number>;
 }