@baukit/data-contracts 0.6.0 → 0.7.0

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.
package/README.md CHANGED
@@ -444,3 +444,22 @@ files, a write-free preview, field filtering, rollback after a halfway failure,
444
444
  state changes after commit.
445
445
 
446
446
  Persistence adapters and product-specific migration logic belong in product or future adapter packages. The production entry point has no runtime dependencies; only the `/vitest` subpath expects the consumer's Vitest installation.
447
+
448
+ ## Profile erasure
449
+
450
+ Call `eraseProductProfile` only after explicit user confirmation. Compose
451
+ `eraseServerProfile` with `@baukit/api-runtime/erasure`,
452
+ `eraseLocalPartition` with `ScopedPersistenceLifecycle.eraseActivePartition()`,
453
+ and `signOut` with the auth client's local session cleanup.
454
+
455
+ A completed or pending receipt confirms the server profile deletion committed.
456
+ Both run local partition erasure, then sign-out. A pending receipt returns a
457
+ `pending` result so the UI can explain that sign-in account deletion is still
458
+ finishing. Its operation ID can be null when a server `profile_erased` fence
459
+ confirms the commit without exposing the operation ID.
460
+
461
+ A definite server failure or ambiguous outcome retains local data and the
462
+ session. Retry an ambiguous request with the persisted idempotency key.
463
+ Before-server hook failures remain safe diagnostic warnings. Local failures
464
+ still attempt sign-out and report both failures; a sign-out failure stays
465
+ visible. Neither cleanup failure should trigger a new server deletion.
package/dist/erasure.d.ts CHANGED
@@ -3,7 +3,7 @@ export type ErasureReceipt = {
3
3
  readonly operationId: string | null;
4
4
  readonly status: 'completed';
5
5
  } | {
6
- readonly operationId: string;
6
+ readonly operationId: string | null;
7
7
  readonly status: 'pending';
8
8
  };
9
9
  /** Dependencies for the product-profile erasure sequence. */
@@ -20,7 +20,7 @@ export interface ProductProfileErasureIssue {
20
20
  readonly cause: string;
21
21
  }
