target-supabase-sdk 0.2.4 → 0.2.6

package/dist/preload.js

@@ -1,5 +1,5 @@
 import { resolve } from 'node:path';
-import { r as resolveProjectRootByPackageName, p as pinEnvProfileFromArgv, l as loadEnvFiles, v as validateLogPersistPreloadEnv, a as logPersistEnabledFromEnv } from './chunks/enable-log-persist-B8rg_wXG.js';
+import { r as resolveProjectRootByPackageName, p as pinEnvProfileFromArgv, l as loadEnvFiles, v as validateLogPersistPreloadEnv, a as logPersistEnabledFromEnv } from './chunks/enable-log-persist-BL2FaGQp.js';
 import 'node:fs';
 import 'node:url';
 import 'node:fs/promises';

package/dist/service/config.api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.api.d.ts","sourceRoot":"","sources":["../../src/service/config.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,aAAa,EAA8B,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,qBAAqB,CAAC;AAI1E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAYvB,CAAC;AAEN,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE/D,wEAAwE;AACxE,eAAO,MAAM,4BAA4B;;;;;;EAEvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,8BAA8B;IACvC,wEAAwE;;;;;;;;;;;;;;;;;;;EAG1E,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE7F,qGAAqG;AACrG,eAAO,MAAM,+BAA+B;IARxC,wEAAwE;;;;;;;;;;;;;;;;;;;EAQC,CAAC;AAE9E,MAAM,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;AAK/E,uFAAuF;AACvF,eAAO,MAAM,kCAAkC,EAAE,SAAS,sBAAsB,EAKtE,CAAC;AAkBX,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,GAAG,WAAW,EAAE,CAMlG;AAgBD,yEAAyE;AACzE,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,aAAa,CAO7F;AAED,+EAA+E;AAC/E,eAAO,MAAM,SAAS;;;;UAaW,MAAM;;;;;;YA1GnC,CAAC;;;;;;;;;YAAD,CAAC;;;UA0G4B,MAAM;;;;;;YA1GnC,CAAC;;;;;;;;;YAAD,CAAC;;EA6HH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;4FAsBnC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;4FA2CpC,CAAC"}
+{"version":3,"file":"config.api.d.ts","sourceRoot":"","sources":["../../src/service/config.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,EAAkB,KAAK,MAAM,EAAE,KAAK,aAAa,EAA8B,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,qBAAqB,CAAC;AAI1E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAYvB,CAAC;AAEN,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE/D,wEAAwE;AACxE,eAAO,MAAM,4BAA4B;;;;;;EAEvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,8BAA8B;IACvC,wEAAwE;;;;;;;;;;;;;;;;;;;EAG1E,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE7F,qGAAqG;AACrG,eAAO,MAAM,+BAA+B;IARxC,wEAAwE;;;;;;;;;;;;;;;;;;;EAQC,CAAC;AAE9E,MAAM,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;AAK/E,uFAAuF;AACvF,eAAO,MAAM,kCAAkC,EAAE,SAAS,sBAAsB,EAMtE,CAAC;AAkBX,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,GAAG,WAAW,EAAE,CAMlG;AAgBD,yEAAyE;AACzE,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,aAAa,CAO7F;AAED,+EAA+E;AAC/E,eAAO,MAAM,SAAS;;;;UAaW,MAAM;;;;;;YA3GnC,CAAC;;;;;;;;;YAAD,CAAC;;;UA2G4B,MAAM;;;;;;YA3GnC,CAAC;;;;;;;;;YAAD,CAAC;;EA8HH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;4FAsBnC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;4FA2CpC,CAAC"}

package/dist/service/index.d.ts

@@ -7,8 +7,8 @@ export type { GetConfigPayload, PostSystemRegistryConfigPayload, ResetSystemRegi
 export { buildEmptyServiceSlots, buildSystemRegistryConfigDetails, DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS, getConfig, getConfigSchema, postSystemRegistryConfig, postSystemRegistryConfigSchema, resetSystemRegistryConfig, resetSystemRegistryConfigSchema, systemRegistrySeedSlotSchema, } from "./config.api";
 export type { Config, ConfigDetails } from "./config.interface";
 export { CategoryConfig, TARGET_SYSTEM_REGISTRY_KEY } from "./config.interface";
-export type { PatchServiceRuntimeInput, RegisterServiceInput, TargetSystemRegistrySlotView, TargetSystemRegistryView, } from "./registry.service";
-export { assertRegistrySlotAvailable, assertRegistrySlotOwner, getTargetSystemRegistry, parseServiceSlot, parseServiceSlots, patchServiceRuntime, registerService, registerServiceAtStartup, resolveActiveRegistryServiceId, ServiceRegistryError, unregisterService, unregisterServiceAtShutdown, } from "./registry.service";
+export type { AppendSystemRegistrySlotsInput, AppendSystemRegistrySlotsOutcome, PatchServiceRuntimeInput, RegisterServiceInput, ReleasedRegistrySlot, ReleaseSystemRegistrySlotsInput, ReleaseSystemRegistrySlotsOutcome, TargetSystemRegistrySlotView, TargetSystemRegistryView, } from "./registry.service";
+export { appendSystemRegistrySlots, assertRegistrySlotAvailable, assertRegistrySlotOwner, getTargetSystemRegistry, parseServiceSlot, parseServiceSlots, patchServiceRuntime, registerService, registerServiceAtStartup, releaseSystemRegistrySlots, resolveActiveRegistryServiceId, ServiceRegistryError, unregisterService, unregisterServiceAtShutdown, } from "./registry.service";
 export type { ClaimRegistrySlotInput, RegistrySlotGuardResult, RegistrySlotRuntimeState, ServiceRegistrySession, } from "./registry-lifecycle";
 export { claimServiceRegistrySlot, createClaimedRegistrySlotRuntimeState, EMPTY_REGISTRY_SLOT_RUNTIME_STATE, registrySlotRuntimePatchFromGuardResult, runRegistrySlotGuardCheck, } from "./registry-lifecycle";
 export type { GetApiPayload, GetServicePayload, PostApiPayload, PostServicePayload } from "./service.api";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACR,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACR,gBAAgB,EAChB,+BAA+B,EAC/B,gCAAgC,EAChC,sBAAsB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,sBAAsB,EACtB,gCAAgC,EAChC,kCAAkC,EAClC,SAAS,EACT,eAAe,EACf,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,GAC/B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EACR,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,8BAA8B,EAC9B,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACR,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,wBAAwB,EACxB,qCAAqC,EACrC,iCAAiC,EACjC,uCAAuC,EACvC,yBAAyB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1G,OAAO,EACH,gBAAgB,EAChB,qBAAqB,EACrB,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EACR,GAAG,EACH,UAAU,EACV,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,WAAW,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACjG,YAAY,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EACH,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,GACtB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACR,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACR,gBAAgB,EAChB,+BAA+B,EAC/B,gCAAgC,EAChC,sBAAsB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,sBAAsB,EACtB,gCAAgC,EAChC,kCAAkC,EAClC,SAAS,EACT,eAAe,EACf,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,GAC/B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EACR,8BAA8B,EAC9B,gCAAgC,EAChC,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,+BAA+B,EAC/B,iCAAiC,EACjC,4BAA4B,EAC5B,wBAAwB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACR,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,wBAAwB,EACxB,qCAAqC,EACrC,iCAAiC,EACjC,uCAAuC,EACvC,yBAAyB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1G,OAAO,EACH,gBAAgB,EAChB,qBAAqB,EACrB,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EACR,GAAG,EACH,UAAU,EACV,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,WAAW,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACjG,YAAY,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EACH,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/service/registry.service.d.ts

@@ -27,6 +27,36 @@ export interface RegisterServiceInput {
     traceId?: string;
     maxAttempts?: number;
 }
+export interface ReleaseSystemRegistrySlotsInput {
+    /** Logical service keys whose ACTIVE slots should be forced to EMPTY (e.g. `watch-service`). */
+    serviceValues: string[];
+    traceId?: string;
+    maxAttempts?: number;
+}
+export interface ReleasedRegistrySlot {
+    serviceValue: string;
+    serviceId: string;
+    slotIndex: number;
+}
+export interface ReleaseSystemRegistrySlotsOutcome {
+    config: Config;
+    released: ReleasedRegistrySlot[];
+    /** Requested `serviceValues` with no ACTIVE slot released (already EMPTY or never bound). */
+    unchangedServiceValues: string[];
+}
+export interface AppendSystemRegistrySlotsInput {
+    /** Logical service keys to declare with one new EMPTY slot each when missing. */
+    serviceValues: string[];
+    traceId?: string;
+    maxAttempts?: number;
+}
+export interface AppendSystemRegistrySlotsOutcome {
+    config: Config;
+    /** Service keys that received a new EMPTY slot this run. */
+    added: string[];
+    /** Requested keys that already had at least one declared slot — no change. */
+    skipped: string[];
+}
 export declare class ServiceRegistryError extends Error {
     readonly code: "REGISTRY_CONFIG_NOT_FOUND" | "SERVICE_NOT_DECLARED" | "SERVICE_SLOTS_FULL" | "REGISTRY_SLOT_LOST" | "REGISTRY_UPDATE_FAILED";
     constructor(message: string, code: "REGISTRY_CONFIG_NOT_FOUND" | "SERVICE_NOT_DECLARED" | "SERVICE_SLOTS_FULL" | "REGISTRY_SLOT_LOST" | "REGISTRY_UPDATE_FAILED");
@@ -53,6 +83,18 @@ export declare function assertRegistrySlotOwner(input: {
     serviceValue: string;
     serviceId: string;
 }): Promise<void>;
+/**
+ * Force-release ACTIVE registry slots for the given logical service keys (`ACTIVE → EMPTY`).
+ * Ops/dev recovery when a process crashed without {@link unregisterService}.
+ * Does not delete Service rows or mutate `details.runtime`.
+ */
+export declare function releaseSystemRegistrySlots(input: ReleaseSystemRegistrySlotsInput): Promise<ReleaseSystemRegistrySlotsOutcome>;
+/**
+ * Append EMPTY {@link ServiceSlot} rows for logical service keys not yet declared.
+ * Idempotent — skips keys that already appear in `details.objects`.
+ * Does not modify existing slots or release ACTIVE bindings.
+ */
+export declare function appendSystemRegistrySlots(input: AppendSystemRegistrySlotsInput): Promise<AppendSystemRegistrySlotsOutcome>;
 /**
  * Claim one EMPTY slot for a running Service instance (`EMPTY → ACTIVE` only).
  *

package/dist/service/registry.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.service.d.ts","sourceRoot":"","sources":["../../src/service/registry.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,KAAK,MAAM,EAAkD,MAAM,oBAAoB,CAAC;AAEjG,OAAO,EACH,KAAK,OAAO,EAGZ,KAAK,WAAW,EAEnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAUhE,MAAM,WAAW,4BAA4B;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,mEAAmE;IACnE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,4BAA4B,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACjC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,IAAI,EACP,2BAA2B,GAC3B,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB;gBAN9B,OAAO,EAAE,MAAM,EACN,IAAI,EACP,2BAA2B,GAC3B,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB;CAKrC;AAcD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA2BnE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAS/D;AAqCD;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAejF;AA2BD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBrF;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB/G;AA+CD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFhF;AAED,yEAAyE;AACzE,wBAAsB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQjG;AAUD,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,iFAAiF;AACjF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ElF;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5F"}
+{"version":3,"file":"registry.service.d.ts","sourceRoot":"","sources":["../../src/service/registry.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,KAAK,MAAM,EAAkD,MAAM,oBAAoB,CAAC;AAEjG,OAAO,EACH,KAAK,OAAO,EAGZ,KAAK,WAAW,EAEnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAUhE,MAAM,WAAW,4BAA4B;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,mEAAmE;IACnE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,4BAA4B,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACjC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,+BAA+B;IAC5C,gGAAgG;IAChG,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,6FAA6F;IAC7F,sBAAsB,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC3C,iFAAiF;IACjF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,IAAI,EACP,2BAA2B,GAC3B,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB;gBAN9B,OAAO,EAAE,MAAM,EACN,IAAI,EACP,2BAA2B,GAC3B,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB;CAKrC;AAcD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA2BnE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAS/D;AAqCD;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAejF;AA2BD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBrF;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB/G;AA+ED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC5C,KAAK,EAAE,+BAA+B,GACvC,OAAO,CAAC,iCAAiC,CAAC,CAqG5C;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC3C,KAAK,EAAE,8BAA8B,GACtC,OAAO,CAAC,gCAAgC,CAAC,CAuF3C;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFhF;AAED,yEAAyE;AACzE,wBAAsB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQjG;AAUD,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,iFAAiF;AACjF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ElF;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5F"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "target-supabase-sdk",
-    "version": "0.2.4",
+    "version": "0.2.6",
     "description": "Supabase client initializer and data access APIs",
     "license": "MIT",
     "author": "KyLoc20",
@@ -56,8 +56,6 @@
         "worker:trigger": "tsx scripts/run-trigger-node.ts",
         "post-command": "tsx scripts/post-command.ts",
         "post-trigger": "tsx scripts/post-trigger.ts",
-        "seed:system-registry": "tsx scripts/seed-system-registry.ts",
-        "reset:system-registry": "tsx scripts/reset-system-registry.ts",
         "parcel:split": "tsx scripts/parcel-split-local.ts",
         "parcel:restore": "tsx scripts/parcel-restore-local.ts",
         "dev": "rollup -c --watch",

package/src/browser.ts

@@ -104,6 +104,8 @@ export * from "./repo/repo.interface";
 export type {
     Api,
     ApiDetails,
+    AppendSystemRegistrySlotsInput,
+    AppendSystemRegistrySlotsOutcome,
     ClaimRegistrySlotInput,
     Config,
     ConfigDetails,
@@ -118,6 +120,9 @@ export type {
     RegisterServiceInput,
     RegistrySlotGuardResult,
     RegistrySlotRuntimeState,
+    ReleasedRegistrySlot,
+    ReleaseSystemRegistrySlotsInput,
+    ReleaseSystemRegistrySlotsOutcome,
     ResetSystemRegistryConfigPayload,
     Service,
     ServiceBootstrapResult,
@@ -133,6 +138,7 @@ export type {
 export {
     ApiMethod,
     apiDetailsSchema,
+    appendSystemRegistrySlots,
     assertRegistrySlotAvailable,
     assertRegistrySlotOwner,
     buildEmptyServiceSlots,
@@ -166,6 +172,7 @@ export {
     registerService,
     registerServiceAtStartup,
     registrySlotRuntimePatchFromGuardResult,
+    releaseSystemRegistrySlots,
     resetSystemRegistryConfig,
     resetSystemRegistryConfigSchema,
     resolveActiveRegistryServiceId,
@@ -256,4 +263,3 @@ export type { PostTaskWithRetryOptions, PostTaskWithRetryResult } from "./task/t
 export { POST_TASK_DEFAULT_MAX_ATTEMPTS, postTaskWithRetry } from "./task/task-post-retry.api";
 export type { TaskStatusCount } from "./task/task-queue";
 export { countTasksByType, summarizeTaskQueue } from "./task/task-queue";
-export * from "./word/word.interface";

package/src/node/fs/json-state-store.ts

@@ -76,8 +76,11 @@ export function createJsonFileStateStore<T extends object, NK extends keyof T =
                 const raw = await readFile(filePath, "utf8");
                 const parsed = JSON.parse(raw) as Partial<T>;
                 return mergeWithNested(defaultState, parsed, {}, nestedKeys);
-            } catch {
-                return { ...defaultState };
+            } catch (error) {
+                if ((error as NodeJS.ErrnoException).code === "ENOENT") {
+                    return mergeWithNested(defaultState, {}, {}, nestedKeys);
+                }
+                throw error;
             }
         },
 

package/src/node/fs/runtime-state-path.ts

@@ -0,0 +1,35 @@
+import { dirname, join } from "node:path";
+
+const RUNTIME_STATE_SHARD_DIR = "runtime-state";
+
+export interface ResolvedRuntimeStatePaths {
+    /** Directory holding one JSON file per top-level slice. */
+    stateDir: string;
+    /** Legacy monolithic `state.json` — migrated on read/reset when present. */
+    legacyFilePath: string | null;
+}
+
+/**
+ * Resolve sharded runtime state layout from {@link CreateServiceRuntimeStateStoreOptions.filePath}.
+ *
+ * | `filePath`              | Shard dir                         | Legacy        |
+ * |-------------------------|-----------------------------------|---------------|
+ * | `.../state.json`        | `.../runtime-state/`              | `state.json`  |
+ * | `.../runtime-state/`    | same directory                    | none          |
+ */
+export function resolveRuntimeStatePaths(filePath: string): ResolvedRuntimeStatePaths {
+    if (filePath.endsWith(".json")) {
+        return {
+            stateDir: join(dirname(filePath), RUNTIME_STATE_SHARD_DIR),
+            legacyFilePath: filePath,
+        };
+    }
+    return {
+        stateDir: filePath,
+        legacyFilePath: null,
+    };
+}
+
+export function runtimeStateShardPath(stateDir: string, sliceKey: string): string {
+    return join(stateDir, `${sliceKey}.json`);
+}

package/src/node/fs/sharded-json-state-store.ts

@@ -0,0 +1,157 @@
+import { mkdir, readFile, stat, unlink } from "node:fs/promises";
+import { createJsonFileStateStore, type JsonStatePatch } from "./json-state-store";
+import { resolveRuntimeStatePaths, runtimeStateShardPath } from "./runtime-state-path";
+
+export interface CreateShardedJsonFileStateStoreOptions<T extends object, NK extends keyof T> {
+    /** Monolithic legacy path or shard directory root (see {@link resolveRuntimeStatePaths}). */
+    filePath: string;
+    defaultState: T;
+    /** Top-level keys persisted as separate shard files. */
+    nestedKeys: NK[];
+    updatedAtKey?: keyof T;
+}
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+    return value != null && typeof value === "object" && !Array.isArray(value);
+}
+
+function mergeSlice<T extends object>(defaults: T, key: keyof T, patchValue: unknown): T[keyof T] {
+    const base = defaults[key];
+    if (isPlainObject(base) && isPlainObject(patchValue)) {
+        return { ...base, ...patchValue } as T[keyof T];
+    }
+    return patchValue as T[keyof T];
+}
+
+/**
+ * JSON runtime state with **one file per top-level slice** (log-persist registry pattern).
+ * Eliminates cross-slice lost updates when guard/scheduler/worker write concurrently.
+ */
+export function createShardedJsonFileStateStore<T extends object, NK extends keyof T>(
+    options: CreateShardedJsonFileStateStoreOptions<T, NK>,
+): {
+    read(): Promise<T>;
+    write(patch: JsonStatePatch<T, NK>): Promise<T>;
+    reset(): Promise<T>;
+} {
+    const { defaultState, nestedKeys, updatedAtKey } = options;
+    const { stateDir, legacyFilePath } = resolveRuntimeStatePaths(options.filePath);
+
+    type ShardStore = ReturnType<typeof createJsonFileStateStore<object>>;
+    const shardStores = new Map<string, ShardStore>();
+
+    function shardStore(sliceKey: NK): ShardStore {
+        const key = String(sliceKey);
+        let store = shardStores.get(key);
+        if (store == null) {
+            store = createJsonFileStateStore({
+                filePath: runtimeStateShardPath(stateDir, key),
+                defaultState: defaultState[sliceKey] as object,
+            });
+            shardStores.set(key, store);
+        }
+        return store;
+    }
+
+    async function readUpdatedAtFromShardMtimes(): Promise<string> {
+        let maxMtimeMs = 0;
+        for (const sliceKey of nestedKeys) {
+            try {
+                const shardStat = await stat(runtimeStateShardPath(stateDir, String(sliceKey)));
+                maxMtimeMs = Math.max(maxMtimeMs, shardStat.mtimeMs);
+            } catch (error) {
+                if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
+                    throw error;
+                }
+            }
+        }
+        if (maxMtimeMs <= 0) {
+            return defaultState[updatedAtKey as keyof T] as string;
+        }
+        return new Date(maxMtimeMs).toISOString();
+    }
+
+    async function migrateLegacyMonolithicIfPresent(): Promise<void> {
+        if (legacyFilePath == null) {
+            return;
+        }
+
+        let raw: string;
+        try {
+            raw = await readFile(legacyFilePath, "utf8");
+        } catch (error) {
+            if ((error as NodeJS.ErrnoException).code === "ENOENT") {
+                return;
+            }
+            throw error;
+        }
+
+        let parsed: Partial<T>;
+        try {
+            parsed = JSON.parse(raw) as Partial<T>;
+        } catch {
+            await unlink(legacyFilePath).catch(() => undefined);
+            return;
+        }
+
+        await mkdir(stateDir, { recursive: true });
+        for (const sliceKey of nestedKeys) {
+            const slice = parsed[sliceKey];
+            if (slice != null) {
+                await shardStore(sliceKey).write(slice as object);
+            }
+        }
+
+        await unlink(legacyFilePath).catch(() => undefined);
+    }
+
+    return {
+        async read(): Promise<T> {
+            await mkdir(stateDir, { recursive: true });
+            await migrateLegacyMonolithicIfPresent();
+
+            const merged = { ...defaultState } as T;
+            for (const sliceKey of nestedKeys) {
+                merged[sliceKey] = (await shardStore(sliceKey).read()) as T[NK];
+            }
+            if (updatedAtKey != null) {
+                merged[updatedAtKey] = (await readUpdatedAtFromShardMtimes()) as T[keyof T];
+            }
+            return merged;
+        },
+
+        async write(patch: JsonStatePatch<T, NK>): Promise<T> {
+            await mkdir(stateDir, { recursive: true });
+            await migrateLegacyMonolithicIfPresent();
+
+            for (const sliceKey of nestedKeys) {
+                const patchSlice = patch[sliceKey];
+                if (patchSlice == null) {
+                    continue;
+                }
+                const current = await shardStore(sliceKey).read();
+                const nextSlice = mergeSlice(defaultState, sliceKey, {
+                    ...(current as object),
+                    ...(patchSlice as object),
+                });
+                await shardStore(sliceKey).write(nextSlice as object);
+            }
+
+            return this.read();
+        },
+
+        async reset(): Promise<T> {
+            await mkdir(stateDir, { recursive: true });
+
+            for (const sliceKey of nestedKeys) {
+                await shardStore(sliceKey).reset();
+            }
+
+            if (legacyFilePath != null) {
+                await unlink(legacyFilePath).catch(() => undefined);
+            }
+
+            return this.read();
+        },
+    };
+}

