@haverstack/core 0.42.0 → 0.44.0

package/dist/adapter/index.d.ts

@@ -7,11 +7,16 @@
  * adapters). Types an app reads too, such as StackCapabilities, live in
  * the root entry point instead: every export has exactly one home.
  */
-export type { StackAdapter, StackRecordAdapter, StackBlobAdapter, BlobInfo, BumpVersionOptions, SnapshotOptions, JournalEntryInput, JournalOptions, MutateOptions, } from '../types/index.js';
-export { OwnerMismatchError } from '../errors.js';
+export type { AdapterQuery, PlainQuery, AdapterSort, StackAdapter, StackRecordAdapter, StackBlobAdapter, BlobInfo, SnapshotOptions, JournalEntryInput, JournalOptions, MutateOptions, AspectWriteOptions, ElementWriteOptions, Reach, RecordHistory, StoreSeed, } from '../types/index.js';
+export { sameAssociationSet } from '../associations/identity.js';
+export { ElementSetMovedError, FormatMismatchError, OwnerMismatchError, softDeletedRefusal, } from '../errors.js';
 export { combineAdapters } from './combine.js';
-export { assertQueryCapabilities, assertSortCapability, assertValidSort, assertValidAssociationFilters, assertValidJournalQuery, assertValidVersionsQuery, filtersContent, parseContentFilterKey, } from '../query-validation.js';
+export { copyStack } from './copy.js';
+export type { CreateStore } from './copy.js';
+export { newStoreSeed } from './seed.js';
+export { inReach } from './reach.js';
+export type { ReachedRecord } from './reach.js';
+export { assertQueryCapabilities, assertValidSort, resolveQuery, assertValidAssociationFilters, assertValidJournalQuery, assertValidVersionsQuery, filtersContent, parseContentFilterKey, } from '../query-validation.js';
 export { contentSortEntry, contentSortKey, compareSortEntries, constantSortEntry, sortConstant, } from './sort.js';
 export type { SortEntry } from './sort.js';
-export { AUTHORITY_ASSOCIATION_KINDS, partitionAssociations } from '../associations/identity.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/adapter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,EACL,aAAa,EACb,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,YAAY,EACZ,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/adapter/index.js

@@ -7,9 +7,12 @@
  * adapters). Types an app reads too, such as StackCapabilities, live in
  * the root entry point instead: every export has exactly one home.
  */
-export { OwnerMismatchError } from '../errors.js';
+export { sameAssociationSet } from '../associations/identity.js';
+export { ElementSetMovedError, FormatMismatchError, OwnerMismatchError, softDeletedRefusal, } from '../errors.js';
 export { combineAdapters } from './combine.js';
-export { assertQueryCapabilities, assertSortCapability, assertValidSort, assertValidAssociationFilters, assertValidJournalQuery, assertValidVersionsQuery, filtersContent, parseContentFilterKey, } from '../query-validation.js';
+export { copyStack } from './copy.js';
+export { newStoreSeed } from './seed.js';
+export { inReach } from './reach.js';
+export { assertQueryCapabilities, assertValidSort, resolveQuery, assertValidAssociationFilters, assertValidJournalQuery, assertValidVersionsQuery, filtersContent, parseContentFilterKey, } from '../query-validation.js';
 export { contentSortEntry, contentSortKey, compareSortEntries, constantSortEntry, sortConstant, } from './sort.js';
-export { AUTHORITY_ASSOCIATION_KINDS, partitionAssociations } from '../associations/identity.js';
 //# sourceMappingURL=index.js.map

package/dist/adapter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,YAAY,EACZ,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,WAAW,CAAC"}

package/dist/adapter/reach.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Matching a Reach in memory
+ * -------------------------------------------------------
+ * The one reading of a reach in JavaScript: MemoryAdapter matches a query
+ * with it, and ScopedStack asks it of each Record a verb would act on. A
+ * SQL adapter states the same conditions in its own query language. See
+ * docs/spec/access-control.md § Reach.
+ */
+import type { Reach, StackRecord } from '../types/index.js';
+/** What a reach asks of a Record — all a record yet to be created has to show. */
+export type ReachedRecord = Pick<StackRecord, 'typeId' | 'createdBy' | 'permissions'>;
+/** Whether `record` is inside the reach, matched by its family. */
+export declare function inReach(record: ReachedRecord, reach: Reach): boolean;
+//# sourceMappingURL=reach.d.ts.map

