@_linked/core 2.36.1 → 2.36.3

package/lib/esm/queries/QueryContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueryContext.js","sourceRoot":"","sources":["../../../src/queries/QueryContext.ts"],"names":[],"mappings":"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","sourcesContent":["import {type QShape, QueryShape} from './SelectQuery.js';\nimport {Shape, createShapeTarget} from '../shapes/Shape.js';\nimport {brandLinkedError} from '../utils/linkedError.js';\n\nconst queryContext = new Map<string, QShape<any, any, any>>();\n\n/**\n * A live reference returned by getQueryContext when the context hasn't been set yet.\n * Its `id` getter resolves lazily from the global context map, so queries built with\n * a PendingQueryContext will pick up the value once it's set (e.g. after auth completes).\n */\nexport class PendingQueryContext {\n  constructor(public readonly contextName: string) {}\n\n  get id(): string | undefined {\n    return queryContext.get(this.contextName)?.id;\n  }\n}\n\n/**\n * Thrown when a query carrying a context reference is lowered but the context\n * isn't set in the current process. A context ref is carried in DSL-JSON and\n * resolves at lowering time against whatever context map is available (e.g.\n * server-side auth); if it can't resolve, lowering throws this rather than\n * silently producing a subject-less query.\n */\nexport class UnresolvedContextError extends Error {\n  constructor(public readonly contextName: string) {\n    super(\n      `Query context \"${contextName}\" is not set and could not be resolved at lowering time.`,\n    );\n    this.name = 'UnresolvedContextError';\n  }\n}\nbrandLinkedError(UnresolvedContextError, '@_linked/core', 'UnresolvedContextError');\n\n/** Listener notified (with the changed context name) whenever a context is set or cleared. */\nexport type QueryContextListener = (name: string) => void;\nconst contextListeners = new Set<QueryContextListener>();\n\n/**\n * Subscribe to query-context changes. Returns an unsubscribe function.\n *\n * This is the primitive that makes context resolution reactive: a consuming layer\n * (e.g. React components) subscribes and re-runs affected queries when the context\n * lands — so a query that resolved to `null` while the context was unset simply\n * re-runs and resolves once it's available (\"waiting\"), and re-runs again on any\n * later change (\"auto re-resolve\"). Core only emits the change; re-execution is the\n * consumer's responsibility.\n */\nexport function subscribeQueryContext(listener: QueryContextListener): () => void {\n  contextListeners.add(listener);\n  return () => contextListeners.delete(listener);\n}\n\nfunction notifyContextChange(name: string): void {\n  // Snapshot so a listener that (un)subscribes or re-sets a context during\n  // notification can't mutate the set mid-iteration.\n  for (const listener of [...contextListeners]) {\n    try {\n      listener(name);\n    } catch (err) {\n      // A listener must never break setQueryContext for the others.\n      console.error('[linked] query context listener failed', err);\n    }\n  }\n}\n\n/**\n * Normalize any query-context value to a {@link PendingQueryContext} carrying its name,\n * or return `undefined` if the value is not a context reference.\n *\n * A context appears in two runtime forms: a `PendingQueryContext` (the context was unset\n * when `getQueryContext()` was called) or a resolved `QueryShape` stamped with\n * `__queryContextName` (it was already set). Both must be treated as the same `{@ctx}`\n * reference wherever a node value/id is accepted (mutation field values, delete ids), so\n * that context-bound mutations behave identically whether the context is set or unset at\n * build time — resolution always happens at lowering.\n */\nexport function asContextRef(value: unknown): PendingQueryContext | undefined {\n  if (value instanceof PendingQueryContext) return value;\n  if (!value || typeof value !== 'object') return undefined;\n  // A resolved context is a QueryShape proxy wrapping a Shape stamped with\n  // `__queryContextName`. Read it via `originalValue` (a known QueryShape field)\n  // so we don't trip the proxy's \"undecorated property\" guard (it now throws);\n  // a bare Shape\n  // carries the stamp directly.\n  const v = value as {originalValue?: {__queryContextName?: unknown}; __queryContextName?: unknown};\n  const source = v.originalValue ?? v;\n  const name = (source as {__queryContextName?: unknown}).__queryContextName;\n  if (typeof name === 'string') return new PendingQueryContext(name);\n  return undefined;\n}\n\nexport function getQueryContext<T extends Shape>(name: string): QShape<T> {\n  if (queryContext.has(name)) {\n    return queryContext.get(name);\n  }\n  // Return a live reference that resolves lazily when the context is set.\n  // This avoids the timing issue where module-level queries capture null\n  // because the context hasn't been set yet (e.g. useEffect hasn't fired).\n  return new PendingQueryContext(name) as any;\n}\n\nexport function setQueryContext(name: string, value: any, shapeType?) {\n  // Clearing a context entry\n  if (!value) {\n    queryContext.delete(name);\n    notifyContextChange(name);\n    return;\n  }\n\n  // Already a QShape — stamp the underlying shape and store as-is. (Checked before\n  // the plain-`{id}` branch below: a QueryShape's `.id` getter is also a string, so\n  // testing for `{id}` first would wrongly require a shapeType and no-op.)\n  if (value instanceof QueryShape) {\n    const orig = (value as any).originalValue;\n    if (orig) {\n      orig.__queryContextName = name;\n      if (typeof orig.id === 'string') orig.__queryContextId = orig.id;\n    }\n    queryContext.set(name, value as any);\n    notifyContextChange(name);\n    return;\n  }\n\n  // A Shape-shaped value (e.g. a `createShapeTarget` proxy target) — stamp it and\n  // wrap as a QShape. Needs no shapeType (it already carries its shape class).\n  if (value instanceof Shape) {\n    value.__queryContextName = name;\n    if (typeof value.id === 'string') value.__queryContextId = value.id;\n    queryContext.set(name, new QueryShape(value) as any);\n    notifyContextChange(name);\n    return;\n  }\n\n  // A plain QResult `{id}` — materialize a shape (requires shapeType).\n  if (typeof value.id === 'string') {\n    if (!shapeType) {\n      // A silent no-op here is a trap: the context never sets and the caller\n      // gets no signal. A `{id}` value cannot be materialized without its shape.\n      throw new Error(\n        `setQueryContext('${name}'): a {id} value requires a shapeType so the shape can be materialized. Pass the Shape class as the third argument.`,\n      );\n    }\n    const shape = createShapeTarget(shapeType as any, value.id);\n    shape.__queryContextId = value.id;\n    shape.__queryContextName = name;\n    queryContext.set(name, QueryShape.create(shape) as any);\n    notifyContextChange(name);\n    return;\n  }\n\n  throw new Error(\n    `setQueryContext('${name}'): value is not a QueryShape, Shape, or {id} result. Got ${typeof value}. Pass a Shape instance, a query-context shape, or a {id} result (with its shapeType).`,\n  );\n}\n"]}
+{"version":3,"file":"QueryContext.js","sourceRoot":"","sources":["../../../src/queries/QueryContext.ts"],"names":[],"mappings":"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","sourcesContent":["import {type QShape, QueryShape} from './SelectQuery.js';\nimport {Shape, createShapeTarget} from '../shapes/Shape.js';\nimport {brandLinkedClass, brandLinkedError, isLinkedInstance} from '../utils/linkedError.js';\nimport {sharedState} from '../utils/sharedState.js';\n\n/**\n * The context map and its listeners, shared by every copy of core in the runtime: a context\n * the app sets through one copy must resolve for a query lowered by the other, and a React\n * layer subscribed through one copy must hear a change made through the other.\n */\nconst contextState = sharedState('@_linked/core', 'QueryContext', () => ({\n  contexts: new Map<string, QShape<any, any, any>>(),\n  listeners: new Set<QueryContextListener>(),\n}));\nconst queryContext = contextState.contexts;\n\n/**\n * A live reference returned by getQueryContext when the context hasn't been set yet.\n * Its `id` getter resolves lazily from the global context map, so queries built with\n * a PendingQueryContext will pick up the value once it's set (e.g. after auth completes).\n */\nexport class PendingQueryContext {\n  constructor(public readonly contextName: string) {}\n\n  get id(): string | undefined {\n    return queryContext.get(this.contextName)?.id;\n  }\n}\nbrandLinkedClass(PendingQueryContext, '@_linked/core', 'PendingQueryContext');\n\n\n/**\n * Thrown when a query carrying a context reference is lowered but the context\n * isn't set in the current process. A context ref is carried in DSL-JSON and\n * resolves at lowering time against whatever context map is available (e.g.\n * server-side auth); if it can't resolve, lowering throws this rather than\n * silently producing a subject-less query.\n */\nexport class UnresolvedContextError extends Error {\n  constructor(public readonly contextName: string) {\n    super(\n      `Query context \"${contextName}\" is not set and could not be resolved at lowering time.`,\n    );\n    this.name = 'UnresolvedContextError';\n  }\n}\nbrandLinkedError(UnresolvedContextError, '@_linked/core', 'UnresolvedContextError');\n\n/** Listener notified (with the changed context name) whenever a context is set or cleared. */\nexport type QueryContextListener = (name: string) => void;\nconst contextListeners = contextState.listeners;\n\n/**\n * Subscribe to query-context changes. Returns an unsubscribe function.\n *\n * This is the primitive that makes context resolution reactive: a consuming layer\n * (e.g. React components) subscribes and re-runs affected queries when the context\n * lands — so a query that resolved to `null` while the context was unset simply\n * re-runs and resolves once it's available (\"waiting\"), and re-runs again on any\n * later change (\"auto re-resolve\"). Core only emits the change; re-execution is the\n * consumer's responsibility.\n */\nexport function subscribeQueryContext(listener: QueryContextListener): () => void {\n  contextListeners.add(listener);\n  return () => contextListeners.delete(listener);\n}\n\nfunction notifyContextChange(name: string): void {\n  // Snapshot so a listener that (un)subscribes or re-sets a context during\n  // notification can't mutate the set mid-iteration.\n  for (const listener of [...contextListeners]) {\n    try {\n      listener(name);\n    } catch (err) {\n      // A listener must never break setQueryContext for the others.\n      console.error('[linked] query context listener failed', err);\n    }\n  }\n}\n\n/**\n * Normalize any query-context value to a {@link PendingQueryContext} carrying its name,\n * or return `undefined` if the value is not a context reference.\n *\n * A context appears in two runtime forms: a `PendingQueryContext` (the context was unset\n * when `getQueryContext()` was called) or a resolved `QueryShape` stamped with\n * `__queryContextName` (it was already set). Both must be treated as the same `{@ctx}`\n * reference wherever a node value/id is accepted (mutation field values, delete ids), so\n * that context-bound mutations behave identically whether the context is set or unset at\n * build time — resolution always happens at lowering.\n */\nexport function asContextRef(value: unknown): PendingQueryContext | undefined {\n  if (isLinkedInstance(value, PendingQueryContext)) return value;\n  if (!value || typeof value !== 'object') return undefined;\n  // A resolved context is a QueryShape proxy wrapping a Shape stamped with\n  // `__queryContextName`. Read it via `originalValue` (a known QueryShape field)\n  // so we don't trip the proxy's \"undecorated property\" guard (it now throws);\n  // a bare Shape\n  // carries the stamp directly.\n  const v = value as {originalValue?: {__queryContextName?: unknown}; __queryContextName?: unknown};\n  const source = v.originalValue ?? v;\n  const name = (source as {__queryContextName?: unknown}).__queryContextName;\n  if (typeof name === 'string') return new PendingQueryContext(name);\n  return undefined;\n}\n\nexport function getQueryContext<T extends Shape>(name: string): QShape<T> {\n  if (queryContext.has(name)) {\n    return queryContext.get(name);\n  }\n  // Return a live reference that resolves lazily when the context is set.\n  // This avoids the timing issue where module-level queries capture null\n  // because the context hasn't been set yet (e.g. useEffect hasn't fired).\n  return new PendingQueryContext(name) as any;\n}\n\nexport function setQueryContext(name: string, value: any, shapeType?) {\n  // Clearing a context entry\n  if (!value) {\n    queryContext.delete(name);\n    notifyContextChange(name);\n    return;\n  }\n\n  // Already a QShape — stamp the underlying shape and store as-is. (Checked before\n  // the plain-`{id}` branch below: a QueryShape's `.id` getter is also a string, so\n  // testing for `{id}` first would wrongly require a shapeType and no-op.)\n  if (isLinkedInstance(value, QueryShape)) {\n    const orig = (value as any).originalValue;\n    if (orig) {\n      orig.__queryContextName = name;\n      if (typeof orig.id === 'string') orig.__queryContextId = orig.id;\n    }\n    queryContext.set(name, value as any);\n    notifyContextChange(name);\n    return;\n  }\n\n  // A Shape-shaped value (e.g. a `createShapeTarget` proxy target) — stamp it and\n  // wrap as a QShape. Needs no shapeType (it already carries its shape class).\n  if (isLinkedInstance(value, Shape)) {\n    value.__queryContextName = name;\n    if (typeof value.id === 'string') value.__queryContextId = value.id;\n    queryContext.set(name, new QueryShape(value) as any);\n    notifyContextChange(name);\n    return;\n  }\n\n  // A plain QResult `{id}` — materialize a shape (requires shapeType).\n  if (typeof value.id === 'string') {\n    if (!shapeType) {\n      // A silent no-op here is a trap: the context never sets and the caller\n      // gets no signal. A `{id}` value cannot be materialized without its shape.\n      throw new Error(\n        `setQueryContext('${name}'): a {id} value requires a shapeType so the shape can be materialized. Pass the Shape class as the third argument.`,\n      );\n    }\n    const shape = createShapeTarget(shapeType as any, value.id);\n    shape.__queryContextId = value.id;\n    shape.__queryContextName = name;\n    queryContext.set(name, QueryShape.create(shape) as any);\n    notifyContextChange(name);\n    return;\n  }\n\n  throw new Error(\n    `setQueryContext('${name}'): value is not a QueryShape, Shape, or {id} result. Got ${typeof value}. Pass a Shape instance, a query-context shape, or a {id} result (with its shapeType).`,\n  );\n}\n"]}

package/lib/esm/queries/SelectQuery.js

@@ -11,6 +11,7 @@ import { PropertyPath } from './PropertyPath.js';
 import { ExpressionNode, ExistsCondition, isExpressionNode, isExistsCondition, tracedPropertyExpression, tracedAliasExpression } from '../expressions/ExpressionNode.js';
 import { PendingQueryContext } from './QueryContext.js';
 import { unresolvedValueShapeError } from '../utils/unresolvedShape.js';
+import { brandLinkedClass, isLinkedInstance } from '../utils/linkedError.js';
 /**
  * String keys the query-shape proxy must let through *without* treating them as
  * a property access — promise-awaiting (`then`), React (`$$typeof`), and common
@@ -169,6 +170,7 @@ export class QueryBuilderObject {
         return path;
     }
 }
+brandLinkedClass(QueryBuilderObject, '@_linked/core', 'QueryBuilderObject');
 export class BoundComponent extends QueryBuilderObject {
     constructor(originalValue, source) {
         super(null, null);
@@ -261,7 +263,7 @@ function findContextName(qbo) {
     var _a;
     let current = qbo;
     while (current) {
-        if (current instanceof QueryShape && ((_a = current.originalValue) === null || _a === void 0 ? void 0 : _a.__queryContextName)) {
+        if (isLinkedInstance(current, QueryShape) && ((_a = current.originalValue) === null || _a === void 0 ? void 0 : _a.__queryContextName)) {
             return current.originalValue.__queryContextName;
         }
         current = current.subject;
@@ -303,7 +305,7 @@ function wrapWithExpressionProxy(qp) {
                     const baseNode = toExpressionNode(target);
                     return (...args) => {
                         // Convert QueryBuilderObject arguments to ExpressionNode
-                        const convertedArgs = args.map((arg) => { var _a; return arg instanceof QueryBuilderObject ? ((_a = toExpressionNode(arg)) !== null && _a !== void 0 ? _a : arg) : arg; });
+                        const convertedArgs = args.map((arg) => { var _a; return isLinkedInstance(arg, QueryBuilderObject) ? ((_a = toExpressionNode(arg)) !== null && _a !== void 0 ? _a : arg) : arg; });
                         return baseNode[key](...convertedArgs);
                     };
                 }
@@ -321,12 +323,12 @@ export const evaluateSortCallback = (shape, sortFn, direction = 'ASC') => {
     const response = sortFn(proxy);
     const nodeShape = shape.shape;
     const paths = [];
-    if (response instanceof QueryBuilderObject || response instanceof QueryPrimitiveSet) {
+    if (isLinkedInstance(response, QueryBuilderObject) || isLinkedInstance(response, QueryPrimitiveSet)) {
         paths.push(new PropertyPath(nodeShape, FieldSet.collectPropertySegments(response)));
     }
     else if (Array.isArray(response)) {
         for (const item of response) {
-            if (item instanceof QueryBuilderObject) {
+            if (isLinkedInstance(item, QueryBuilderObject)) {
                 paths.push(new PropertyPath(nodeShape, FieldSet.collectPropertySegments(item)));
             }
         }
@@ -427,7 +429,7 @@ export class QueryShapeSet extends QueryBuilderObject {
     }
     concat(other) {
         if (other) {
-            if (other instanceof QueryShapeSet) {
+            if (isLinkedInstance(other, QueryShapeSet)) {
                 other.queryShapes.forEach(this.queryShapes.add.bind(this.queryShapes));
             }
             else {
@@ -534,6 +536,7 @@ export class QueryShapeSet extends QueryBuilderObject {
         throw new Error('Expected a callback or ExpressionNode for some/every/none');
     }
 }
+brandLinkedClass(QueryShapeSet, '@_linked/core', 'QueryShapeSet');
 export class QueryShape extends QueryBuilderObject {
     constructor(originalValue, property, subject) {
         super(property, subject);
@@ -597,23 +600,23 @@ export class QueryShape extends QueryBuilderObject {
         const self = toExpressionNode(this);
         // An unresolved query-context reference (`getQueryContext('user')` before it
         // is set) carries no `.id` yet — keep it as a `{@ctx}` ref, resolved at lower.
-        if (otherValue instanceof PendingQueryContext) {
+        if (isLinkedInstance(otherValue, PendingQueryContext)) {
             return self.eq(otherValue);
         }
         //validate the value is formed correctly
         if (!otherValue.id) {
             throw Error(`Invalid value for .equals(). ${JSON.stringify(otherValue)}`);
         }
-        const arg = otherValue instanceof QueryBuilderObject
+        const arg = isLinkedInstance(otherValue, QueryBuilderObject)
             ? toExpressionNode(otherValue)
             : otherValue;
         return self.eq(arg);
     }
     oneOf(values) {
-        return toExpressionNode(this).oneOf(values.map((v) => (v instanceof QueryBuilderObject ? toExpressionNode(v) : v)));
+        return toExpressionNode(this).oneOf(values.map((v) => (isLinkedInstance(v, QueryBuilderObject) ? toExpressionNode(v) : v)));
     }
     notOneOf(values) {
-        return toExpressionNode(this).notOneOf(values.map((v) => (v instanceof QueryBuilderObject ? toExpressionNode(v) : v)));
+        return toExpressionNode(this).notOneOf(values.map((v) => (isLinkedInstance(v, QueryBuilderObject) ? toExpressionNode(v) : v)));
     }
     select(subQueryFn) {
         // A sub-select on a project-authored value shape has no authored class, so fall
@@ -640,6 +643,7 @@ export class QueryShape extends QueryBuilderObject {
         return this.select((shape) => propertyLabels.map((label) => shape[label]));
     }
 }
+brandLinkedClass(QueryShape, '@_linked/core', 'QueryShape');
 /**
  * Concrete query wrapper for JS primitive values (string, number, boolean, Date).
  *
@@ -656,16 +660,16 @@ export class QueryPrimitive extends QueryBuilderObject {
     }
     equals(otherValue) {
         const self = toExpressionNode(this);
-        const arg = otherValue instanceof QueryBuilderObject
+        const arg = isLinkedInstance(otherValue, QueryBuilderObject)
             ? toExpressionNode(otherValue)
             : otherValue;
         return self.eq(arg);
     }
     oneOf(values) {
-        return toExpressionNode(this).oneOf(values.map((v) => (v instanceof QueryBuilderObject ? toExpressionNode(v) : v)));
+        return toExpressionNode(this).oneOf(values.map((v) => (isLinkedInstance(v, QueryBuilderObject) ? toExpressionNode(v) : v)));
     }
     notOneOf(values) {
-        return toExpressionNode(this).notOneOf(values.map((v) => (v instanceof QueryBuilderObject ? toExpressionNode(v) : v)));
+        return toExpressionNode(this).notOneOf(values.map((v) => (isLinkedInstance(v, QueryBuilderObject) ? toExpressionNode(v) : v)));
     }
     where(validation) {
         // For inline where on a primitive (p.hobby.where(h => h.equals(...))),
@@ -677,6 +681,7 @@ export class QueryPrimitive extends QueryBuilderObject {
         return this;
     }
 }
+brandLinkedClass(QueryPrimitive, '@_linked/core', 'QueryPrimitive');
 export class QueryPrimitiveSet extends QueryBuilderObject {
     constructor(originalValue, property, subject, items) {
         super(property, subject);
@@ -730,6 +735,7 @@ export class QueryPrimitiveSet extends QueryBuilderObject {
         //countable, resultKey
     }
 }
+brandLinkedClass(QueryPrimitiveSet, '@_linked/core', 'QueryPrimitiveSet');
 export class SetSize extends QueryPrimitive {
     constructor(subject, countable, label) {
         super();