package/src/node/runtime-state/create-service-runtime-state-store.ts

@@ -1,5 +1,6 @@
 import { EMPTY_REGISTRY_SLOT_RUNTIME_STATE } from "../../service/registry-lifecycle";
-import { createJsonFileStateStore, type JsonFileStateStore, type JsonStatePatch } from "../fs/json-state-store";
+import type { JsonStatePatch } from "../fs/json-state-store";
+import { createShardedJsonFileStateStore } from "../fs/sharded-json-state-store";
 import type {
     DefaultExtraRuntimeSlices,
     GuardRuntimeSlice,
@@ -16,6 +17,10 @@ const EPOCH_ISO = new Date(0).toISOString();
 export interface CreateServiceRuntimeStateStoreOptions<
     TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices,
 > {
+    /**
+     * Monolithic legacy path (`…/state.json`) or shard directory (`…/runtime-state/`).
+     * Legacy files migrate automatically to `dirname/state.json → runtime-state/*.json`.
+     */
     filePath: string;
     /** Default values for service-specific top-level nested slices. */
     extraDefaults?: TExtraSlices;
@@ -78,7 +83,7 @@ function createDefaultServiceRuntimeState<TExtraSlices extends Record<string, ob
     };
 }
 
-/** JSON file-backed service runtime state (L3 blueprint) with typed core slices and extensions. */
+/** Sharded JSON runtime state (L3 blueprint) — one file per slice under `runtime-state/`. */
 export function createServiceRuntimeStateStore<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices>(
     options: CreateServiceRuntimeStateStoreOptions<TExtraSlices>,
 ): ServiceRuntimeStateStore<TExtraSlices> {
@@ -95,24 +100,19 @@ export function createServiceRuntimeStateStore<TExtraSlices extends Record<strin
         ...(Object.keys(options.extraDefaults ?? {}) as (keyof TExtraSlices & string)[]),
     ] as NK[];
 