package/dist/adapter/reach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach.d.ts","sourceRoot":"","sources":["../../src/adapter/reach.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC,CAAC;AAEtF,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAmBpE"}

package/dist/adapter/reach.js

@@ -0,0 +1,31 @@
+/**
+ * Matching a Reach in memory
+ * -------------------------------------------------------
+ * The one reading of a reach in JavaScript: MemoryAdapter matches a query
+ * with it, and ScopedStack asks it of each Record a verb would act on. A
+ * SQL adapter states the same conditions in its own query language. See
+ * docs/spec/access-control.md § Reach.
+ */
+import { associationKey } from '../associations/identity.js';
+import { baseIdOf } from '../schema.js';
+/** Whether `record` is inside the reach, matched by its family. */
+export function inReach(record, reach) {
+    const family = baseIdOf(record.typeId);
+    if (reach.fence && !reach.fence.includes(family))
+        return false;
+    const within = reach.within;
+    if (!within)
+        return true;
+    if (within.baseIds.includes(family))
+        return true;
+    const authored = within.authored;
+    if (authored &&
+        authored.baseIds.includes(family) &&
+        record.createdBy?.subjectId === authored.subjectId) {
+        return true;
+    }
+    const held = new Set((record.permissions ?? []).map(associationKey));
+    held.delete(undefined);
+    return within.permissions.some((set) => set.length > 0 && set.every((element) => held.has(associationKey(element))));
+}
+//# sourceMappingURL=reach.js.map

package/dist/adapter/reach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach.js","sourceRoot":"","sources":["../../src/adapter/reach.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAMxC,mEAAmE;AACnE,MAAM,UAAU,OAAO,CAAC,MAAqB,EAAE,KAAY;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IACE,QAAQ;QACR,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QACjC,MAAM,CAAC,SAAS,EAAE,SAAS,KAAK,QAAQ,CAAC,SAAS,EAClD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAC5B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CACrF,CAAC;AACJ,CAAC"}

package/dist/adapter/seed.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Store seeds
+ * -------------------------------------------------------
+ * A store is created holding one Record, `_config`, which says whose stack
+ * it is. A seed is that Record with its history: fresh for a new stack, the
+ * source's own for a copy, so the one Record every store starts with is
+ * written the way every other Record is. See docs/spec/adapters.md
+ * § Construction.
+ */
+import type { ConfigContent, StoreSeed } from '../types/index.js';
+/** The seed of a stack that has no past: `_config` at version 1, holding `config`. */
+export declare function newStoreSeed(config: ConfigContent): StoreSeed;
+//# sourceMappingURL=seed.d.ts.map

package/dist/adapter/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/adapter/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGlE,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAa7D"}

package/dist/adapter/seed.js

@@ -0,0 +1,26 @@
+/**
+ * Store seeds
+ * -------------------------------------------------------
+ * A store is created holding one Record, `_config`, which says whose stack
+ * it is. A seed is that Record with its history: fresh for a new stack, the
+ * source's own for a copy, so the one Record every store starts with is
+ * written the way every other Record is. See docs/spec/adapters.md
+ * § Construction.
+ */
+import { SYSTEM_TYPES } from '../types/index.js';
+/** The seed of a stack that has no past: `_config` at version 1, holding `config`. */
+export function newStoreSeed(config) {
+    const now = new Date();
+    return {
+        config: {
+            id: SYSTEM_TYPES.CONFIG,
+            typeId: `${SYSTEM_TYPES.CONFIG}@1`,
+            createdAt: now,
+            updatedAt: now,
+            content: { ...config },
+            version: 1,
+        },
+        history: { versions: [], journal: [] },
+    };
+}
+//# sourceMappingURL=seed.js.map

