@zhin.js/plugin-earthquake 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @zhin.js/plugin-earthquake
 
+## 0.1.6
+
+### Patch Changes
+
+- a9f4e48: PATCH COMPATIBILITY CUTOVER: this batch intentionally changes plugin APIs. The maintainer explicitly chose patch releases with declared version boundaries. Upgrade the complete tested dependency set; patch numbering does not promise compatibility with the removed interfaces.
+
+  The first planned floors are zhin.js 1.1.19, Core 1.1.54, Adapter 1.1.26, FeatureKit 1.1.10, Plugin Runtime 1.1.18, Runtime/Isolate 1.1.16 and Agent 1.1.45. Keep old-interface plugins with the earlier locked stack until they are migrated. Adapter's independent Feature API changes from 1.0.0 to 2.0.0; official consumers declare ^2.0.0. Existing Feature API admission rejects explicitly incompatible ranges; omitted API metadata keeps its existing behavior and does not certify compatibility. Runtime engine and patch-only release gates remain unchanged.
+
+  Use the native-Client Adapter target contract, canonical FeatureKit AdapterRegistry augmentation and named Endpoint control/management requests. Route message controls from canonical message/conversation refs; retain exact source authority and propagate caller/account/explicit-Root-stop cancellation. Replace removed Agent activity feedback exports with source-bound feedback. HMR pause/resume belongs to concrete plugin instances; plugins choose accepted-work policy without changing Controller commit/rollback authority. Cooperative worker/process control cancellation does not kill an isolate or reopen retired business admission.
+
+  Provide authenticated historical-data preview, exact selected binding, transactional application, authoritative inspection and explicit resumption, including active games. Preserve before-images and journals; never replay an unconfirmed effect, infer an account from an alias, or reuse historical permission grants. Owner V2 approvals remain inactive legacy data, while new writes use V3. Rollback requires matching software, lockfile and verified data; installing old code alone cannot read a new V3 approval file. Conflicting after-images are never overwritten.
+
+  See docs/plans/adapter-operation-version-boundaries.md and the Chinese/English upgrade guide for the complete version inventory, custom-plugin changes, acceptance and recovery sequence. These code and metadata changes do not authorize merging, publication, deployment, login, production migration or removal of installed workspace patches.
+
+  - @zhin.js/skill@1.1.11
+  - @zhin.js/tool@1.1.13
+
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies [c58c589]
+  - @zhin.js/tool@1.1.12
+
 ## 0.1.4
 
 ### Patch Changes

package/commands//345/234/260/351/234/207//350/256/242/351/230/205/index.js