-    let store: JsonFileStateStore<State, NK> | undefined;
-
-    function instance(): JsonFileStateStore<State, NK> {
-        store ??= createJsonFileStateStore<State, NK>({
-            filePath: options.filePath,
-            defaultState,
-            nestedKeys,
-            updatedAtKey: "updatedAt",
-        });
-        return store;
-    }
+    const store = createShardedJsonFileStateStore<State, NK>({
+        filePath: options.filePath,
+        defaultState,
+        nestedKeys,
+        updatedAtKey: "updatedAt",
+    });
 
     return {
-        readRuntimeState: () => instance().read(),
-        writeRuntimeState: (patch) => instance().write(patch),
-        resetRuntimeStateForStartup: () => instance().reset(),
+        readRuntimeState: () => store.read(),
+        writeRuntimeState: (patch) => store.write(patch),
+        resetRuntimeStateForStartup: () => store.reset(),
         finishRunnerTick: async ({ nowMs, lastFired, postedCount, extra }) => {
-            await instance().write({
+            await store.write({
                 scheduler: {
                     lastTickAt: new Date(nowMs).toISOString(),
                     lastFired,

package/src/service/config.api.ts

@@ -59,6 +59,7 @@ export const DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS: readonly SystemRegistrySeedSlot
     { serviceValue: "watch-service" },
     { serviceValue: "download-service" },
     { serviceValue: "storage-service" },
+    { serviceValue: "gc-service" },
 ] as const;
 
 const configCategoryFilter: QueryFilter = {

package/src/service/index.ts

@@ -30,12 +30,18 @@ export {
 export type { Config, ConfigDetails } from "./config.interface";
 export { CategoryConfig, TARGET_SYSTEM_REGISTRY_KEY } from "./config.interface";
 export type {
+    AppendSystemRegistrySlotsInput,
+    AppendSystemRegistrySlotsOutcome,
     PatchServiceRuntimeInput,
     RegisterServiceInput,
+    ReleasedRegistrySlot,
+    ReleaseSystemRegistrySlotsInput,
+    ReleaseSystemRegistrySlotsOutcome,
     TargetSystemRegistrySlotView,
     TargetSystemRegistryView,
 } from "./registry.service";
 export {
+    appendSystemRegistrySlots,
     assertRegistrySlotAvailable,
     assertRegistrySlotOwner,
     getTargetSystemRegistry,
@@ -44,6 +50,7 @@ export {
     patchServiceRuntime,
     registerService,
     registerServiceAtStartup,
+    releaseSystemRegistrySlots,
     resolveActiveRegistryServiceId,
     ServiceRegistryError,
     unregisterService,