package/dist/adapter/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/adapter/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,YAAY,CAAC,MAAM;YACvB,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,IAAI;YAClC,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE;YACtB,OAAO,EAAE,CAAC;SACX;QACD,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;KACvC,CAAC;AACJ,CAAC"}

package/dist/associations/identity.d.ts

@@ -9,19 +9,17 @@
  */
 import type { Association, AssociationChange, AssociationEdit, AuthorityAssociation, DataAssociation, Grantee, RelationshipTarget } from '../types/index.js';
 /**
- * Association identity — what dissociate() matches and a repeat associate()
+ * Association identity — what a remove edit matches and a repeat add
  * collides with; the SQLite adapter's primary key. An attachment's
  * `attachmentRecordId` annotates a reference rather than naming one, so it
  * is outside; a group grantee's `role` names a different set of people, so
  * it is inside. See docs/spec/data-model.md § Associations.
  */
+export declare function associationKey(a: Association): string | undefined;
+/** Whether two associations are the same one — see associationKey(). */
 export declare function associationEqual(a: Association, b: Association): boolean;
-/**
- * Structural equality per grantee arm. `role` is required, so there is no
- * absent-means-any spelling to normalize.
- */
 export declare function granteeEqual(a: Grantee, b: Grantee): boolean;
-/** Structural equality per target arm — what dissociate() matches on. */
+/** Structural equality per target arm — what a remove edit matches on. */
 export declare function targetEqual(a: RelationshipTarget, b: RelationshipTarget): boolean;
 /**
  * Identity plus every annotation outside it, so a write that only re-points
@@ -30,35 +28,26 @@ export declare function targetEqual(a: RelationshipTarget, b: RelationshipTarget
  * this decides whether it says anything new.
  */
 export declare function associationIdentical(a: Association, b: Association): boolean;
-/**
- * The association kinds that carry authority. Every other kind is data.
- * Storage that partitions by kind in a query reads this list rather than
- * restating it, so a new authority kind can't fall into the data half.
- */
-export declare const AUTHORITY_ASSOCIATION_KINDS: readonly AuthorityAssociation['kind'][];
 /**
  * Whether an association carries authority rather than data — the partition
  * `StackRecord.permissions` and `StackRecord.associations` project, and the
- * line `associate()`/`dissociate()` refuse to cross.
+ * line the association verbs refuse to cross.
  * See docs/spec/access-control.md § Record-level permissions.
  */
 export declare function isAuthorityAssociation(a: Association): a is AuthorityAssociation;
 /**
- * One stored association set split into the two the record presents. An app
- * editing tags never sees the authority half, so it cannot drop it.
+ * What replacing a record's set with `after` moves, one tagged edit each.
+ * An entry matching an existing identity displaced it: a `repoint`,
+ * carrying the prior association in full as `previous` — the only place
+ * an overwritten `attachmentRecordId` survives.
+ * See docs/spec/journal.md § The entry.
  */
-export declare function partitionAssociations(associations: Association[]): {
-    associations: DataAssociation[];
-    permissions: AuthorityAssociation[];
-};
+export declare function associationDelta(before: readonly Association[], after: readonly Association[]): AssociationChange[];
 /**
- * What a `changes.associations` list moves against a record's current set,
- * one tagged edit each. An entry matching an existing identity displaced it:
- * a `repoint`, carrying the prior association in full as `previous` — the
- * only place an overwritten `attachmentRecordId` survives.
- * See docs/spec/journal.md § The entry.
+ * Whether two sets hold the same elements, annotations included, in any
+ * order — what an element-set write's `expectSet` is compared by.
  */
