@owlmeans/planning 0.1.18-rc.2 → 0.1.18-rc.21

package/build/helpers/code.d.ts

@@ -1,23 +1,12 @@
 import type { CodePolicy, WorkcardDraft } from '../types.js';
-export interface MintCodeOptions {
-    /** Slug style: the text the slug is derived from (a title). A word slug when omitted. */
-    seed?: string;
-    /** Sequential style: how many codes the scope already holds. */
-    count?: number;
-}
-/** `Some Title!` → `some-title`. */
+import type { CodeHelper, MintCodeOptions } from './code/types.js';
+export declare const createCodeHelper: () => CodeHelper;
+export declare const codeHelper: CodeHelper;
+/** @deprecated compat:factory-refactor — use `codeHelper.slugOf(…)` */
 export declare const slugOf: (text: string, max?: number) => string;
-/**
- * Mint a code under a policy, asking `taken` for each candidate.
- *
- * `random` draws `prefix + Base58(length)` (upper-cased when asked) afresh per attempt; `slug`
- * walks `base`, `base-2`, `base-3` from the seed (a word slug without one); `sequential` counts on
- * from `opts.count`, zero-padded to `length`. After `attempts` taken candidates it refuses.
- *
- * @throws {CodeTaken}
- */
+/** @deprecated compat:factory-refactor — use `codeHelper.mintCode(…)` */
 export declare const mintCode: (policy: CodePolicy, taken: (code: string) => boolean | Promise<boolean>, attempts?: number, opts?: MintCodeOptions) => Promise<string>;
-/** Where a draft's code must be unique: its parent, or the whole entity. */
+/** @deprecated compat:factory-refactor — use `codeHelper.codeScopeOf(…)` */
 export declare const codeScopeOf: (policy: CodePolicy, draft: Pick<WorkcardDraft, 'parent'>) => {
     parent?: string;
 };

package/build/helpers/code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/helpers/code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE5D,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,oCAAoC;AACpC,eAAO,MAAM,MAAM,SAAU,MAAM,QAAO,MAAM,KAAc,MAG1B,CAAA;AAmBpC;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,WACX,UAAU,SACX,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aACzC,MAAM,SACT,eAAe,KACrB,OAAO,CAAC,MAAM,CAYhB,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,WAAW,WAAY,UAAU,SAAS,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,KAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/helpers/code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElE,eAAO,MAAM,gBAAgB,QAAO,UA8CnC,CAAA;AAED,eAAO,MAAM,UAAU,YAAqB,CAAA;AAE5C,uEAAuE;AACvE,eAAO,MAAM,MAAM,SAAU,MAAM,QAAO,MAAM,KAAc,MAAsC,CAAA;AAEpG,yEAAyE;AACzE,eAAO,MAAM,QAAQ,WACX,UAAU,SACX,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aACzC,MAAM,SACT,eAAe,KACrB,OAAO,CAAC,MAAM,CAA6D,CAAA;AAE9E,4EAA4E;AAC5E,eAAO,MAAM,WAAW,WAAY,UAAU,SAAS,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,KAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CACjE,CAAA"}

package/build/helpers/code.js

@@ -1,47 +1,46 @@
 import { createIdOfLength, generateWordSlug, IdStyle, nextSlugCandidate } from '@owlmeans/basic-ids';
 import { CODE_MAX, CODE_MINT_ATTEMPTS, CodeScope, CodeStyle, DEFAULT_CODE_LENGTH } from '../consts.js';
 import { CodeTaken } from '../errors.js';
