@gadicc/loom 1.23.0 → 1.24.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.
@@ -0,0 +1,10 @@
1
+ /** App-owned production release settings in features.db.config.release. */
2
+ export type DbReleaseConfig = {
3
+ /** Literal short Git branch name; omitted settings retain the main default. */
4
+ productionBranch?: string;
5
+ };
6
+ /** Portable literal branch names, excluding Git-invalid paths and glob syntax. */
7
+ export declare const PRODUCTION_BRANCH_PATTERN: string;
8
+ /** Resolve the release branch before writing provider configuration or checking it. */
9
+ export declare function resolveProductionBranch(release: unknown): string;
10
+ //# sourceMappingURL=releaseConfig.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"releaseConfig.d.ts","sourceRoot":"","sources":["../../../src/src/cli/releaseConfig.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG;IAC5B,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,QAC8E,CAAC;AAErH,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAuBhE"}
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PRODUCTION_BRANCH_PATTERN = void 0;
4
+ exports.resolveProductionBranch = resolveProductionBranch;
5
+ /** Portable literal branch names, excluding Git-invalid paths and glob syntax. */
6
+ exports.PRODUCTION_BRANCH_PATTERN = String
7
+ .raw `^(?!HEAD$)(?!refs/)(?!.*(?:\.\.|//|/\.))(?!.*\.lock(?:/|$))(?!.*[/.]$)[A-Za-z0-9_][A-Za-z0-9._/-]*(?![\s\S])`;
8
+ /** Resolve the release branch before writing provider configuration or checking it. */
9
+ function resolveProductionBranch(release) {
10
+ if (release === undefined)
11
+ return "main";
12
+ if (typeof release !== "object" || release === null || Array.isArray(release)) {
13
+ throw new Error("features.db.config.release must be an object.");
14
+ }
15
+ if (Object.keys(release).some((key) => key !== "productionBranch")) {
16
+ throw new Error("features.db.config.release only supports productionBranch.");
17
+ }
18
+ const branch = release.productionBranch;
19
+ if (branch === undefined)
20
+ return "main";
21
+ if (typeof branch !== "string" ||
22
+ !new RegExp(exports.PRODUCTION_BRANCH_PATTERN).test(branch)) {
23
+ throw new Error("features.db.config.release.productionBranch must be a literal short Git branch name using letters, numbers, underscores, dots, hyphens or slashes; patterns and refs/ prefixes are not supported.");
24
+ }
25
+ return branch;
26
+ }
@@ -6,6 +6,10 @@ export declare const DEFAULT_LOOM_PWA_UPDATE_PROMPT = "A newer version of this w
6
6
  export interface LoomSerwistLifecycleEvent {
7
7
  /** Whether Serwist identified the event as an update to an existing worker. */
8
8
  isUpdate?: boolean;
9
+ /** Worker associated with this event, when supplied by the integration. */
10
+ sw?: ServiceWorker;
11
+ /** Whether another registration or tab initiated this lifecycle event. */
12
+ isExternal?: boolean;
9
13
  /** The Serwist lifecycle event name. */
10
14
  type: string;
11
15
  /** Whether a waiting service worker existed before registration completed. */
@@ -21,7 +25,7 @@ export type LoomSerwistEventName = "activated" | "controlling" | "installed" | "
21
25
  */
22
26
  export interface LoomWindowSerwist {
23
27
  addEventListener: (type: LoomSerwistEventName, listener: (event: LoomSerwistLifecycleEvent) => void) => void;
24
- messageSkipWaiting: () => Promise<void>;
28
+ messageSkipWaiting: () => void | Promise<void>;
25
29
  register: () => Promise<ServiceWorkerRegistration | undefined>;
26
30
  removeEventListener: (type: LoomSerwistEventName, listener: (event: LoomSerwistLifecycleEvent) => void) => void;
27
31
  }
@@ -80,6 +84,7 @@ export interface LoomPwaLifecycleOptions {
80
84
  updateMode?: LoomPwaUpdateMode;
81
85
  }
82
86
  declare global {
87
+ var serwist: LoomWindowSerwist | undefined;
83
88
  interface Window {
84
89
  serwist?: LoomWindowSerwist;
85
90
  }
@@ -87,7 +92,10 @@ declare global {
87
92
  /**
88
93
  * Registers Loom's Serwist lifecycle listeners and optional update polling.
89
94
  *
90
- * The returned cleanup function removes listeners and clears the polling timer.
95
+ * Cleanup removes this observer's listeners and polling without unregistering
96
+ * the worker or removing offline caches. Pending callbacks cannot activate or
97
+ * reload after cleanup. Registration is shared across effect remounts.
98
+ *
91
99
  * In `prompt` mode, a waiting worker is activated only after `canReloadNow` and
92
100
  * `confirmUpdate` both allow it; in `manual` mode Loom reports availability but
93
101
  * never activates the worker for the app.
@@ -1 +1 @@
1
- {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/next/pwa/mod.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/next/pwa/mod.tsx"],"names":[],"mappings":"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"}
@@ -51,13 +51,24 @@ function reportError(error, onError, logger) {
51
51
  (logger ?? console).error("[PWA] Service worker lifecycle error", error);
52
52
  }
53
53
  }
54
- async function canApplyUpdate(context, options) {
55
- return await (options.canReloadNow?.(context) ?? true);
54
+ const registrations = new WeakMap();
55
+ function registerOnce(serwist) {
56
+ let pending = registrations.get(serwist);
57
+ if (!pending) {
58
+ // React effects can remount while registration is still waiting for load.
59
+ pending = Promise.resolve().then(() => serwist.register());
60
+ registrations.set(serwist, pending);
61
+ void pending.catch(() => registrations.delete(serwist));
62
+ }
63
+ return pending;
56
64
  }
57
65
  /**
58
66
  * Registers Loom's Serwist lifecycle listeners and optional update polling.
59
67
  *
60
- * The returned cleanup function removes listeners and clears the polling timer.
68
+ * Cleanup removes this observer's listeners and polling without unregistering
69
+ * the worker or removing offline caches. Pending callbacks cannot activate or
70
+ * reload after cleanup. Registration is shared across effect remounts.
71
+ *
61
72
  * In `prompt` mode, a waiting worker is activated only after `canReloadNow` and
62
73
  * `confirmUpdate` both allow it; in `manual` mode Loom reports availability but
63
74
  * never activates the worker for the app.
@@ -71,8 +82,19 @@ function setupLoomPwaLifecycle(options = {}) {
71
82
  const logger = options.logger === false ? false : options.logger ?? console;
72
83
  const reload = options.reload ?? defaultReload;
73
84
  let disposed = false;
74
- let reloadOnNextControl = false;
85
+ let reloaded = false;
86
+ let reloadPending = false;
87
+ let approvedWorker;
88
+ let legacyApproval = false;
89
+ let registration;
75
90
  let updateInterval;
91
+ let updatePending = false;
92
+ let promptQueue = Promise.resolve();
93
+ const pendingWaiting = new WeakSet();
94
+ const decidedWaiting = new WeakSet();
95
+ const controller = () => navigator.serviceWorker.controller;
96
+ let previousController = controller();
97
+ let latestControl;
76
98
  const makeContext = (reason, event) => ({
77
99
  event,
78
100
  isUpdate: event.isUpdate ?? reason === "waiting",
@@ -80,77 +102,166 @@ function setupLoomPwaLifecycle(options = {}) {
80
102
  serwist,
81
103
  wasWaitingBeforeRegister: event.wasWaitingBeforeRegister,
82
104
  });
105
+ const failed = (error) => {
106
+ if (!disposed)
107
+ reportError(error, options.onError, options.logger);
108
+ };
83
109
  const deferUpdate = (context) => {
110
+ if (disposed)
111
+ return;
84
112
  options.onUpdateDeferred?.(context);
85
113
  logger && logger.info("[PWA] Update deferred.");
86
114
  };
115
+ const isCurrent = (worker) => !worker || controller() === worker ||
116
+ worker.state === "activating" || worker.state === "activated" ||
117
+ (worker.state !== "redundant" &&
118
+ (!registration || registration.waiting === worker));
119
+ const applyControl = async (context) => {
120
+ const current = controller();
121
+ const approved = approvedWorker
122
+ ? current === approvedWorker
123
+ : legacyApproval;
124
+ if (disposed || reloaded || reloadPending ||
125
+ (!approved && (updateMode !== "auto" || !context.isUpdate)))
126
+ return;
127
+ // Reserve before awaiting the app's guard; controller events can overlap.
128
+ reloadPending = true;
129
+ try {
130
+ const allowed = await (options.canReloadNow?.(context) ?? true);
131
+ if (disposed || reloaded || current !== controller())
132
+ return;
133
+ if (!allowed) {
134
+ deferUpdate(context);
135
+ return;
136
+ }
137
+ reloaded = true;
138
+ options.onUpdateActivated?.(context);
139
+ if (!disposed)
140
+ reload();
141
+ }
142
+ finally {
143
+ reloadPending = false;
144
+ }
145
+ };
87
146
  const handleWaiting = async (event) => {
147
+ const key = event.sw ?? event;
148
+ if (disposed || reloaded || decidedWaiting.has(key))
149
+ return;
88
150
  const context = makeContext("waiting", event);
89
151
  options.onUpdateAvailable?.(context);
152
+ if (disposed)
153
+ return;
90
154
  if (updateMode === "manual") {
91
155
  deferUpdate(context);
92
156
  return;
93
157
  }
94
- if (!(await canApplyUpdate(context, options))) {
158
+ const allowed = await (options.canReloadNow?.(context) ?? true);
159
+ if (disposed || reloaded)
160
+ return;
161
+ if (!allowed || !isCurrent(event.sw)) {
95
162
  deferUpdate(context);
96
163
  return;
97
164
  }
98
165
  const accepted = updateMode === "auto"
99
166
  ? true
100
167
  : await (options.confirmUpdate?.(context) ?? defaultConfirmUpdate());
101
- if (!accepted) {
168
+ if (disposed || reloaded)
169
+ return;
170
+ decidedWaiting.add(key);
171
+ if (!accepted || !isCurrent(event.sw)) {
102
172
  deferUpdate(context);
103
173
  return;
104
174
  }
105
- reloadOnNextControl = true;
175
+ approvedWorker = event.sw;
176
+ legacyApproval = !event.sw;
106
177
  options.onUpdateAccepted?.(context);
107
- await serwist.messageSkipWaiting();
108
- };
109
- const handleControlling = async (event) => {
110
- const context = makeContext("controlling", event);
111
- if (!context.isUpdate || (!reloadOnNextControl && updateMode !== "auto")) {
178
+ if (disposed || reloaded)
112
179
  return;
180
+ if (event.sw && controller() === event.sw) {
181
+ // Another tab may have activated the accepted worker during the prompt.
182
+ await applyControl(latestControl ?? makeContext("controlling", {
183
+ type: "controlling",
184
+ isUpdate: true,
185
+ sw: event.sw,
186
+ }));
113
187
  }
114
- if (!(await canApplyUpdate(context, options))) {
115
- deferUpdate(context);
116
- return;
188
+ else if (event.sw) {
189
+ // Serwist's messageSkipWaiting selects whichever worker is waiting now.
190
+ // Address the approved identity so a replacement cannot inherit consent.
191
+ if (event.sw.state !== "activating" && event.sw.state !== "activated") {
192
+ event.sw.postMessage({ type: "SKIP_WAITING" });
193
+ }
194
+ }
195
+ else {
196
+ // Preserve integrations that implement the original identity-free API.
197
+ await serwist.messageSkipWaiting();
117
198
  }
118
- options.onUpdateActivated?.(context);
119
- reload();
120
199
  };
121
200
  const waitingListener = (event) => {
122
- handleWaiting(event).catch((error) => reportError(error, options.onError, options.logger));
201
+ const key = event.sw ?? event;
202
+ if (disposed || reloaded || pendingWaiting.has(key))
203
+ return;
204
+ pendingWaiting.add(key);
205
+ // The shared confirmation UI has one dialog. Serialize different workers.
206
+ promptQueue = promptQueue.then(() => handleWaiting(event)).catch(failed)
207
+ .finally(() => pendingWaiting.delete(key));
123
208
  };
124
209
  const controllingListener = (event) => {
125
- handleControlling(event).catch((error) => reportError(error, options.onError, options.logger));
210
+ if (disposed)
211
+ return;
212
+ const current = controller();
213
+ const context = makeContext("controlling", event);
214
+ // Serwist snapshots isUpdate at registration, even on a first-install page
215
+ // that later receives updates. Its external event.sw can also be outdated.
216
+ context.isUpdate ||= Boolean(previousController && current !== previousController);
217
+ previousController = current;
218
+ latestControl = context;
219
+ void applyControl(context).catch(failed);
126
220
  };
127
221
  serwist.addEventListener("waiting", waitingListener);
128
222
  serwist.addEventListener("controlling", controllingListener);
223
+ const observeRegistration = (value) => {
224
+ if (disposed || !value)
225
+ return;
226
+ registration = value;
227
+ // Cached registration does not emit waiting again when an effect remounts.
228
+ if (value.waiting) {
229
+ waitingListener({
230
+ type: "waiting",
231
+ sw: value.waiting,
232
+ wasWaitingBeforeRegister: true,
233
+ });
234
+ }
235
+ };
129
236
  if (options.register ?? true) {
130
- serwist.register().catch((error) => reportError(error, options.onError, options.logger));
237
+ void registerOnce(serwist).then(observeRegistration).catch(failed);
131
238
  }
132
239
  if (options.updateCheckIntervalMs !== undefined &&
133
240
  options.updateCheckIntervalMs > 0) {
134
- navigator.serviceWorker.ready
135
- .then((registration) => {
136
- if (disposed) {
241
+ void navigator.serviceWorker.ready.then((value) => {
242
+ if (disposed)
137
243
  return;
138
- }
139
- logger &&
140
- logger.info(`[PWA] Will check for updates every ${options.updateCheckIntervalMs / 1000} seconds.`);
244
+ registration = value;
245
+ logger && logger.info(`[PWA] Will check for updates every ${options.updateCheckIntervalMs / 1000} seconds.`);
141
246
  updateInterval = setInterval(() => {
142
- registration.update().catch((error) => reportError(error, options.onError, options.logger));
247
+ if (disposed || updatePending)
248
+ return;
249
+ updatePending = true;
250
+ void Promise.resolve().then(() => {
251
+ if (!disposed)
252
+ return value.update();
253
+ }).catch(failed).finally(() => {
254
+ updatePending = false;
255
+ });
143
256
  }, options.updateCheckIntervalMs);
144
- })
145
- .catch((error) => reportError(error, options.onError, options.logger));
257
+ }).catch(failed);
146
258
  }
147
259
  return () => {
148
260
  disposed = true;
149
261
  serwist.removeEventListener("waiting", waitingListener);
150
262
  serwist.removeEventListener("controlling", controllingListener);
151
- if (updateInterval !== undefined) {
263
+ if (updateInterval !== undefined)
152
264
  clearInterval(updateInterval);
153
- }
154
265
  };
155
266
  }
156
267
  /**
@@ -71,7 +71,11 @@ Use this skill when working on the shared DB stack from a consuming app.
71
71
  - Confirm active Loom-managed feature schemas match their recorded hash in
72
72
  `loom.json` and are exported from the app-local schema barrel.
73
73
  - For Vercel production releases, confirm `vercel.json` disables automatic
74
- `main` deployments and GitHub Actions builds with Vercel production settings,
74
+ deployments for the configured production branch and GitHub Actions builds
75
+ with Vercel production settings. The branch defaults to `main`; apps using
76
+ another branch set `features.db.config.release.productionBranch` in
77
+ `loom.json` and match the Vercel project production branch, workflow trigger
78
+ and deployment fence. Workflows and `vercel.json` remain app-owned. The flow
75
79
  uploads a staged production deployment with `--prebuilt --prod --skip-domain`,
76
80
  runs `db:migrate`, and then promotes the staged deployment. Before adding
77
81
  build-only placeholders, preserve an untouched copy of the pulled env file for