-export declare function associationDelta(before: Association[], after: Association[]): AssociationChange[];
+export declare function sameAssociationSet(a: readonly Association[], b: readonly Association[]): boolean;
 /**
  * The two flat lists a change frame carries, derived from the tagged list.
  * The feed reports what is true now, so a `repoint` appears only under its
@@ -70,24 +59,11 @@ export declare function feedAssociationDelta(changes: AssociationChange[]): {
     added: DataAssociation[];
     removed: DataAssociation[];
 };
+/** The elements an edit list adds. */
+export declare function addsOf(edits: readonly AssociationEdit[]): Association[];
 /**
- * An association edit list travels one surface: authority and data share
- * storage and a delta, and never share a call. Refused here so every
- * adapter inherits the same rule.
- * See docs/spec/access-control.md § Storage unifies; the API does not.
- */
-export declare function assertOneSurface(changes: readonly AssociationEdit[]): void;
-/**
- * The set a list of edits leaves behind: removes first, then adds, an add
- * landing on an identity already held in place. Adds naming one identity
- * collapse, last wins; an add outlives a remove of the same identity.
- * See docs/spec/adapters.md § Amending associations.
+ * The set a list of edits leaves behind, an add landing on an identity
+ * already held in place. See docs/spec/adapters.md § Editing associations.
  */
 export declare function applyAssociationEdits(current: Association[], changes: readonly AssociationEdit[]): Association[];
-/**
- * The same op over every element of a list — what associate(),
- * dissociate(), grantAccess() and revokeAccess() hand to the amend verb
- * each is one half of.
- */
-export declare function editsOf(op: 'add' | 'remove', associations: Association[]): AssociationEdit[];
 //# sourceMappingURL=identity.d.ts.map

package/dist/associations/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/associations/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,OAAO,EACP,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAaxE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAQ5D;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAQjF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAM5E;AAcD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,oBAAoB,CAAC,MAAM,CAAC,EAG9E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,IAAI,oBAAoB,CAEhF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG;IAClE,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC,CAKA;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,iBAAiB,EAAE,CAcjG;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG;IAClE,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAYA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAO1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,WAAW,EAAE,CAWf;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,KAAK,GAAG,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAE5F"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/associations/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,OAAO,EACP,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAajE;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAGxE;AAYD,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAG5D;AAUD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAGjF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAM5E;AAoBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,IAAI,oBAAoB,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,KAAK,EAAE,SAAS,WAAW,EAAE,GAC5B,iBAAiB,EAAE,CAcrB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,SAAS,WAAW,EAAE,EAAE,CAAC,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG;IAClE,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAYA;AAED,sCAAsC;AACtC,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,WAAW,EAAE,CAEvE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,WAAW,EAAE,CAWf"}

package/dist/associations/identity.js

@@ -7,59 +7,61 @@
  * applying edits, the feed — so they answer it with one comparison and
  * can never disagree. See docs/spec/data-model.md § Associations.
  */
-import { StackBadRequestError } from '../errors.js';
 /**
- * Association identity — what dissociate() matches and a repeat associate()
+ * Association identity — what a remove edit matches and a repeat add
  * collides with; the SQLite adapter's primary key. An attachment's
  * `attachmentRecordId` annotates a reference rather than naming one, so it
  * is outside; a group grantee's `role` names a different set of people, so
  * it is inside. See docs/spec/data-model.md § Associations.
  */