@@ -26,6 +26,7 @@ export default defineCommand({
         try {
             const { created } = await service.store.upsert({
                 locale,
+                target: target.target,
                 adapter: target.adapter,
                 endpointKey: target.endpointKey,
                 conversationKind: target.conversationKind,

package/lib/conversation.d.ts

@@ -1,6 +1,8 @@
+import { type DeliveryTarget } from 'zhin.js/plugin-runtime';
 import type { Locale } from 'zhin.js/i18n';
 import type { ConversationKind } from './subscriptions.js';
 export interface ConversationTarget {
+    readonly target: DeliveryTarget;
     readonly adapter: string;
     readonly endpointKey: string;
     readonly conversationKind: ConversationKind;

package/lib/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAO3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,6BAA6B,uHAAwB,CAAC;AACnE,eAAO,MAAM,0BAA0B,+IAA4B,CAAC;AAYpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAGlF;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAuB7E"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAO3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,6BAA6B,uHAAwB,CAAC;AACnE,eAAO,MAAM,0BAA0B,+IAA4B,CAAC;AAYpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAGlF;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAwB7E"}

package/lib/conversation.js

@@ -1,3 +1,4 @@
+import { createDeliveryTarget } from 'zhin.js/plugin-runtime';
 import { messages as t } from './i18n.js';
 /**
  * Extracts a push destination from the public Message fields of a command input.
@@ -32,10 +33,10 @@ export function extractConversation(input) {
     const kind = conversation.kind;
     if (kind !== 'private' && kind !== 'group' && kind !== 'channel')
         return null;
-    // Same precedence as core: explicit message fields, then the conversation's endpoint.
+    // Canonical scene identity is authoritative; display names are never persisted as account identity.
     const endpoint = isRecord(conversation.endpoint) ? conversation.endpoint : {};
-    const adapter = isIdentifier(input.clientAdapter) ? input.clientAdapter : endpoint.adapter;
-    const endpointKey = isIdentifier(input.endpointId) ? input.endpointId : endpoint.id;
+    const adapter = endpoint.adapter;
+    const endpointKey = endpoint.id;
     if (!isIdentifier(adapter))
         return null;
     if (!isIdentifier(endpointKey))
@@ -45,6 +46,7 @@ export function extractConversation(input) {
     const sender = input.sender;
     const senderId = isRecord(sender) && isIdentifier(sender.id) ? sender.id : '';
     return {
+        target: createDeliveryTarget({ conversation: conversation }),
         adapter,
         endpointKey,
         conversationKind: kind,

package/lib/conversation.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,CAAC,EAAE,MAAM,WAAW,CAAC;AAC1C;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAWtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,yBAAyB,CAAC;AAEpE,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,KAA8B;IAChD,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,YAAY,CAAC,MAAM,KAAK,SAAS,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,SAAiB,OAAO;IACxE,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvE,OAAO,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACnC,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9E,sFAAsF;IACtF,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC3F,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpF,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,OAAO;QACL,OAAO;QACP,WAAW;QACX,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,YAAY,CAAC,EAAE;QAC/B,QAAQ;KACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,wBAAwB,CAAC;AAEnF,OAAO,EAAE,QAAQ,IAAI,CAAC,EAAE,MAAM,WAAW,CAAC;AAC1C;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAYtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,yBAAyB,CAAC;AAEpE,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,KAA8B;IAChD,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,YAAY,CAAC,MAAM,KAAK,SAAS,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,SAAiB,OAAO;IACxE,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvE,OAAO,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACnC,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9E,oGAAoG;IACpG,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,CAAC;IAChC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,OAAO;QACL,MAAM,EAAE,oBAAoB,CAAC,EAAE,YAAY,EAAE,YAA8B,EAAE,CAAC;QAC9E,OAAO;QACP,WAAW;QACX,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,YAAY,CAAC,EAAE;QAC/B,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/lib/migration-document.d.ts

@@ -0,0 +1,19 @@
+import { type JsonValue } from 'zhin.js/plugin-runtime';
+export interface SubscriptionMigrationJournal {
+    readonly planDigest: string;
+    readonly candidateId: string;
+    readonly beforeDigest: string;
+    readonly afterDigest: string;
+    readonly recordCount: number;
+    readonly scopes: readonly string[];
+    readonly phase: 'pausing' | 'applied' | 'restoring' | 'restored' | 'rejected' | 'resumed';
+    readonly operation?: 'apply' | 'restore';
+    readonly rejectedDigest?: string;
+}
+export interface SubscriptionDocument {
+    readonly format: 'earthquake-subscriptions-v2';
+    readonly subscriptions: readonly JsonValue[];
+    readonly migrations: Readonly<Record<string, SubscriptionMigrationJournal>>;
+}
+export declare function subscriptionDocument(value: unknown): SubscriptionDocument;
+//# sourceMappingURL=migration-document.d.ts.map

package/lib/migration-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-document.d.ts","sourceRoot":"","sources":["../src/migration-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE5E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAC;CAC7E;AACD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAiBzE"}

package/lib/migration-document.js

@@ -0,0 +1,20 @@
+import { DataMigrationError } from 'zhin.js/plugin-runtime';
+export function subscriptionDocument(value) {
+    if (value === undefined)
+        return { format: 'earthquake-subscriptions-v2', subscriptions: [], migrations: {} };
+    if (Array.isArray(value))
+        return { format: 'earthquake-subscriptions-v2', subscriptions: value, migrations: {} };
+    if (value &&
+        typeof value === 'object' &&
+        'format' in value &&
+        value.format === 'earthquake-subscriptions-v2' &&
+        'subscriptions' in value &&
+        Array.isArray(value.subscriptions) &&
+        'migrations' in value &&
+        value.migrations &&
+        typeof value.migrations === 'object' &&
+        !Array.isArray(value.migrations))
+        return value;
+    throw new DataMigrationError('unsupported', 'Earthquake subscriptions have an unrecognized storage format');
+}
+//# sourceMappingURL=migration-document.js.map

package/lib/migration-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-document.js","sourceRoot":"","sources":["../src/migration-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAkB,MAAM,wBAAwB,CAAC;AAkB5E,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC7G,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACjH,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,KAAK,CAAC,MAAM,KAAK,6BAA6B;QAC9C,eAAe,IAAI,KAAK;QACxB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;QAClC,YAAY,IAAI,KAAK;QACrB,KAAK,CAAC,UAAU;QAChB,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QAEhC,OAAO,KAA6B,CAAC;IACvC,MAAM,IAAI,kBAAkB,CAAC,aAAa,EAAE,8DAA8D,CAAC,CAAC;AAC9G,CAAC"}

package/lib/subscriptions.d.ts

@@ -1,6 +1,9 @@
+import { type DeliveryTarget, type JsonValue, type TargetMigrationScopes } from 'zhin.js/plugin-runtime';
 import { type Locale } from 'zhin.js/i18n';
 export type ConversationKind = 'private' | 'group' | 'channel';
 export interface EarthquakeSubscription {
+    /** Present on canonical captures; historical alias-only rows remain unchanged until migration is approved. */
+    readonly target?: DeliveryTarget;
     readonly locale?: Locale;
     readonly adapter: string;
     readonly endpointKey: string;
@@ -15,15 +18,17 @@ export interface EarthquakeSubscription {
 export interface KeyValueState {
     get(key: string): Promise<unknown>;
     set(key: string, value: never): Promise<void>;
+    update?<T extends JsonValue>(key: string, updater: (current: T | undefined) => T | undefined): Promise<T | undefined>;
 }
 export declare const SUBSCRIPTIONS_STATE_KEY = "subscriptions/v1";
-export declare function subscriptionKey(target: Pick<EarthquakeSubscription, 'adapter' | 'endpointKey' | 'conversationKind' | 'conversationId'>): string;
+export declare function subscriptionKey(target: Pick<EarthquakeSubscription, 'adapter' | 'endpointKey' | 'conversationKind' | 'conversationId' | 'target'>): string;
 export declare function createMemoryState(): KeyValueState;
 export declare class SubscriptionStore {
     #private;
     constructor(state: KeyValueState, options: {
         readonly maxSubscriptions: number;
     });
+    bindMigrationScopes(scopes: TargetMigrationScopes): void;
     list(): Promise<EarthquakeSubscription[]>;
     get(key: string): Promise<EarthquakeSubscription | undefined>;
     /** Creates or replaces this conversation's subscription. */

package/lib/subscriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAW1D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,aAAa,GAAG,kBAAkB,GAAG,gBAAgB,CAAC,GAAG,MAAM,CAE/I;AA8BD,wBAAgB,iBAAiB,IAAI,aAAa,CAUjD;AAED,qBAAa,iBAAiB;;gBAKhB,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAK1E,IAAI,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAWzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAKnE,4DAA4D;IACtD,MAAM,CAAC,YAAY,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAkBpF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAoB5C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,KAAK,EAAE,MAAM;CAK1B"}
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAClI,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAW1D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACvH;AAED,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,aAAa,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,QAAQ,CAAC,GAAG,MAAM,CAG1J;AA+BD,wBAAgB,iBAAiB,IAAI,aAAa,CAUjD;AAED,qBAAa,iBAAiB;;gBAMhB,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAKhF,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAElD,IAAI,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAWzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAKnE,4DAA4D;IACtD,MAAM,CAAC,YAAY,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAWpF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAiC5C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,KAAK,EAAE,MAAM;CAK1B"}

package/lib/subscriptions.js

@@ -1,3 +1,6 @@
+import { conversationRefKey } from 'zhin.js';
+import { subscriptionDocument } from './migration-document.js';
+import { normalizeDeliveryTarget } from 'zhin.js/plugin-runtime';
 import { resolveLocale } from 'zhin.js/i18n';
 /**
  * Conversation subscriptions, one per conversation.
@@ -10,6 +13,8 @@ import { resolveLocale } from 'zhin.js/i18n';
 import { isRecord, toFiniteNumber, toTrimmedString } from './sources/parse-helpers.js';
 export const SUBSCRIPTIONS_STATE_KEY = 'subscriptions/v1';
 export function subscriptionKey(target) {
+    if (target.target)
+        return `canonical:${conversationRefKey(target.target)}`;
     return [target.adapter, target.endpointKey, target.conversationKind, target.conversationId].join('\u0000');
 }
 function isConversationKind(value) {
@@ -30,6 +35,7 @@ function parseStoredSubscription(value) {
         ? value.regions.filter((region) => typeof region === 'string' && region.trim() !== '')
         : [];
     return {
+        ...(value.target === undefined ? {} : { target: normalizeDeliveryTarget(value.target) }),
         adapter,
         locale: resolveLocale(value.locale),
         endpointKey,
@@ -56,14 +62,15 @@ export class SubscriptionStore {
     #state;
     #maxSubscriptions;
     #queue = Promise.resolve();
+    #migrationScopes;
     constructor(state, options) {
         this.#state = state;
         this.#maxSubscriptions = options.maxSubscriptions;
     }
+    bindMigrationScopes(scopes) { this.#migrationScopes = scopes; }
     async list() {
-        const stored = await this.#state.get(SUBSCRIPTIONS_STATE_KEY);
-        if (!Array.isArray(stored))
-            return [];
+        const value = await this.#state.get(SUBSCRIPTIONS_STATE_KEY);
+        const stored = Array.isArray(value) ? value : subscriptionDocument(value).subscriptions;
         const subscriptions = [];
         for (const entry of stored) {
             const parsed = parseStoredSubscription(entry);
@@ -78,36 +85,43 @@ export class SubscriptionStore {
     }
     /** Creates or replaces this conversation's subscription. */
     async upsert(subscription) {
-        return this.#serialize(async () => {
-            const all = await this.list();
-            const key = subscriptionKey(subscription);
-            const index = all.findIndex((existing) => subscriptionKey(existing) === key);
-            if (index === -1 && all.length >= this.#maxSubscriptions) {
+        const key = subscriptionKey(subscription);
+        return this.#run(key, () => this.#serialize(() => this.#mutate(all => {
+            const index = all.findIndex(existing => subscriptionKey(existing) === key);
+            if (index === -1 && all.length >= this.#maxSubscriptions)
                 throw new SubscriptionLimitError(this.#maxSubscriptions);
-            }
-            if (index === -1) {
+            if (index === -1)
                 all.push(subscription);
-            }
-            else {
+            else
                 all[index] = { ...subscription, locale: resolveLocale(all[index]?.locale) };
-            }
-            await this.#write(all);
-            return { created: index === -1 };
-        });
+            return { subscriptions: all, result: { created: index === -1 } };
+        })));
     }
     async remove(key) {
-        return this.#serialize(async () => {
-            const all = await this.list();
-            const remaining = all.filter((subscription) => subscriptionKey(subscription) !== key);
-            if (remaining.length === all.length)
-                return false;
-            await this.#write(remaining);
-            return true;
+        return this.#run(key, () => this.#serialize(() => this.#mutate(all => {
+            const subscriptions = all.filter(subscription => subscriptionKey(subscription) !== key);
+            return { subscriptions, result: subscriptions.length !== all.length };
+        })));
+    }
+    async #mutate(change) {
+        if (!this.#state.update) {
+            const changed = change(await this.list());
+            await this.#state.set(SUBSCRIPTIONS_STATE_KEY, changed.subscriptions);
+            return changed.result;
+        }
+        let result;
+        await this.#state.update(SUBSCRIPTIONS_STATE_KEY, current => {
+            const document = subscriptionDocument(current);
+            const all = document.subscriptions.flatMap(value => { const item = parseStoredSubscription(value); return item ? [item] : []; });
+            const changed = change(all);
+            result = changed.result;
+            const subscriptions = changed.subscriptions.map(subscription => ({ ...subscription, regions: [...subscription.regions] }));
+            return Array.isArray(current) || current === undefined ? subscriptions : { ...document, subscriptions };
         });
