@origintrail-official/dkg-query 10.0.23 → 10.0.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/dist/content-partition-policy.d.ts +27 -0
  2. package/dist/content-partition-policy.d.ts.map +1 -0
  3. package/dist/content-partition-policy.js +18 -0
  4. package/dist/content-partition-policy.js.map +1 -0
  5. package/dist/dkg-query-engine.d.ts +5 -6
  6. package/dist/dkg-query-engine.d.ts.map +1 -1
  7. package/dist/dkg-query-engine.js +122 -407
  8. package/dist/dkg-query-engine.js.map +1 -1
  9. package/dist/index.d.ts +2 -0
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +2 -0
  12. package/dist/index.js.map +1 -1
  13. package/dist/legacy-route-scope.d.ts +4 -0
  14. package/dist/legacy-route-scope.d.ts.map +1 -0
  15. package/dist/legacy-route-scope.js +10 -0
  16. package/dist/legacy-route-scope.js.map +1 -0
  17. package/dist/query-binding.d.ts +4 -0
  18. package/dist/query-binding.d.ts.map +1 -0
  19. package/dist/query-binding.js +6 -0
  20. package/dist/query-binding.js.map +1 -0
  21. package/dist/query-engine.d.ts +16 -0
  22. package/dist/query-engine.d.ts.map +1 -1
  23. package/dist/query-handler.d.ts +2 -0
  24. package/dist/query-handler.d.ts.map +1 -1
  25. package/dist/query-handler.js +10 -9
  26. package/dist/query-handler.js.map +1 -1
  27. package/dist/query-read-plan.d.ts +40 -0
  28. package/dist/query-read-plan.d.ts.map +1 -0
  29. package/dist/query-read-plan.js +37 -0
  30. package/dist/query-read-plan.js.map +1 -0
  31. package/dist/query-result-size-error.d.ts +10 -0
  32. package/dist/query-result-size-error.d.ts.map +1 -0
  33. package/dist/query-result-size-error.js +16 -0
  34. package/dist/query-result-size-error.js.map +1 -0
  35. package/dist/query-store-options.d.ts +4 -0
  36. package/dist/query-store-options.d.ts.map +1 -0
  37. package/dist/query-store-options.js +12 -0
  38. package/dist/query-store-options.js.map +1 -0
  39. package/dist/query-store-read-context.d.ts +17 -0
  40. package/dist/query-store-read-context.d.ts.map +1 -0
  41. package/dist/query-store-read-context.js +49 -0
  42. package/dist/query-store-read-context.js.map +1 -0
  43. package/dist/registered-sub-graphs.d.ts +6 -0
  44. package/dist/registered-sub-graphs.d.ts.map +1 -0
  45. package/dist/registered-sub-graphs.js +19 -0
  46. package/dist/registered-sub-graphs.js.map +1 -0
  47. package/dist/scoped-content-graph-catalog.d.ts +16 -0
  48. package/dist/scoped-content-graph-catalog.d.ts.map +1 -0
  49. package/dist/scoped-content-graph-catalog.js +73 -0
  50. package/dist/scoped-content-graph-catalog.js.map +1 -0
  51. package/dist/scoped-content-graph-discovery-memo.d.ts +8 -3
  52. package/dist/scoped-content-graph-discovery-memo.d.ts.map +1 -1
  53. package/dist/scoped-content-graph-discovery-memo.js +6 -3
  54. package/dist/scoped-content-graph-discovery-memo.js.map +1 -1
  55. package/dist/scoped-content-partition.d.ts +4 -0
  56. package/dist/scoped-content-partition.d.ts.map +1 -0
  57. package/dist/scoped-content-partition.js +83 -0
  58. package/dist/scoped-content-partition.js.map +1 -0
  59. package/dist/sparql-empty-aggregate.d.ts +21 -0
  60. package/dist/sparql-empty-aggregate.d.ts.map +1 -0
  61. package/dist/sparql-empty-aggregate.js +272 -0
  62. package/dist/sparql-empty-aggregate.js.map +1 -0
  63. package/dist/sparql-graph-scope.d.ts +1 -1
  64. package/dist/sparql-graph-scope.d.ts.map +1 -1
  65. package/dist/sparql-graph-scope.js +3 -1
  66. package/dist/sparql-graph-scope.js.map +1 -1
  67. package/dist/sparql-guard.d.ts +9 -5
  68. package/dist/sparql-guard.d.ts.map +1 -1
  69. package/dist/sparql-guard.js +18 -6
  70. package/dist/sparql-guard.js.map +1 -1
  71. package/dist/static-scoped-route-graphs.d.ts +30 -0
  72. package/dist/static-scoped-route-graphs.d.ts.map +1 -0
  73. package/dist/static-scoped-route-graphs.js +85 -0
  74. package/dist/static-scoped-route-graphs.js.map +1 -0
  75. package/dist/withheld-graph-scope.d.ts +16 -0
  76. package/dist/withheld-graph-scope.d.ts.map +1 -0
  77. package/dist/withheld-graph-scope.js +24 -0
  78. package/dist/withheld-graph-scope.js.map +1 -0
  79. package/package.json +4 -4