-export function associationEqual(a, b) {
-    // Never "the same one": naming a malformed association is
+export function associationKey(a) {
+    // No key, so never "the same one": naming a malformed association is
     // validateAssociation()'s job, which this must reach without throwing.
-    if (!a || !b)
-        return false;
-    if (a.kind !== b.kind || a.label !== b.label)
-        return false;
-    if (a.kind === 'attachment' && b.kind === 'attachment')
-        return a.fileId === b.fileId;
-    if (a.kind === 'relationship' && b.kind === 'relationship') {
-        return targetEqual(a.target, b.target);
-    }
-    if (a.kind === 'permission' && b.kind === 'permission') {
-        return granteeEqual(a.grantee, b.grantee);
-    }
-    return true;
+    if (!a)
+        return undefined;
+    const arm = a.kind === 'attachment'
+        ? [a.fileId]
+        : a.kind === 'relationship'
+            ? targetParts(a.target)
+            : a.kind === 'permission'
+                ? granteeParts(a.grantee)
+                : [];
+    return arm && JSON.stringify([a.kind, a.label, ...arm]);
+}
+/** Whether two associations are the same one — see associationKey(). */
+export function associationEqual(a, b) {
+    const key = associationKey(a);
+    return key !== undefined && key === associationKey(b);
 }
 /**
- * Structural equality per grantee arm. `role` is required, so there is no
+ * A grantee's identity, per arm. `role` is required, so there is no
  * absent-means-any spelling to normalize.
  */
+function granteeParts(g) {
+    if (g?.kind === 'entity')
+        return [g.kind, g.entityId];
+    if (g?.kind === 'group')
+        return [g.kind, g.groupId, g.role];
+    return undefined;
+}
 export function granteeEqual(a, b) {
-    if (!a || !b)
-        return false;
-    if (a.kind !== b.kind)
-        return false;
-    if (a.kind === 'entity' && b.kind === 'entity')
-        return a.entityId === b.entityId;
-    if (a.kind === 'group' && b.kind === 'group') {
-        return a.groupId === b.groupId && a.role === b.role;
-    }
-    return false;
+    const parts = granteeParts(a);
+    return parts !== undefined && JSON.stringify(parts) === JSON.stringify(granteeParts(b));
+}
+/** A target's identity, per arm — an absent `stackUrl` is this stack, as an empty one is. */
+function targetParts(t) {
+    if (t?.kind === 'record')
+        return [t.kind, t.recordId, t.stackUrl ?? ''];
+    if (t?.kind === 'entity')
+        return [t.kind, t.entityId];
+    if (t?.kind === 'external')
+        return [t.kind, t.ns, t.id];
+    return undefined;
 }
-/** Structural equality per target arm — what dissociate() matches on. */
+/** Structural equality per target arm — what a remove edit matches on. */
 export function targetEqual(a, b) {
-    if (a.kind !== b.kind)
-        return false;
-    if (a.kind === 'record' && b.kind === 'record') {
-        return a.recordId === b.recordId && (a.stackUrl ?? '') === (b.stackUrl ?? '');
-    }
-    if (a.kind === 'entity' && b.kind === 'entity')
-        return a.entityId === b.entityId;
-    if (a.kind === 'external' && b.kind === 'external')
-        return a.ns === b.ns && a.id === b.id;
-    return false;
+    const parts = targetParts(a);
+    return parts !== undefined && JSON.stringify(parts) === JSON.stringify(targetParts(b));
 }
 /**
  * Identity plus every annotation outside it, so a write that only re-points
@@ -87,39 +89,25 @@ function stripAssociationAnnotation(association) {
     const { attachmentRecordId: _attachmentRecordId, ...identity } = association;
     return identity;
 }
-/**
- * The association kinds that carry authority. Every other kind is data.
- * Storage that partitions by kind in a query reads this list rather than
- * restating it, so a new authority kind can't fall into the data half.
- */
-export const AUTHORITY_ASSOCIATION_KINDS = [
+/** The association kinds that carry authority. Every other kind is data. */
+const AUTHORITY_ASSOCIATION_KINDS = [
     'permission',
     'anyone',
 ];
 /**
  * Whether an association carries authority rather than data — the partition
  * `StackRecord.permissions` and `StackRecord.associations` project, and the
- * line `associate()`/`dissociate()` refuse to cross.
+ * line the association verbs refuse to cross.
  * See docs/spec/access-control.md § Record-level permissions.
  */
 export function isAuthorityAssociation(a) {
     return AUTHORITY_ASSOCIATION_KINDS.includes(a.kind);
 }
 /**
- * One stored association set split into the two the record presents. An app
- * editing tags never sees the authority half, so it cannot drop it.
- */
-export function partitionAssociations(associations) {
-    return {
-        associations: associations.filter((a) => !isAuthorityAssociation(a)),
-        permissions: associations.filter(isAuthorityAssociation),
-    };
-}
-/**
- * What a `changes.associations` list moves against a record's current set,
- * one tagged edit each. An entry matching an existing identity displaced it:
- * a `repoint`, carrying the prior association in full as `previous` — the
- * only place an overwritten `attachmentRecordId` survives.
+ * What replacing a record's set with `after` moves, one tagged edit each.
+ * An entry matching an existing identity displaced it: a `repoint`,
+ * carrying the prior association in full as `previous` — the only place
+ * an overwritten `attachmentRecordId` survives.
  * See docs/spec/journal.md § The entry.
  */
 export function associationDelta(before, after) {
@@ -135,6 +123,13 @@ export function associationDelta(before, after) {
         .filter((b) => !after.some((a) => associationEqual(a, b)))
         .map((association) => ({ op: 'remove', association })));
 }
+/**
+ * Whether two sets hold the same elements, annotations included, in any
+ * order — what an element-set write's `expectSet` is compared by.
+ */
+export function sameAssociationSet(a, b) {
+    return associationDelta(a, b).length === 0;
+}
 /**
  * The two flat lists a change frame carries, derived from the tagged list.
  * The feed reports what is true now, so a `repoint` appears only under its
@@ -157,24 +152,13 @@ export function feedAssociationDelta(changes) {
     }
     return { added, removed };
 }
-/**
- * An association edit list travels one surface: authority and data share
- * storage and a delta, and never share a call. Refused here so every
- * adapter inherits the same rule.
- * See docs/spec/access-control.md § Storage unifies; the API does not.
- */
-export function assertOneSurface(changes) {
-    const authority = changes.filter((c) => isAuthorityAssociation(c.association)).length;
-    if (authority === 0 || authority === changes.length)
-        return;
-    throw new StackBadRequestError('An association edit list carries authority or data, never both: permission and anyone ' +
-        'elements travel on the permissions surface.');
+/** The elements an edit list adds. */
+export function addsOf(edits) {
+    return edits.flatMap((e) => (e.op === 'add' ? [e.association] : []));
 }
 /**
- * The set a list of edits leaves behind: removes first, then adds, an add
- * landing on an identity already held in place. Adds naming one identity
- * collapse, last wins; an add outlives a remove of the same identity.
- * See docs/spec/adapters.md § Amending associations.
+ * The set a list of edits leaves behind, an add landing on an identity
+ * already held in place. See docs/spec/adapters.md § Editing associations.
  */
 export function applyAssociationEdits(current, changes) {
     let next = current.filter((a) => !changes.some((c) => c.op === 'remove' && associationEqual(c.association, a)));
@@ -187,12 +171,4 @@ export function applyAssociationEdits(current, changes) {
     }
     return next;
 }
-/**
- * The same op over every element of a list — what associate(),
- * dissociate(), grantAccess() and revokeAccess() hand to the amend verb
- * each is one half of.
- */
-export function editsOf(op, associations) {
-    return associations.map((association) => ({ op, association }));
-}
 //# sourceMappingURL=identity.js.map

package/dist/associations/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/associations/identity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/associations/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,CAAc;IAC3C,qEAAqE;IACrE,uEAAuE;IACvE,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,GAAG,GACP,CAAC,CAAC,IAAI,KAAK,YAAY;QACrB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACZ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc;YACzB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;YACvB,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY;gBACvB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;gBACzB,CAAC,CAAC,EAAE,CAAC;IACb,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,CAAc,EAAE,CAAc;IAC7D,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAU,EAAE,CAAU;IACjD,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,6FAA6F;AAC7F,SAAS,WAAW,CAAC,CAAqB;IACxC,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,IAAI,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,CAAqB,EAAE,CAAqB;IACtE,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAc,EAAE,CAAc;IACjE,IAAI,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACvD,OAAO,CAAC,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,0BAA0B,CAAC,WAAwB;IAC1D,IAAI,WAAW,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,WAAW,CAAC;IAC1D,MAAM,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,GAAG,QAAQ,EAAE,GAAG,WAAW,CAAC;IAC7E,OAAO,QAAuB,CAAC;AACjC,CAAC;AAED,4EAA4E;AAC5E,MAAM,2BAA2B,GAA4C;IAC3E,YAAY;IACZ,QAAQ;CACT,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAAc;IACnD,OAAQ,2BAAiD,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA8B,EAC9B,KAA6B;IAE7B,MAAM,OAAO,GAAwB,KAAK;SACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC9D,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;QACnB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QACtE,OAAO,QAAQ;YACb,CAAC,CAAE,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAY;YACrD,CAAC,CAAE,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAY,CAAC;IAC5C,CAAC,CAAC,CAAC;IACL,OAAO,OAAO,CAAC,MAAM,CACnB,MAAM;SACH,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACzD,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CACzD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAyB,EAAE,CAAyB;IACrF,OAAO,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAI/D,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,0BAA0B,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAC3D,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,MAAM,CAAC,KAAiC;IACtD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAsB,EACtB,OAAmC;IAEnC,IAAI,IAAI,GAAG,OAAO,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,gBAAgB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CACrF,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK;YAAE,SAAS;QAC7B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;YACzD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3E,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/associations/validation.d.ts

@@ -56,7 +56,7 @@ export declare function granteeErrors(grantee: unknown, path: string, opts: {
  * Refuse an authority element on the data surface. The two halves share
  * storage but never a call, or an app editing tags could replace an ACL it
  * was never shown. Thrown, not collected: the caller named the wrong
- * surface, and wanted grantAccess()/revokeAccess().
+ * surface, and wanted editAccess()/setAccess().
  * See docs/spec/access-control.md § Record-level permissions.
  */
 export declare function assertDataAssociations(associations: readonly Association[], surface: string): asserts associations is DataAssociation[];
@@ -80,11 +80,4 @@ export declare function validateAssociations(associations: Association[] | undef
  * the journal's word, never a request. See docs/spec/data-model.md § Mutations.
  */
 export declare function assertAssociationEdits(changes: unknown, surface: string, half: 'data' | 'authority'): asserts changes is AssociationEdit[];
-/**
- * assertAssociationEdits() for the verbs taking a bare list — associate(),
- * grantAccess() and their inverses — asked before wrapping, so problems are
- * reported under `param`, the name the caller used. Same order of checks,
- * so a wrong-surface element is refused as such before duplicates count.
- */
-export declare function assertAssociationList(associations: unknown, surface: string, param: string, half: 'data' | 'authority'): asserts associations is Association[];
 //# sourceMappingURL=validation.d.ts.map

package/dist/associations/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/associations/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAEV,WAAW,EACX,eAAe,EAEf,oBAAoB,EACpB,eAAe,EAGf,YAAY,EAKZ,kBAAkB,EAClB,yBAAyB,EAE1B,MAAM,mBAAmB,CAAC;AAY3B,sDAAsD;AACtD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAI7E,CAAC;AAgBF,qEAAqE;AACrE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAIxE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE5E;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAM1F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,GAAG,yBAAyB,EACtD,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,eAAe,EAAE,CAyBnB;AAmBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,IAAI,SAAgB,GACnB,eAAe,EAAE,CAoBnB;AAmCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACrF,eAAe,EAAE,CA+CnB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,IAAI,eAAe,EAAE,CAO3C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,WAAW,EAAE,EACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,IAAI,oBAAoB,EAAE,CAO/C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,WAAW,EAAE,GAAG,SAAS,EACvC,IAAI,SAAiB,GACpB,eAAe,EAAE,CAMnB;AAgBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,WAAW,GACzB,OAAO,CAAC,OAAO,IAAI,eAAe,EAAE,CAoCtC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,WAAW,GACzB,OAAO,CAAC,YAAY,IAAI,WAAW,EAAE,CAoBvC"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/associations/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAEV,WAAW,EACX,eAAe,EAEf,oBAAoB,EACpB,eAAe,EAGf,YAAY,EAKZ,kBAAkB,EAClB,yBAAyB,EAE1B,MAAM,mBAAmB,CAAC;AAY3B,sDAAsD;AACtD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAI7E,CAAC;AAgBF,qEAAqE;AACrE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAIxE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE5E;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAM1F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,GAAG,yBAAyB,EACtD,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,eAAe,EAAE,CAyBnB;AAmBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,IAAI,SAAgB,GACnB,eAAe,EAAE,CAoBnB;AAmCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACrF,eAAe,EAAE,CA+CnB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,IAAI,eAAe,EAAE,CAO3C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,WAAW,EAAE,EACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,IAAI,oBAAoB,EAAE,CAO/C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,WAAW,EAAE,GAAG,SAAS,EACvC,IAAI,SAAiB,GACpB,eAAe,EAAE,CAMnB;AAgBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,WAAW,GACzB,OAAO,CAAC,OAAO,IAAI,eAAe,EAAE,CAoCtC"}

package/dist/associations/validation.js

@@ -220,7 +220,7 @@ export function granteeErrors(grantee, path, opts) {
  * Refuse an authority element on the data surface. The two halves share
  * storage but never a call, or an app editing tags could replace an ACL it
  * was never shown. Thrown, not collected: the caller named the wrong
- * surface, and wanted grantAccess()/revokeAccess().
+ * surface, and wanted editAccess()/setAccess().
  * See docs/spec/access-control.md § Record-level permissions.
  */
 export function assertDataAssociations(associations, surface) {
@@ -228,7 +228,7 @@ export function assertDataAssociations(associations, surface) {
     if (!authority)
         return;
     throw new StackBadRequestError(`${surface} does not carry authority: a "${authority.kind}" association belongs to the ` +
-        '`permissions` surface — use grantAccess()/revokeAccess(), or the `permissions` change-set key.');
+        '`permissions` surface — use editAccess() or setAccess().');
 }
 /**
  * The mirror of assertDataAssociations(): the `permissions` surface takes
@@ -240,7 +240,7 @@ export function assertAuthorityAssociations(permissions, surface) {
     if (!data)
         return;
     throw new StackBadRequestError(`${surface} carries authority alone: a "${data.kind}" association belongs to the ` +
-        '`associations` surface — use associate()/dissociate(), or the `associations` change-set key.');
+        '`associations` surface — use editAssociations() or setAssociations().');
 }
 /**
  * Every association in a list, plus the list's own rule: identities are
@@ -309,31 +309,4 @@ export function assertAssociationEdits(changes, surface, half) {
     if (duplicates.length > 0)
         throw new StackValidationError(duplicates, ARGUMENTS_INVALID);
 }
-/**
- * assertAssociationEdits() for the verbs taking a bare list — associate(),
- * grantAccess() and their inverses — asked before wrapping, so problems are
- * reported under `param`, the name the caller used. Same order of checks,
- * so a wrong-surface element is refused as such before duplicates count.
- */
-export function assertAssociationList(associations, surface, param, half) {
-    if (!Array.isArray(associations) || associations.length === 0) {
-        throw new StackValidationError([{ path: param, message: `${surface} names at least one association.` }], ARGUMENTS_INVALID);
-    }
-    const errors = associations.flatMap((raw, i) => typeof raw === 'object' && raw !== null && !Array.isArray(raw)
-        ? []
-        : [{ path: `${param}[${i}]`, message: `${param}[${i}] must be an object.` }]);
-    if (errors.length > 0)
-        throw new StackValidationError(errors, ARGUMENTS_INVALID);
-    const list = associations;
-    const shapeErrors = list.flatMap((a, i) => validateAssociation(a, `${param}[${i}]`));
-    if (shapeErrors.length > 0)
-        throw new StackValidationError(shapeErrors, ARGUMENTS_INVALID);
-    if (half === 'data')
-        assertDataAssociations(list, surface);
-    else
-        assertAuthorityAssociations(list, surface);
-    const listErrors = validateAssociations(list, param);
-    if (listErrors.length > 0)
-        throw new StackValidationError(listErrors, ARGUMENTS_INVALID);
-}
 //# sourceMappingURL=validation.js.map