+        return result;
     }
-    async #write(subscriptions) {
-        const plain = subscriptions.map((subscription) => ({ ...subscription, regions: [...subscription.regions] }));
-        await this.#state.set(SUBSCRIPTIONS_STATE_KEY, plain);
+    #run(scope, run) {
+        return this.#migrationScopes ? this.#migrationScopes.run({ scope, run }) : run();
     }
     #serialize(operation) {
         const next = this.#queue.then(operation, operation);

package/lib/subscriptions.js.map

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

package/lib/target-migration.d.ts

@@ -0,0 +1,8 @@
+import { TargetMigrationScopes, type PluginDatabaseHost, type PluginDataMigrationProvider, type PluginStateStore } from 'zhin.js/plugin-runtime';
+/** The selected subscription and its receipt commit in the same existing StateStore CAS. */
+export declare function createEarthquakeTargetMigration(input: Readonly<{
+    database: PluginDatabaseHost;
+    state: PluginStateStore;
+    scopes: TargetMigrationScopes;
+}>): PluginDataMigrationProvider;
+//# sourceMappingURL=target-migration.d.ts.map

package/lib/target-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-migration.d.ts","sourceRoot":"","sources":["../src/target-migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,qBAAqB,EAOrB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AA0EhC,4FAA4F;AAC5F,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC,GACxG,2BAA2B,CAkV7B"}