@@ -0,0 +1,27 @@
1
+ /** The only internal decision about which discovered drafts a read may include. */
2
+ export type DraftAccessPolicy = {
3
+ readonly kind: 'all' | 'none';
4
+ } | {
5
+ readonly kind: 'owners';
6
+ readonly owners: readonly string[];
7
+ };
8
+ /** Normalize the trusted-engine default; external adapters supply their caller policy. */
9
+ export declare function resolveDraftAccessPolicy(options?: {
10
+ draftAccess?: DraftAccessPolicy;
11
+ }): DraftAccessPolicy;
12
+ interface ContentPartitionScope {
13
+ readonly graph: string;
14
+ readonly subGraphName?: string;
15
+ readonly broadScopeEligible: boolean;
16
+ }
17
+ export type ContentPartition = ContentPartitionScope & ({
18
+ readonly kind: 'draft';
19
+ readonly draftOwner: string | null;
20
+ } | {
21
+ readonly kind: 'content' | 'shared' | 'verified';
22
+ readonly draftOwner?: never;
23
+ });
24
+ /** Apply caller policy to classified discovery, before merging static route graphs. */
25
+ export declare function selectContentPartitions(partitions: readonly ContentPartition[], draftAccess: DraftAccessPolicy, subGraphName?: string): string[];
26
+ export {};
27
+ //# sourceMappingURL=content-partition-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"content-partition-policy.d.ts","sourceRoot":"","sources":["../src/content-partition-policy.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpE,0FAA0F;AAC1F,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACjD,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC,GAAG,iBAAiB,CAEpB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AACD,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,CAEnD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,CACpF,CAAC;AACF,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,EAC7E,WAAW,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQjE"}
@@ -0,0 +1,18 @@
1
+ import { knowledgeAssetAgentAddressesEqual } from '@origintrail-official/dkg-core';
2
+ /** Normalize the trusted-engine default; external adapters supply their caller policy. */
3
+ export function resolveDraftAccessPolicy(options) {
4
+ return options?.draftAccess ?? { kind: 'all' };
5
+ }
6
+ /** Apply caller policy to classified discovery, before merging static route graphs. */
7
+ export function selectContentPartitions(partitions, draftAccess, subGraphName) {
8
+ return partitions.filter(partition => {
9
+ if (subGraphName ? partition.subGraphName !== subGraphName : !partition.broadScopeEligible)
10
+ return false;
11
+ if (partition.kind !== 'draft' || draftAccess.kind === 'all')
12
+ return true;
13
+ const owner = partition.draftOwner;
14
+ return draftAccess.kind === 'owners' && owner !== null
15
+ && draftAccess.owners.some(allowed => knowledgeAssetAgentAddressesEqual(allowed, owner));
16
+ }).map(partition => partition.graph);
17
+ }
18
+ //# sourceMappingURL=content-partition-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"content-partition-policy.js","sourceRoot":"","sources":["../src/content-partition-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAMnF,0FAA0F;AAC1F,MAAM,UAAU,wBAAwB,CAAC,OAExC;IACC,OAAO,OAAO,EAAE,WAAW,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAYD,uFAAuF;AACvF,MAAM,UAAU,uBAAuB,CAAC,UAAuC,EAC7E,WAA8B,EAAE,YAAqB;IACrD,OAAO,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;QACnC,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB;YAAE,OAAO,KAAK,CAAC;QACzG,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,WAAW,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAC1E,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC;QACnC,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;eACjD,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,iCAAiC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}
@@ -54,6 +54,9 @@ export declare class DKGQueryEngine implements GraphAwareQueryEngine {
54
54
  private readonly scopedContentGraphDiscoveryMemo;
55
55
  constructor(store: TripleStore);
56
56
  query(sparql: string, options?: QueryOptions): Promise<QueryResult>;
57
+ private queryScoped;
58
+ private executeScoped;
59
+ private execWithExclusions;
57
60
  /**
58
61
  * Remove bindings that contain values matching excluded graph URI prefixes.
59
62
  * This prevents private CG data from leaking into unscoped queries.
@@ -92,12 +95,8 @@ export declare class DKGQueryEngine implements GraphAwareQueryEngine {
92
95
  * the publisher's `resolveKaNumber`.
93
96
  */
94
97
  private resolveWorkingMemoryKaNumber;
95
- private resolveScopedGraphVariableAllowList;
96
- private resolveScopedContentGraphAllowList;
97
- private discoverScopedContentGraphAllowList;
98
- private discoverRegisteredSubGraphNames;
99
- private discoverRegisteredAssertionGraphs;
100
- private discoverKnownChildContextGraphUris;
98
+ private resolveScopedContentGraphDiscovery;
99
+ private discoverScopedContentGraphDiscovery;
101
100
  /**
102
101
  * Execute CALLER-derived SPARQL and mark a store rejection with provenance.
103
102
  *
@@ -1 +1 @@
1
- {"version":3,"file":"dkg-query-engine.d.ts","sourceRoot":"","sources":["../src/dkg-query-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,mCAAmC,CAAC;AAW3C,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,qBAAqB,EAErB,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EASL,KAAK,OAAO,EAEZ,UAAU,EAMX,MAAM,gCAAgC,CAAC;AAuBxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAKpE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AA+DD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE;IACL,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,cAAc,CAuLhB;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,qBAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAkC;gBAEtE,KAAK,EAAE,WAAW;IAQxB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAyPzE;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;YACW,aAAa;YAsLb,mBAAmB;YAmGnB,sBAAsB;IAkBpC;;;;;;;;;OASG;YACW,qCAAqC;IAYnD;;;;;;;OAOG;YACW,gCAAgC;IAmE9C;;;;;OAKG;YACW,4BAA4B;YAuB5B,mCAAmC;YAuBnC,kCAAkC;YAoBlC,mCAAmC;YAuCnC,+BAA+B;YAyB/B,iCAAiC;YAwBjC,kCAAkC;IA8BhD;;;;;;;;;;;OAWG;YACW,eAAe;YAYf,gBAAgB;IAsBxB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAU7D,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAe3D,oBAAoB;YAsCpB,yBAAyB;IAkFvC;;OAEG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAYlE"}
1
+ {"version":3,"file":"dkg-query-engine.d.ts","sourceRoot":"","sources":["../src/dkg-query-engine.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,mCAAmC,CAAC;AAW3C,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,qBAAqB,EAErB,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAQL,KAAK,OAAO,EAEZ,UAAU,EAMX,MAAM,gCAAgC,CAAC;AAuBxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAKpE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE;IACL,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,cAAc,CAuLhB;AAID;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,qBAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAkC;gBAEtE,KAAK,EAAE,WAAW;IAQxB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA2CzE,OAAO,CAAC,WAAW;YAiBL,aAAa;YA+Bb,kBAAkB;IAMhC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;YACW,aAAa;YAuLb,mBAAmB;YAmGnB,sBAAsB;IAQpC;;;;;;;;;OASG;YACW,qCAAqC;IAYnD;;;;;;;OAOG;YACW,gCAAgC;IAmE9C;;;;;OAKG;YACW,4BAA4B;YAuB5B,kCAAkC;YAiBlC,mCAAmC;IA0BjD;;;;;;;;;;;OAWG;YACW,eAAe;YAaf,gBAAgB;IAsBxB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAU7D,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAe3D,oBAAoB;YAsCpB,yBAAyB;IAkFvC;;OAEG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAYlE"}