-/** `Some Title!` → `some-title`. */
-export const slugOf = (text, max = CODE_MAX) => text
-    .normalize('NFKD').replace(/[̀-ͯ]/g, '')
-    .toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')
-    .slice(0, max).replace(/-+$/g, '');
-const candidateOf = (policy, attempt, base, opts) => {
-    const prefix = policy.prefix ?? '';
-    switch (policy.style) {
-        case CodeStyle.Slug:
-            return `${prefix}${nextSlugCandidate(base, attempt + 1)}`;
-        case CodeStyle.Sequential: {
-            const number = `${(opts?.count ?? 0) + attempt + 1}`;
-            return `${prefix}${policy.length != null ? number.padStart(policy.length, '0') : number}`;
+export const createCodeHelper = () => {
+    const slugOf = (text, max = CODE_MAX) => text
+        .normalize('NFKD').replace(/[̀-ͯ]/g, '')
+        .toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')
+        .slice(0, max).replace(/-+$/g, '');
+    const candidateOf = (policy, attempt, base, opts) => {
+        const prefix = policy.prefix ?? '';
+        switch (policy.style) {
+            case CodeStyle.Slug:
+                return `${prefix}${nextSlugCandidate(base, attempt + 1)}`;
+            case CodeStyle.Sequential: {
+                const number = `${(opts?.count ?? 0) + attempt + 1}`;
+                return `${prefix}${policy.length != null ? number.padStart(policy.length, '0') : number}`;
+            }
+            case CodeStyle.Random:
+            default: {
+                const random = createIdOfLength(policy.length ?? DEFAULT_CODE_LENGTH, IdStyle.Base58);
+                return `${prefix}${policy.uppercase === true ? random.toUpperCase() : random}`;
+            }
         }
-        case CodeStyle.Random:
-        default: {
-            const random = createIdOfLength(policy.length ?? DEFAULT_CODE_LENGTH, IdStyle.Base58);
-            return `${prefix}${policy.uppercase === true ? random.toUpperCase() : random}`;
+    };
+    const mintCode = async (policy, taken, attempts = CODE_MINT_ATTEMPTS, opts) => {
+        const seeded = opts?.seed != null ? slugOf(opts.seed, CODE_MAX - (policy.prefix?.length ?? 0) - 4) : '';
+        const base = policy.style === CodeStyle.Slug ? (seeded !== '' ? seeded : generateWordSlug()) : '';
+        for (let attempt = 0; attempt < attempts; ++attempt) {
+            const candidate = candidateOf(policy, attempt, base, opts);
+            if (!await taken(candidate)) {
+                return candidate;
+            }
         }
-    }
+        throw new CodeTaken(`${policy.style}:${policy.prefix ?? ''}:${attempts}`);
+    };
+    const codeScopeOf = (policy, draft) => policy.uniqueWithin === CodeScope.Parent ? { parent: draft.parent } : {};
+    return { slugOf, mintCode, codeScopeOf };
 };
-/**
- * Mint a code under a policy, asking `taken` for each candidate.
- *
- * `random` draws `prefix + Base58(length)` (upper-cased when asked) afresh per attempt; `slug`
- * walks `base`, `base-2`, `base-3` from the seed (a word slug without one); `sequential` counts on
- * from `opts.count`, zero-padded to `length`. After `attempts` taken candidates it refuses.
- *
- * @throws {CodeTaken}
- */
-export const mintCode = async (policy, taken, attempts = CODE_MINT_ATTEMPTS, opts) => {
-    const seeded = opts?.seed != null ? slugOf(opts.seed, CODE_MAX - (policy.prefix?.length ?? 0) - 4) : '';
-    const base = policy.style === CodeStyle.Slug ? (seeded !== '' ? seeded : generateWordSlug()) : '';
-    for (let attempt = 0; attempt < attempts; ++attempt) {
-        const candidate = candidateOf(policy, attempt, base, opts);
-        if (!await taken(candidate)) {
-            return candidate;
-        }
-    }
-    throw new CodeTaken(`${policy.style}:${policy.prefix ?? ''}:${attempts}`);
-};
-/** Where a draft's code must be unique: its parent, or the whole entity. */
-export const codeScopeOf = (policy, draft) => policy.uniqueWithin === CodeScope.Parent ? { parent: draft.parent } : {};
+export const codeHelper = createCodeHelper();
+/** @deprecated compat:factory-refactor — use `codeHelper.slugOf(…)` */
+export const slugOf = (text, max = CODE_MAX) => codeHelper.slugOf(text, max);
+/** @deprecated compat:factory-refactor — use `codeHelper.mintCode(…)` */
+export const mintCode = async (policy, taken, attempts = CODE_MINT_ATTEMPTS, opts) => await codeHelper.mintCode(policy, taken, attempts, opts);
+/** @deprecated compat:factory-refactor — use `codeHelper.codeScopeOf(…)` */
+export const codeScopeOf = (policy, draft) => codeHelper.codeScopeOf(policy, draft);
 //# sourceMappingURL=code.js.map

package/build/helpers/code.js.map

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

package/build/helpers/index.d.ts

@@ -1,9 +1,21 @@
+export type * from './apply/types.js';
+export type * from './card/types.js';
+export type * from './changes/types.js';
+export type * from './code/types.js';
+export type * from './query/types.js';
+export type * from './scoped/types.js';
+export type * from './specification/types.js';
+export type * from './status/types.js';
+export type * from './validate/types.js';
+export type * from './wire/types.js';
 export * from './apply.js';
 export * from './card.js';
 export * from './changes.js';
 export * from './code.js';
 export * from './query.js';
+export * from './scoped.js';
 export * from './specification.js';
 export * from './status.js';
 export * from './validate.js';
+export * from './wire.js';
 //# sourceMappingURL=index.d.ts.map

package/build/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,iBAAiB,CAAA;AAEpC,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA"}

package/build/helpers/index.js

@@ -3,7 +3,9 @@ export * from './card.js';
 export * from './changes.js';
 export * from './code.js';
 export * from './query.js';
+export * from './scoped.js';
 export * from './specification.js';
 export * from './status.js';
 export * from './validate.js';
+export * from './wire.js';
 //# sourceMappingURL=index.js.map

package/build/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAWA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA"}

package/build/helpers/query/types.d.ts

@@ -0,0 +1,23 @@
+import type { Criteria, ListOptions, ResourceRecord } from '@owlmeans/resource';
+import type { RelationshipQuery, RelationshipWhere, Specification, SpecificationQuery, SummaryView, TransitionQuery, TransitionWhere, Workcard, WorkcardQuery } from '../../types.js';
+import type { Scope } from '../types.local.js';
+/** The ONE translation of a planning query into the store's criteria, and the views read from it. */
+export interface QueryHelper {
+    /**
+     * `WorkcardQuery` → `Criteria<Workcard>` — the ONE translation every store answers, so a query
+     * means the same thing in memory, in Mongo and in a client mirror.
+     *
+     * `entityId` always comes from the scope (a query that forgot it would be a cross-tenant read);
+     * `undefined` values are omitted. Paging and sorting are {@link QueryHelper.listOptionsOf}'s.
+     */
+    criteriaOf: (query?: WorkcardQuery | null, scope?: Scope) => Criteria<Workcard>;
+    /** Paging and sorting out of a query. `size: 0` (no limit) survives. */
+    listOptionsOf: <T extends ResourceRecord>(query?: ListOptions<T> | null) => ListOptions<T>;
+    /** The criteria over a parent's specifications. */
+    specCriteriaOf: (parent: string, query?: SpecificationQuery | null, scope?: Scope) => Criteria<Specification>;
+    linkWhereOf: (query: RelationshipQuery | null | undefined, scope: Scope) => RelationshipWhere;
+    transitionWhereOf: (query: TransitionQuery | null | undefined, scope: Scope) => TransitionWhere;
+    /** Counts of DIRECT children (`card.parent`) per parent, by intrinsic state. No key for a parent with none. */
+    summaryOf: (cards: Workcard[], parents: string[]) => SummaryView;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/query/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/query/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,eAAe,EACrG,eAAe,EAAE,QAAQ,EAAE,aAAa,EACzC,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9C,qGAAqG;AACrG,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC/E,wEAAwE;IACxE,aAAa,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAA;IAC1F,mDAAmD;IACnD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,QAAQ,CAAC,aAAa,CAAC,CAAA;IAC7G,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,KAAK,iBAAiB,CAAA;IAC7F,iBAAiB,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,KAAK,eAAe,CAAA;IAC/F,+GAA+G;IAC/G,SAAS,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,CAAA;CACjE"}

package/build/helpers/query/types.js

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

package/build/helpers/query/types.js.map

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

package/build/helpers/query.d.ts

@@ -1,39 +1,47 @@
 import type { Criteria, ListOptions, ResourceRecord, Sort } from '@owlmeans/resource';
-import type { PlanningScope, RelationshipQuery, RelationshipQueryWire, RelationshipWhere, Specification, SpecificationQuery, SpecificationQueryWire, SummaryQuery, SummaryQueryWire, SummaryView, TransitionQuery, TransitionQueryWire, TransitionWhere, Workcard, WorkcardQuery, WorkcardQueryWire } from '../types.js';
-type Scope = Pick<PlanningScope, 'entityId'>;
-/**
- * `WorkcardQuery` → `Criteria<Workcard>` — the ONE translation every store answers, so a query
- * means the same thing in memory, in Mongo and in a client mirror.
- *
- * `entityId` always comes from the scope (a query that forgot it would be a cross-tenant read);
- * `undefined` values are omitted. Paging and sorting are {@link listOptionsOf}'s.
- */
+import type { RelationshipQuery, RelationshipQueryWire, RelationshipWhere, Specification, SpecificationQuery, SpecificationQueryWire, SummaryQuery, SummaryQueryWire, SummaryView, TransitionQuery, TransitionQueryWire, TransitionWhere, Workcard, WorkcardQuery, WorkcardQueryWire } from '../types.js';
+import type { QueryHelper } from './query/types.js';
+import type { Scope } from './types.local.js';
+export declare const createQueryHelper: () => QueryHelper;
+export declare const queryHelper: QueryHelper;
+/** @deprecated compat:factory-refactor — use `queryHelper.criteriaOf(…)` */
 export declare const criteriaOf: (query?: WorkcardQuery | null, scope?: Scope) => Criteria<Workcard>;
-/** Paging and sorting out of a query. `size: 0` (no limit) survives. */
+/** @deprecated compat:factory-refactor — use `queryHelper.listOptionsOf(…)` */
 export declare const listOptionsOf: <T extends ResourceRecord>(query?: ListOptions<T> | null) => ListOptions<T>;
-/** The criteria over a parent's specifications. */
+/** @deprecated compat:factory-refactor — use `queryHelper.specCriteriaOf(…)` */
 export declare const specCriteriaOf: (parent: string, query?: SpecificationQuery | null, scope?: Scope) => Criteria<Specification>;
+/** @deprecated compat:factory-refactor — use `queryHelper.linkWhereOf(…)` */
 export declare const linkWhereOf: (query: RelationshipQuery | null | undefined, scope: Scope) => RelationshipWhere;
+/** @deprecated compat:factory-refactor — use `queryHelper.transitionWhereOf(…)` */
 export declare const transitionWhereOf: (query: TransitionQuery | null | undefined, scope: Scope) => TransitionWhere;
-/** Counts of DIRECT children (`card.parent`) per parent, by intrinsic state. No key for a parent with none. */
+/** @deprecated compat:factory-refactor — use `queryHelper.summaryOf(…)` */
 export declare const summaryOf: (cards: Workcard[], parents: string[]) => SummaryView;
-/** A list as one query value: comma-joined, or JSON when an element itself holds a comma. */
+/** @deprecated compat:factory-refactor — use `wireHelper.encodeList(…)` */
 export declare const encodeList: (value?: string | readonly string[] | null) => string | undefined;
-/** Every entry of a list query value, whatever shape the transport left it in. */
+/** @deprecated compat:factory-refactor — use `wireHelper.decodeList(…)` */
 export declare const decodeList: (value: unknown, key?: string) => string[] | undefined;
-/** `[{ field: 'order' }, { field: 'updatedAt', order: 'desc' }]` ⇄ `order,-updatedAt`. */
+/** @deprecated compat:factory-refactor — use `wireHelper.encodeSort(…)` */
 export declare const encodeSort: <T>(sort?: Sort<T>[] | null) => string | undefined;
+/** @deprecated compat:factory-refactor — use `wireHelper.decodeSort(…)` */
 export declare const decodeSort: <T>(value: unknown) => Sort<T>[] | undefined;
+/** @deprecated compat:factory-refactor — use `wireHelper.encodeWorkcardQuery(…)` */
 export declare const encodeWorkcardQuery: (query?: WorkcardQuery | null) => WorkcardQueryWire;
-/** @throws {PlanningError} `malformed:query:<key>` for a value that does not decode */
+/** @deprecated compat:factory-refactor — use `wireHelper.decodeWorkcardQuery(…)` */
 export declare const decodeWorkcardQuery: (wire?: WorkcardQueryWire | WorkcardQuery | null) => WorkcardQuery;
+/** @deprecated compat:factory-refactor — use `wireHelper.encodeSummaryQuery(…)` */
 export declare const encodeSummaryQuery: (query: SummaryQuery) => SummaryQueryWire;
+/** @deprecated compat:factory-refactor — use `wireHelper.decodeSummaryQuery(…)` */
 export declare const decodeSummaryQuery: (wire?: SummaryQueryWire | SummaryQuery | null) => SummaryQuery;
+/** @deprecated compat:factory-refactor — use `wireHelper.encodeTransitionQuery(…)` */
 export declare const encodeTransitionQuery: (query?: TransitionQuery | null) => TransitionQueryWire;
+/** @deprecated compat:factory-refactor — use `wireHelper.decodeTransitionQuery(…)` */
 export declare const decodeTransitionQuery: (wire?: TransitionQueryWire | TransitionQuery | null) => TransitionQuery;
+/** @deprecated compat:factory-refactor — use `wireHelper.encodeSpecificationQuery(…)` */
 export declare const encodeSpecificationQuery: (query?: SpecificationQuery | null) => SpecificationQueryWire;
+/** @deprecated compat:factory-refactor — use `wireHelper.decodeSpecificationQuery(…)` */
 export declare const decodeSpecificationQuery: (wire?: SpecificationQueryWire | SpecificationQuery | null) => SpecificationQuery;
+/** @deprecated compat:factory-refactor — use `wireHelper.encodeRelationshipQuery(…)` */
 export declare const encodeRelationshipQuery: (query?: RelationshipQuery | null) => RelationshipQueryWire;
+/** @deprecated compat:factory-refactor — use `wireHelper.decodeRelationshipQuery(…)` */
 export declare const decodeRelationshipQuery: (wire?: RelationshipQueryWire | RelationshipQuery | null) => RelationshipQuery;
-export {};
 //# sourceMappingURL=query.d.ts.map

package/build/helpers/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/helpers/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAGrF,OAAO,KAAK,EACiB,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EACrG,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EACtG,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAClG,MAAM,aAAa,CAAA;AAEpB,KAAK,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAA;AAQ5C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,WAAY,aAAa,GAAG,IAAI,UAAU,KAAK,KAAG,QAAQ,CAAC,QAAQ,CAiCzF,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,cAAc,UAAU,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,KAAG,WAAW,CAAC,CAAC,CAInG,CAAA;AAEF,mDAAmD;AACnD,eAAO,MAAM,cAAc,WACjB,MAAM,UAAU,kBAAkB,GAAG,IAAI,UAAU,KAAK,KAC/D,QAAQ,CAAC,aAAa,CAKI,CAAA;AAE7B,eAAO,MAAM,WAAW,UAAW,iBAAiB,GAAG,IAAI,GAAG,SAAS,SAAS,KAAK,KAAG,iBAKtF,CAAA;AAEF,eAAO,MAAM,iBAAiB,UAAW,eAAe,GAAG,IAAI,GAAG,SAAS,SAAS,KAAK,KAAG,eAO1F,CAAA;AAMF,+GAA+G;AAC/G,eAAO,MAAM,SAAS,UAAW,QAAQ,EAAE,WAAW,MAAM,EAAE,KAAG,WAWhE,CAAA;AAID,6FAA6F;AAC7F,eAAO,MAAM,UAAU,WAAY,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,IAAI,KAAG,MAAM,GAAG,SAc/E,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,UAAU,UAAW,OAAO,QAAO,MAAM,KAAY,MAAM,EAAE,GAAG,SAwB5E,CAAA;AA0CD,0FAA0F;AAC1F,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,KAAG,MAAM,GAAG,SAGI,CAAA;AAErE,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,OAAO,KAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,SAmB1D,CAAA;AAiBD,eAAO,MAAM,mBAAmB,WAAY,aAAa,GAAG,IAAI,KAAG,iBAgBjE,CAAA;AAEF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,UAAW,iBAAiB,GAAG,aAAa,GAAG,IAAI,KAAG,aAmBrF,CAAA;AAED,eAAO,MAAM,kBAAkB,UAAW,YAAY,KAAG,gBAIvD,CAAA;AAEF,eAAO,MAAM,kBAAkB,UAAW,gBAAgB,GAAG,YAAY,GAAG,IAAI,KAAG,YAOlF,CAAA;AAED,eAAO,MAAM,qBAAqB,WAAY,eAAe,GAAG,IAAI,KAAG,mBAOrE,CAAA;AAEF,eAAO,MAAM,qBAAqB,UAAW,mBAAmB,GAAG,eAAe,GAAG,IAAI,KAAG,eAU3F,CAAA;AAED,eAAO,MAAM,wBAAwB,WAAY,kBAAkB,GAAG,IAAI,KAAG,sBAI3E,CAAA;AAEF,eAAO,MAAM,wBAAwB,UAAW,sBAAsB,GAAG,kBAAkB,GAAG,IAAI,KAAG,kBAOpG,CAAA;AAED,eAAO,MAAM,uBAAuB,WAAY,iBAAiB,GAAG,IAAI,KAAG,qBAKzE,CAAA;AAEF,eAAO,MAAM,uBAAuB,UAAW,qBAAqB,GAAG,iBAAiB,GAAG,IAAI,KAAG,iBAQjG,CAAA"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/helpers/query.ts"],"names":[],"mappings":"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"}