22
22
  export type ProductProfileErasureResult = {
23
- readonly status: 'erased';
23
+ readonly status: 'erased' | 'pending';
24
24
  readonly receipt: ErasureReceipt;
25
25
  readonly warnings: readonly ProductProfileErasureIssue[];
26
26
  } | {
@@ -1 +1 @@
1
- {"version":3,"file":"erasure.d.ts","sourceRoot":"","sources":["../src/erasure.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjE,6DAA6D;AAC7D,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IAC9D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,0BAA0B,GAAG,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE3F,gFAAgF;AAChF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,CAAC;AAEN,4EAA4E;AAC5E,qBAAa,mCAAoC,SAAQ,KAAK;IAC5D,SAAyB,IAAI,yCAAyC;IACtE,SAAgB,IAAI,EAAG,mCAAmC,CAAU;gBAEjD,KAAK,CAAC,EAAE,OAAO;CAGnC;AAuDD,qFAAqF;AACrF,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,iCAAiC,GAC9C,OAAO,CAAC,2BAA2B,CAAC,CAiDtC"}
1
+ {"version":3,"file":"erasure.d.ts","sourceRoot":"","sources":["../src/erasure.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAExE,6DAA6D;AAC7D,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IAC9D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,0BAA0B,GAAG,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE3F,gFAAgF;AAChF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D,CAAC;AAEN,4EAA4E;AAC5E,qBAAa,mCAAoC,SAAQ,KAAK;IAC5D,SAAyB,IAAI,yCAAyC;IACtE,SAAgB,IAAI,EAAG,mCAAmC,CAAU;gBAEjD,KAAK,CAAC,EAAE,OAAO;CAGnC;AAuDD,qFAAqF;AACrF,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,iCAAiC,GAC9C,OAAO,CAAC,2BAA2B,CAAC,CAiDtC"}
package/dist/erasure.js CHANGED
@@ -45,8 +45,8 @@ function validateErasureReceipt(receipt) {
45
45
  const operationId = Reflect.get(receipt, 'operationId');
46
46
  const status = Reflect.get(receipt, 'status');
47
47
  const hasOperationId = typeof operationId === 'string' && operationId.trim().length > 0;
48
- if ((status === 'completed' && (operationId === null || hasOperationId)) ||
49
- (status === 'pending' && hasOperationId)) {
48
+ if ((status === 'completed' || status === 'pending') &&
49
+ (operationId === null || hasOperationId)) {
50
50
  return;
51
51
  }
52
52
  throw new AmbiguousProductProfileErasureError(new TypeError('Invalid erasure receipt.'));
@@ -102,6 +102,6 @@ export async function eraseProductProfile(dependencies) {
102
102
  if (signOutError !== undefined) {
103
103
  return { status: 'signout-failure', receipt, error: signOutError, warnings };
104
104
  }
105
- return { status: 'erased', receipt, warnings };
105
+ return { status: receipt.status === 'pending' ? 'pending' : 'erased', receipt, warnings };
106
106
  }
107
107
  //# sourceMappingURL=erasure.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"erasure.js","sourceRoot":"","sources":["../src/erasure.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"erasure.js","sourceRoot":"","sources":["../src/erasure.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ export interface UuidV7Input {
2
+ /** Unix epoch time in whole milliseconds, limited to the UUIDv7 48-bit field. */
3
+ readonly unixTimestampMilliseconds: number;
4
+ /** Ten cryptographically random bytes supplied by the active runtime. */
5
+ readonly randomBytes: Uint8Array;
6
+ }
7
+ /**
8
+ * Encodes an RFC 9562 UUIDv7 from caller-supplied time and random bytes.
9
+ *
10
+ * This function has no clock, random source, or monotonic state. Callers must
11
+ * obtain cryptographically secure bytes from their runtime and coordinate any
12
+ * ordering guarantee stronger than the UUIDv7 millisecond timestamp.
13
+ */
14
+ export declare function uuidV7(input: UuidV7Input): string;
15
+ //# sourceMappingURL=uuid-v7.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uuid-v7.d.ts","sourceRoot":"","sources":["../src/uuid-v7.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAyBjD"}
@@ -0,0 +1,31 @@
1
+ const UUID_V7_RANDOM_BYTE_COUNT = 10;
2
+ const MAX_UUID_V7_TIMESTAMP = 0xffff_ffff_ffff;
3
+ /**
4
+ * Encodes an RFC 9562 UUIDv7 from caller-supplied time and random bytes.
5
+ *
6
+ * This function has no clock, random source, or monotonic state. Callers must
7
+ * obtain cryptographically secure bytes from their runtime and coordinate any
8
+ * ordering guarantee stronger than the UUIDv7 millisecond timestamp.
9
+ */
10
+ export function uuidV7(input) {
11
+ const timestamp = input.unixTimestampMilliseconds;
12
+ if (!Number.isSafeInteger(timestamp) || timestamp < 0 || timestamp > MAX_UUID_V7_TIMESTAMP) {
13
+ throw new RangeError('UUIDv7 timestamp must be a 48-bit non-negative integer.');
14
+ }
15
+ if (!(input.randomBytes instanceof Uint8Array) || input.randomBytes.length !== 10) {
16
+ throw new RangeError(`UUIDv7 requires exactly ${String(UUID_V7_RANDOM_BYTE_COUNT)} random bytes.`);
17
+ }
18
+ const bytes = new Uint8Array(16);
19
+ let remainingTimestamp = timestamp;
20
+ for (let index = 5; index >= 0; index -= 1) {
21
+ bytes[index] = remainingTimestamp % 256;
22
+ remainingTimestamp = Math.floor(remainingTimestamp / 256);
23
+ }
24
+ bytes[6] = 0x70 | ((input.randomBytes.at(0) ?? 0) & 0x0f);
25
+ bytes[7] = input.randomBytes.at(1) ?? 0;
26
+ bytes[8] = 0x80 | ((input.randomBytes.at(2) ?? 0) & 0x3f);
27
+ bytes.set(input.randomBytes.subarray(3), 9);
28
+ const hexadecimal = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
29
+ return `${hexadecimal.slice(0, 8)}-${hexadecimal.slice(8, 12)}-${hexadecimal.slice(12, 16)}-${hexadecimal.slice(16, 20)}-${hexadecimal.slice(20)}`;
30
+ }
31
+ //# sourceMappingURL=uuid-v7.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uuid-v7.js","sourceRoot":"","sources":["../src/uuid-v7.ts"],"names":[],"mappings":"AAAA,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAS/C;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,qBAAqB,EAAE,CAAC;QAC3F,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,YAAY,UAAU,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAClF,MAAM,IAAI,UAAU,CAClB,2BAA2B,MAAM,CAAC,yBAAyB,CAAC,gBAAgB,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,kBAAkB,GAAG,SAAS,CAAC;IACnC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,KAAK,CAAC,GAAG,kBAAkB,GAAG,GAAG,CAAC;QACxC,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACrJ,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@baukit/data-contracts",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "description": "Runtime-neutral data contracts, measurement helpers, and executable adapter conformance tests.",
5
5
  "license": "MIT",
6
6
  "author": "Patrick Koss",