package/lib/target-migration.js

@@ -0,0 +1,376 @@
+import { generationAdmissionSource, DataMigrationError, normalizeDeliveryTarget, targetMigrationDigest, } from 'zhin.js/plugin-runtime';
+import { SUBSCRIPTIONS_STATE_KEY, subscriptionKey } from './subscriptions.js';
+import { subscriptionDocument, } from './migration-document.js';
+function plain(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function legacySelector(row) {
+    return {
+        adapter: row.adapter ?? null,
+        endpointKey: row.endpointKey ?? null,
+        conversationKind: row.conversationKind ?? null,
+        conversationId: row.conversationId ?? null,
+        target: row.target ?? null,
+    };
+}
+function units(document) {
+    const groups = new Map();
+    for (const [index, value] of document.subscriptions.entries()) {
+        const row = plain(value);
+        if (!row)
+            continue;
+        const selector = legacySelector(row), id = targetMigrationDigest(selector);
+        const group = groups.get(id) ?? {
+            indices: [],
+            rows: [],
+            selector,
+        };
+        group.indices.push(index);
+        group.rows.push(value);
+        groups.set(id, group);
+    }
+    return [...groups.entries()].map(([id, group]) => {
+        let status = Object.entries(group.selector).some(([key, value]) => key !== 'target' && (typeof value !== 'string' || !value))
+            ? 'corrupt'
+            : 'unresolved';
+        if (status !== 'corrupt' && group.selector.target !== null) {
+            try {
+                normalizeDeliveryTarget(group.selector.target);
+                status = 'canonical';
+            }
+            catch {
+                status = 'corrupt';
+            }
+        }
+        const first = group.rows[0];
+        return { ...group, id, status, scope: subscriptionKey(first), beforeDigest: targetMigrationDigest(group.rows) };
+    });
+}
+function receipt(plan, journal) {
+    if (!journal.operation)
+        return undefined;
+    return {
+        operation: journal.operation,
+        planId: plan.id,
+        candidateId: plan.candidateId,
+        beforeDigest: plan.beforeDigest,
+        afterDigest: journal.afterDigest,
+        recordCount: journal.recordCount,
+        status: 'applied',
+        maintenance: 'paused',
+    };
+}
+/** The selected subscription and its receipt commit in the same existing StateStore CAS. */
+export function createEarthquakeTargetMigration(input) {
+    const { database, state, scopes } = input, inFlight = new Set();
+    let revision = 0;
+    const read = async () => subscriptionDocument(await state.get(SUBSCRIPTIONS_STATE_KEY));
+    const dataOf = (plan) => {
+        if (plan.domain !== 'earthquake' || plan.sourceVersion !== 'subscription-alias-v0')
+            throw new DataMigrationError('invalid_input', 'Plan belongs to another domain');
+        const data = plan.data;
+        if (!data || data.format !== 'earthquake-target-v2')
+            throw new DataMigrationError('invalid_input', 'Unsupported earthquake migration plan');
+        return data;
+    };
+    const update = async (change) => {
+        await state.update(SUBSCRIPTIONS_STATE_KEY, (current) => change(subscriptionDocument(current)));
+    };
+    scopes.bindInitialization(async () => {
+        for (const [planId, entry] of Object.entries((await read()).migrations))
+            if (entry.phase !== 'resumed')
+                scopes.restorePause(planId, entry.scopes);
+    });
+    const snapshots = (plan, document) => {
+        const data = dataOf(plan), all = units(document);
+        const source = all.find((unit) => unit.id === plan.candidateId);
+        const destinationId = targetMigrationDigest(legacySelector(plain(data.after[0])));
+        const destination = all.find((unit) => unit.id === destinationId);
+        return { source, destination, before: source?.rows ?? [], after: destination?.rows ?? [] };
+    };
+    const baseline = (plan, document) => {
+        const snapshot = snapshots(plan, document);
+        return targetMigrationDigest({ source: snapshot.before, destination: snapshot.after });
+    };
+    const rewrite = (rows, target) => rows.map((row) => ({
+        ...plain(row),
+        target,
+        adapter: target.endpoint.adapter,
+        endpointKey: target.endpoint.id,
+        conversationKind: target.kind,
+        conversationId: target.id,
+    }));
+    const inspect = (plan, document) => {
+        const data = dataOf(plan), entry = document.migrations[plan.id], snapshot = snapshots(plan, document);
+        const local = scopes.maintenance(plan.id, data.scopes);
+        const maintenance = local === 'unknown'
+            ? 'unknown'
+            : local === 'paused' || (entry && entry.phase !== 'resumed')
+                ? 'paused'
+                : 'resumed';
+        if (entry && entry.planDigest !== targetMigrationDigest(plan))
+            return { data: 'conflict', maintenance: 'unknown', resumable: false };
+        if (!scopes.drained(data.scopes))
+            return { data: 'unknown', maintenance, resumable: false };
+        if (entry?.rejectedDigest)
+            return {
+                data: baseline(plan, document) === entry.rejectedDigest && !entry.operation ? 'not_applied' : 'conflict',
+                maintenance,
+                resumable: maintenance === 'paused' && baseline(plan, document) === entry.rejectedDigest,
+            };
+        const confirmed = entry ? receipt(plan, entry) : undefined;
+        if (confirmed?.operation === 'apply' &&
+            snapshot.before.length === 0 &&
+            targetMigrationDigest(snapshot.after) === targetMigrationDigest(data.after))
+            return { data: 'applied', maintenance, receipt: confirmed, resumable: maintenance === 'paused' };
+        if (confirmed?.operation === 'restore' &&
+            snapshot.after.length === 0 &&
+            targetMigrationDigest(snapshot.before) === targetMigrationDigest(data.before))
+            return { data: 'restored', maintenance, receipt: confirmed, resumable: maintenance === 'paused' };
+        if (!confirmed &&
+            snapshot.after.length === 0 &&
+            targetMigrationDigest(snapshot.before) === targetMigrationDigest(data.before))
+            return { data: 'not_applied', maintenance, resumable: maintenance === 'paused' };
+        return { data: 'conflict', maintenance, resumable: false };
+    };
+    const mutate = async (plan, run) => {
+        if (inFlight.has(plan.id))
+            throw new DataMigrationError('conflict', 'Migration operation is already in progress');
+        revision += 1;
+        inFlight.add(plan.id);
+        try {
+            return await run();
+        }
+        finally {
+            inFlight.delete(plan.id);
+        }
+    };
+    const intent = (plan) => ({
+        planDigest: targetMigrationDigest(plan),
+        candidateId: plan.candidateId,
+        beforeDigest: plan.beforeDigest,
+        afterDigest: '',
+        recordCount: plan.recordCount,
+        scopes: dataOf(plan).scopes,
+        phase: 'pausing',
+    });
+    const rejected = async (plan, phase) => {
+        await update((document) => {
+            const entry = document.migrations[plan.id];
+            if (!entry || entry.planDigest !== targetMigrationDigest(plan) || entry.phase !== phase)
+                throw new DataMigrationError('commit_unknown', 'Cannot confirm rejected subscription migration');
+            return {
+                ...document,
+                migrations: {
+                    ...document.migrations,
+                    [plan.id]: { ...entry, phase: 'rejected', rejectedDigest: baseline(plan, document) },
+                },
+            };
+        });
+    };
+    return {
+        title: 'Earthquake subscription destinations',
+        get [generationAdmissionSource]() {
+            return database[generationAdmissionSource];
+        },
+        async preview(request) {
+            request?.signal?.throwIfAborted();
+            const document = await read();
+            const candidates = units(document).map((unit) => ({
+                id: unit.id,
+                domain: 'earthquake',
+                title: `Earthquake: ${String(unit.selector.conversationId)}`,
+                sourceVersion: 'subscription-alias-v0',
+                recordCount: unit.rows.length,
+                beforeDigest: unit.beforeDigest,
+                status: unit.status,
+                summary: unit.selector,
+                executable: unit.status === 'unresolved',
+            }));
+            return { revision: targetMigrationDigest(candidates), candidates };
+        },
+        async prepare(request) {
+            request.signal?.throwIfAborted();
+            const document = await read(), unit = units(document).find((value) => value.id === request.candidateId);
+            if (!unit)
+                throw new DataMigrationError('not_found', 'Historical earthquake subscription no longer exists');
+            if (unit.status !== 'unresolved')
+                throw new DataMigrationError('unsupported', 'Only unresolved historical subscriptions need binding');
+            if (unit.beforeDigest !== request.expectedDigest)
+                throw new DataMigrationError('conflict', 'Subscriptions changed since preview');
+            const target = normalizeDeliveryTarget(request.target), after = rewrite(unit.rows, target);
+            const destinationScope = subscriptionKey(after[0]);
+            if (document.subscriptions.some((row, index) => !unit.indices.includes(index) &&
+                subscriptionKey(row) === destinationScope))
+                throw new DataMigrationError('conflict', 'Selected destination already has an earthquake subscription');
+            return {
+                id: request.planId,
+                candidateId: unit.id,
+                domain: 'earthquake',
+                sourceVersion: 'subscription-alias-v0',
+                beforeDigest: unit.beforeDigest,
+                target,
+                recordCount: unit.rows.length,
+                data: { format: 'earthquake-target-v2', before: unit.rows, after, scopes: [unit.scope, destinationScope] },
+                description: [
+                    'Bind the selected subscriptions without changing filters, creation facts or any other subscription.',
+                    'The existing subscriptions document and migration journal share one CAS; remain paused until explicit resumption.',
+                ],
+                authorizationCandidates: [],
+            };
+        },
+        async inspect({ plan, signal }) {
+            signal?.throwIfAborted();
+            const started = revision;
+            if (inFlight.has(plan.id))
+                return { data: 'unknown', maintenance: 'unknown', resumable: false };
+            const result = inspect(plan, await read());
+            return revision === started && !inFlight.has(plan.id)
+                ? result
+                : { data: 'unknown', maintenance: 'unknown', resumable: false };
+        },
+        async apply({ plan, signal }) {
+            return mutate(plan, async () => {
+                const data = dataOf(plan);
+                signal?.throwIfAborted();
+                await scopes.pause({
+                    planId: plan.id,
+                    scopes: data.scopes,
+                    persist: async () => update((document) => {
+                        const entry = document.migrations[plan.id];
+                        if (entry && entry.planDigest !== targetMigrationDigest(plan))
+                            throw new DataMigrationError('conflict', 'Plan ID refers to another migration');
+                        return entry
+                            ? document
+                            : { ...document, migrations: { ...document.migrations, [plan.id]: intent(plan) } };
+                    }),
+                });
+                let callbackFailure;
+                try {
+                    await update((document) => {
+                        try {
+                            signal?.throwIfAborted();
+                            const entry = document.migrations[plan.id];
+                            if (!entry || entry.phase !== 'pausing' || entry.planDigest !== targetMigrationDigest(plan))
+                                throw new DataMigrationError('conflict', 'Migration is not waiting for application');
+                            const snapshot = snapshots(plan, document);
+                            if (snapshot.after.length ||
+                                targetMigrationDigest(snapshot.before) !== targetMigrationDigest(data.before))
+                                throw new DataMigrationError('conflict', 'Subscriptions changed before the atomic migration');
+                            if (targetMigrationDigest(rewrite(snapshot.before, plan.target)) !== targetMigrationDigest(data.after))
+                                throw new DataMigrationError('invalid_input', 'Plan changes more than subscription routing');
+                            let position = 0;
+                            const subscriptions = document.subscriptions.map((row, index) => snapshot.source.indices.includes(index) ? data.after[position++] : row);
+                            return {
+                                ...document,
+                                subscriptions,
+                                migrations: {
+                                    ...document.migrations,
+                                    [plan.id]: {
+                                        ...entry,
+                                        phase: 'applied',
+                                        operation: 'apply',
+                                        afterDigest: targetMigrationDigest(data.after),
+                                    },
+                                },
+                            };
+                        }
+                        catch (error) {
+                            callbackFailure = error;
+                            throw error;
+                        }
+                    });
+                }
+                catch (error) {
+                    if (error === callbackFailure && error instanceof DataMigrationError)
+                        await rejected(plan, 'pausing');
+                    throw error;
+                }
+                const entry = (await read()).migrations[plan.id];
+                if (!entry?.operation)
+                    throw new DataMigrationError('commit_unknown', 'Migration receipt cannot be confirmed');
+                return receipt(plan, entry);
+            });
+        },
+        async resume({ plan, signal }) {
+            return mutate(plan, async () => {
+                const data = dataOf(plan);
+                signal?.throwIfAborted();
+                await update((document) => {
+                    const inspection = inspect(plan, document);
+                    if (!inspection.resumable && inspection.maintenance !== 'resumed')
+                        throw new DataMigrationError('conflict', 'Actual subscriptions do not permit resumption');
+                    const entry = document.migrations[plan.id] ?? intent(plan);
+                    return { ...document, migrations: { ...document.migrations, [plan.id]: { ...entry, phase: 'resumed' } } };
+                });
+                scopes.resume(plan.id, data.scopes);
+            });
+        },
+        async restore({ plan, receipt: original, signal }) {
+            return mutate(plan, async () => {
+                const data = dataOf(plan);
+                signal?.throwIfAborted();
+                await scopes.pause({
+                    planId: plan.id,
+                    scopes: data.scopes,
+                    persist: async () => update((document) => {
+                        const entry = document.migrations[plan.id];
+                        if (!entry ||
+                            entry.operation !== 'apply' ||
+                            entry.afterDigest !== original.afterDigest ||
+                            entry.planDigest !== targetMigrationDigest(plan))
+                            throw new DataMigrationError('conflict', 'Restoration needs the matching committed receipt');
+                        return {
+                            ...document,
+                            migrations: { ...document.migrations, [plan.id]: { ...entry, phase: 'restoring' } },
+                        };
+                    }),
+                });
+                let callbackFailure;
+                try {
+                    await update((document) => {
+                        try {
+                            signal?.throwIfAborted();
+                            const entry = document.migrations[plan.id];
+                            const snapshot = snapshots(plan, document);
+                            if (!entry ||
+                                entry.phase !== 'restoring' ||
+                                snapshot.before.length ||
+                                targetMigrationDigest(snapshot.after) !== targetMigrationDigest(data.after))
+                                throw new DataMigrationError('conflict', 'Subscriptions changed after migration; no records were overwritten');
+                            let position = 0;
+                            const subscriptions = document.subscriptions.map((row, index) => snapshot.destination.indices.includes(index) ? data.before[position++] : row);
+                            return {
+                                ...document,
+                                subscriptions,
+                                migrations: {
+                                    ...document.migrations,
+                                    [plan.id]: {
+                                        ...entry,
+                                        phase: 'restored',
+                                        operation: 'restore',
+                                        afterDigest: targetMigrationDigest(data.before),
+                                    },
+                                },
+                            };
+                        }
+                        catch (error) {
+                            callbackFailure = error;
+                            throw error;
+                        }
+                    });
+                }
+                catch (error) {
+                    if (error === callbackFailure && error instanceof DataMigrationError)
+                        await rejected(plan, 'restoring');
+                    throw error;
+                }
+                const entry = (await read()).migrations[plan.id];
+                if (!entry?.operation)
+                    throw new DataMigrationError('commit_unknown', 'Restoration receipt cannot be confirmed');
+                return receipt(plan, entry);
+            });
+        },
+    };
+}
+//# sourceMappingURL=target-migration.js.map

package/lib/target-migration.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-earthquake",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Earthquake query and group alert plugin for Zhin.js — CENC + USGS, magnitude/region subscriptions (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -41,21 +41,21 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/skill": "1.1.10",
-    "@zhin.js/tool": "1.1.11"
+    "@zhin.js/skill": "1.1.11",
+    "@zhin.js/tool": "1.1.13"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/command": "1.1.11",
-    "@zhin.js/testing": "1.0.6",
-    "zhin.js": "1.1.17"
+    "@zhin.js/command": "1.1.12",
+    "@zhin.js/testing": "1.0.7",
+    "zhin.js": "1.1.19"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/command": "^1.1.11",
-    "zhin.js": "^1.1.17"
+    "@zhin.js/command": "^1.1.12",
+    "zhin.js": "^1.1.19"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {

package/plugin.js

@@ -1,10 +1,12 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { DataMigrationError, pluginDataMigrationProviderToken, TargetMigrationScopes } from 'zhin.js/plugin-runtime';
+import { createEarthquakeTargetMigration } from "./lib/target-migration.js";
 import { resolveLocale } from 'zhin.js/i18n';
 import { databaseHostToken, definePlugin, logger, outboundHostToken, scheduleHostToken, } from 'zhin.js';
 import { assertEarthquakeTimezone, resolveEarthquakeConfig, } from "./lib/config.js";
 import { earthquakeServiceToken } from "./lib/runtime.js";
 import { EarthquakeService } from "./lib/service.js";
-import { createMemoryState, SubscriptionStore } from "./lib/subscriptions.js";
+import { createMemoryState, SubscriptionStore, subscriptionKey } from "./lib/subscriptions.js";
 /**
  * Plugin Runtime:
  * - Commands: `地震` query, `地震 订阅` / `地震 退订` / `地震 订阅状态`.
@@ -21,9 +23,12 @@ export default definePlugin({
         const config = resolveEarthquakeConfig(context.config.get());
         assertEarthquakeTimezone(config.timezone);
         let state;
-        if (context.resources.has(databaseHostToken)) {
+        let durableState;
+        const database = context.resources.has(databaseHostToken) ? context.resources.use(databaseHostToken) : undefined;
+        if (database) {
             try {
-                state = context.resources.use(databaseHostToken).state;
+                durableState = database.state;
+                state = durableState;
             }
             catch {
                 // No persistent state port: fall back to memory below.
@@ -32,20 +37,27 @@ export default definePlugin({
         const store = new SubscriptionStore(state ?? createMemoryState(), {
             maxSubscriptions: config.maxSubscriptions,
         });
+        const migrationScopes = database && durableState ? new TargetMigrationScopes({ pending: scope => !scope.startsWith('canonical:') }) : undefined;
+        if (database && durableState && migrationScopes) {
+            store.bindMigrationScopes(migrationScopes);
+            context.resources.provide(pluginDataMigrationProviderToken, createEarthquakeTargetMigration({ database,
+                state: durableState, scopes: migrationScopes }));
+        }
         let push;
         if (context.resources.has(outboundHostToken)) {
             const outbound = context.resources.use(outboundHostToken);
             push = async (subscription, content) => {
-                await outbound.send({
-                    adapter: subscription.adapter,
-                    endpointKey: subscription.endpointKey,
-                    conversation: {
-                        kind: subscription.conversationKind,
-                        id: subscription.conversationId,
-                    },
-                    content,
-                    locale: resolveLocale(subscription.locale),
-                });
+                const target = subscription.target;
+                if (!target)
+                    throw new DataMigrationError('unavailable', 'Historical earthquake subscription awaits exact-target binding');
+                const send = outbound.sendTarget;
+                if (!send)
+                    throw new Error('Canonical subscription delivery requires an exact-target Outbound Host');
+                const run = async () => { await send(target, content, { locale: resolveLocale(subscription.locale) }); };
+                if (migrationScopes)
+                    await migrationScopes.run({ scope: subscriptionKey(subscription), run });
+                else
+                    await run();
             };
         }
         const service = new EarthquakeService({