target-supabase-sdk 0.2.3 → 0.2.4

package/dist/preload.js

@@ -1,11 +1,11 @@
 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-C7GJo_Nc.js';
+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 'node:fs';
 import 'node:url';
 import 'node:fs/promises';
-import './chunks/create-logger-DyH3mZ8p.js';
-import '@supabase/supabase-js';
+import './chunks/list.api-Ab9v8yOg.js';
 import 'lodash-es';
+import '@supabase/supabase-js';
 import 'node:crypto';
 
 function applyServiceEnvDefaults(projectRoot, options) {

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

@@ -0,0 +1,143 @@
+import { z } from "zod";
+import { type Config, type ConfigDetails } from "./config.interface";
+import { type ServiceSlot } from "./service.interface";
+export declare const getConfigSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    value?: string | undefined;
+}, {
+    id?: string | undefined;
+    value?: string | undefined;
+}>, {
+    id?: string | undefined;
+    value?: string | undefined;
+}, {
+    id?: string | undefined;
+    value?: string | undefined;
+}>;
+export type GetConfigPayload = z.infer<typeof getConfigSchema>;
+/** One declarative EMPTY slot entry for seeding the system registry. */
+export declare const systemRegistrySeedSlotSchema: z.ZodObject<{
+    serviceValue: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    serviceValue: string;
+}, {
+    serviceValue: string;
+}>;
+export type SystemRegistrySeedSlot = z.infer<typeof systemRegistrySeedSlotSchema>;
+export declare const postSystemRegistryConfigSchema: z.ZodObject<{
+    /** When omitted, {@link DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS} is used. */
+    slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        serviceValue: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        serviceValue: string;
+    }, {
+        serviceValue: string;
+    }>, "many">>;
+    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    tagList: string[];
+    slots?: {
+        serviceValue: string;
+    }[] | undefined;
+}, {
+    tagList?: string[] | undefined;
+    slots?: {
+        serviceValue: string;
+    }[] | undefined;
+}>;
+export type PostSystemRegistryConfigPayload = z.infer<typeof postSystemRegistryConfigSchema>;
+/** Same payload shape as {@link postSystemRegistryConfig} — replaces slots with fresh EMPTY rows. */
+export declare const resetSystemRegistryConfigSchema: z.ZodObject<{
+    /** When omitted, {@link DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS} is used. */
+    slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        serviceValue: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        serviceValue: string;
+    }, {
+        serviceValue: string;
+    }>, "many">>;
+    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    tagList: string[];
+    slots?: {
+        serviceValue: string;
+    }[] | undefined;
+}, {
+    tagList?: string[] | undefined;
+    slots?: {
+        serviceValue: string;
+    }[] | undefined;
+}>;
+export type ResetSystemRegistryConfigPayload = PostSystemRegistryConfigPayload;
+/** Default one EMPTY slot per known L3 service (override via payload or seed file). */
+export declare const DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS: readonly SystemRegistrySeedSlot[];
+/** Build EMPTY {@link ServiceSlot} rows from seed entries (one slot per array item). */
+export declare function buildEmptyServiceSlots(seedSlots: readonly SystemRegistrySeedSlot[]): ServiceSlot[];
+/** Build `ConfigDetails` for the globally unique system registry row. */
+export declare function buildSystemRegistryConfigDetails(slots: readonly ServiceSlot[]): ConfigDetails;
+/** Fetch a Config by id or by {@link Config.value} key (`category=config`). */
+export declare const getConfig: (payload: {
+    id?: string | undefined;
+    value?: string | undefined;
+}) => {
+    data: Config;
+    status_code: import("..").StatusCode;
+    success: boolean;
+    message?: string;
+    error?: {
+        message: string;
+        code?: string;
+    };
+} | {
+    data: undefined;
+    status_code: import("..").StatusCode;
+    success: boolean;
+    message?: string;
+    error?: {
+        message: string;
+        code?: string;
+    };
+} | Promise<{
+    data: Config;
+    status_code: import("..").StatusCode;
+    success: boolean;
+    message?: string;
+    error?: {
+        message: string;
+        code?: string;
+    };
+} | {
+    data: undefined;
+    status_code: import("..").StatusCode;
+    success: boolean;
+    message?: string;
+    error?: {
+        message: string;
+        code?: string;
+    };
+}>;
+/**
+ * Insert the globally unique system registry Config (`category=config`,
+ * `value=target-system-registry`). Rejects duplicates via `checkRedundancyFilterList`.
+ */
+export declare const postSystemRegistryConfig: (payload: {
+    tagList: string[];
+    slots?: {
+        serviceValue: string;
+    }[] | undefined;
+}) => import("..").SupabaseResponse<Config> | Promise<import("..").SupabaseResponse<Config>>;
+/**
+ * Replace the system registry slot layout with fresh EMPTY rows.
+ * Creates the row when missing (same as {@link postSystemRegistryConfig}).
+ * Clears ACTIVE slot bindings — use for dev recovery after crashes or layout changes.
+ */
+export declare const resetSystemRegistryConfig: (payload: {
+    tagList: string[];
+    slots?: {
+        serviceValue: string;
+    }[] | undefined;
+}) => import("..").SupabaseResponse<Config> | Promise<import("..").SupabaseResponse<Config>>;
+//# sourceMappingURL=config.api.d.ts.map

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

@@ -0,0 +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"}

package/dist/service/config.interface.d.ts

@@ -0,0 +1,22 @@
+import type { Target } from "../core.interface";
+export interface Config extends Target {
+    /** Human readable name */
+    name: string;
+    /** Unique key, like TARGET_SYSTEM_REGISTRY_KEY */
+    value: string;
+    category: CategoryConfig;
+    details: ConfigDetails;
+}
+export declare enum CategoryConfig {
+    CONFIG = "config"
+}
+/** Globally unique Config key for the declarative system service registry. */
+export declare const TARGET_SYSTEM_REGISTRY_KEY = "target-system-registry";
+export interface ConfigDetails {
+    manifestVersion: number;
+    /** How to resolve the Config */
+    loaderKey: string;
+    meta: unknown;
+    objects: Array<unknown>;
+}
+//# sourceMappingURL=config.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.interface.d.ts","sourceRoot":"","sources":["../../src/service/config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,MAAO,SAAQ,MAAM;IAClC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;CAC1B;AAED,oBAAY,cAAc;IACtB,MAAM,WAAW;CACpB;AAED,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CAC3B"}

package/dist/service/index.d.ts

@@ -1,21 +1,20 @@
-import { type SupabaseResponse } from "../core.interface";
-import { type Service } from "./service.interface";
+/**
+ * Service domain public API — curated re-exports only.
+ */
 export type { EnumMembers, FieldDefinition, SchemaDefinition, ServiceLifecycle, } from "./base.interface";
 export { ServiceLifecycleStatus } from "./base.interface";
+export type { GetConfigPayload, PostSystemRegistryConfigPayload, ResetSystemRegistryConfigPayload, SystemRegistrySeedSlot, } from "./config.api";
+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 { 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";
-export { apiDetailsSchema, fieldDefinitionSchema, getApi, getApiSchema, getService, getServiceSchema, postApi, postApiSchema, postService, postServiceSchema, schemaDefinitionSchema, serviceDetailsSchema, serviceLifecycleSchema, } from "./service.api";
-export type { Api, ApiDetails, Service, ServiceDetails } from "./service.interface";
-export { ApiMethod, CategoryApi, CategoryService } from "./service.interface";
-export interface DiscoverServiceInput {
-    /** {@link Service.value} */
-    value: string;
-    traceId?: string;
-}
-/**
- * Discover a single service by {@link Service.value}.
- * Only returns services with `lifecycle.status === ACTIVE` (filtered at query time).
- *
- * Lookup: primary `getService` → fallback `scanTargetList` by value.
- */
-export declare function discoverService(input: DiscoverServiceInput): Promise<SupabaseResponse<Service>>;
+export { apiDetailsSchema, fieldDefinitionSchema, getApi, getApiSchema, getService, getServiceSchema, postApi, postApiSchema, postService, postServiceSchema, schemaDefinitionSchema, serviceDetailsSchema, serviceLifecycleSchema, serviceNodeSnapshotSchema, serviceRuntimeSchema, } from "./service.api";
+export type { Api, ApiDetails, Service, ServiceDetails, ServiceNodeSnapshot, ServiceRuntime, ServiceSlot, } from "./service.interface";
+export { ApiMethod, CategoryApi, CategoryService, ServiceSlotStatus } from "./service.interface";
+export type { PostServiceInstanceOptions, ServiceBootstrapResult } from "./service-bootstrap";
+export { createActiveServiceLifecycle, defaultL3ServiceDetails, postServiceInstance, } from "./service-bootstrap";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI5E,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEpE,YAAY,EACR,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,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,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACjC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAoCD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CA6FrG"}
+{"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"}

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

@@ -0,0 +1,43 @@
+import type { Service } from "./service.interface";
+/** Shared registry slice for L3 runtime state files (`state.json`). */
+export interface RegistrySlotRuntimeState {
+    serviceId: string | null;
+    serviceValue: string | null;
+    slotOwned: boolean | null;
+    lastSlotCheckAt: string | null;
+    lastSlotCheckError: string | null;
+}
+export declare const EMPTY_REGISTRY_SLOT_RUNTIME_STATE: RegistrySlotRuntimeState;
+export declare function createClaimedRegistrySlotRuntimeState(service: Service): RegistrySlotRuntimeState;
+export interface ClaimRegistrySlotInput {
+    serviceValue: string;
+    createInstance: () => Promise<Service>;
+    traceId?: string;
+}
+export interface ServiceRegistrySession {
+    service: Service;
+    /** Graceful shutdown — releases ACTIVE registry slot. */
+    release: () => Promise<void>;
+    /** Abandon orphan instance row when register never succeeded. */
+    abandon: () => Promise<void>;
+}
+/**
+ * Preflight → create Service instance → claim registry slot.
+ * On register failure after `createInstance`, deletes the orphan Service row.
+ */
+export declare function claimServiceRegistrySlot(input: ClaimRegistrySlotInput): Promise<ServiceRegistrySession>;
+export interface RegistrySlotGuardResult {
+    slotOwned: boolean | null;
+    shouldShutdown: boolean;
+    error?: string;
+}
+/**
+ * Runtime guard step for service supervisor loops.
+ * Transient read failures soft-fail; confirmed slot loss returns `shouldShutdown: true`.
+ */
+export declare function runRegistrySlotGuardCheck(input: {
+    serviceValue: string;
+    serviceId: string;
+}): Promise<RegistrySlotGuardResult>;
+export declare function registrySlotRuntimePatchFromGuardResult(result: RegistrySlotGuardResult, checkedAt: string): Pick<RegistrySlotRuntimeState, "slotOwned" | "lastSlotCheckAt" | "lastSlotCheckError">;
+//# sourceMappingURL=registry-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry-lifecycle.d.ts","sourceRoot":"","sources":["../../src/service/registry-lifecycle.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,eAAO,MAAM,iCAAiC,EAAE,wBAM/C,CAAC;AAEF,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,OAAO,GAAG,wBAAwB,CAQhG;AAED,MAAM,WAAW,sBAAsB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,iEAAiE;IACjE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAwC7G;AAED,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAmBnC;AAED,wBAAgB,uCAAuC,CACnD,MAAM,EAAE,uBAAuB,EAC/B,SAAS,EAAE,MAAM,GAClB,IAAI,CAAC,wBAAwB,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAC,CAMxF"}

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

@@ -0,0 +1,94 @@
+/**
+ * System registry — declarative service capacity (`target-system-registry` Config)
+ * and startup/shutdown slot claims (`registerService` / `unregisterService`).
+ *
+ * Data planes:
+ *   - Config `details.objects` — {@link ServiceSlot} desired layout (EMPTY / ACTIVE)
+ *   - Service rows — runtime instances; guard maintains {@link ServiceDetails.runtime}
+ *   - Slot release: graceful shutdown via {@link unregisterService}; monitor (later)
+ *     for crashed / ungraceful exits (stale `Service.details.runtime`)
+ */
+import type { Node } from "../node/node.interface";
+import { type Config } from "./config.interface";
+import { type Service, type ServiceSlot } from "./service.interface";
+export { TARGET_SYSTEM_REGISTRY_KEY } from "./config.interface";
+export interface TargetSystemRegistrySlotView {
+    slot: ServiceSlot;
+    /** Resolved when `slot.serviceId` is set; null for EMPTY slots. */
+    service: Service | null;
+}
+export interface TargetSystemRegistryView {
+    config: Config;
+    slots: TargetSystemRegistrySlotView[];
+}
+export interface RegisterServiceInput {
+    /** Registered runtime Service row (`category=service`). */
+    service: Service;
+    traceId?: string;
+    maxAttempts?: number;
+}
+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");
+}
+/** Defensive decode of one {@link ServiceSlot} from Config `details.objects`. */
+export declare function parseServiceSlot(value: unknown): ServiceSlot | null;
+export declare function parseServiceSlots(config: Config): ServiceSlot[];
+/**
+ * Load the global system registry Config and resolve each ACTIVE slot's Service row.
+ * Read-only — does not mutate slots or heartbeats.
+ */
+export declare function getTargetSystemRegistry(): Promise<TargetSystemRegistryView>;
+/**
+ * Preflight before `postService` — fail fast when registry capacity is full.
+ * Prevents orphan Service rows and child process spawn when no slot is available.
+ */
+export declare function assertRegistrySlotAvailable(serviceValue: string): Promise<void>;
+/**
+ * Runtime guard: this process's Service instance must still own an ACTIVE registry slot.
+ * Supports N>1 replicas — checks whether `serviceId` appears in any ACTIVE slot for
+ * `serviceValue`, not merely the first ACTIVE slot.
+ */
+export declare function assertRegistrySlotOwner(input: {
+    serviceValue: string;
+    serviceId: string;
+}): Promise<void>;
+/**
+ * Claim one EMPTY slot for a running Service instance (`EMPTY → ACTIVE` only).
+ *
+ * - Each startup should `postService` a **new** instance row; do not reuse prior Service ids.
+ * - Declared capacity = count of {@link ServiceSlot} rows sharing `service.value`
+ * - No idempotent skip — if all slots are ACTIVE (e.g. crashed prior instance), throws
+ *   `SERVICE_SLOTS_FULL` until monitor/ops releases the slot
+ * - Does not write heartbeats; guard maintains {@link ServiceDetails.runtime}
+ * - Graceful release: {@link unregisterService}; crash recovery: future monitor
+ */
+export declare function registerService(input: RegisterServiceInput): Promise<void>;
+/** Resolve the ACTIVE registry slot id for a declared `serviceValue`. */
+export declare function resolveActiveRegistryServiceId(serviceValue: string): Promise<string | null>;
+export interface PatchServiceRuntimeInput {
+    serviceValue: string;
+    /** Prefer explicit id (N>1 replicas); falls back to first ACTIVE slot when omitted. */
+    serviceId?: string;
+    nodes: readonly Node[];
+    lastHeartBeat: number;
+}
+/** Roll up Node liveness into `Service.details.runtime` (service guard only). */
+export declare function patchServiceRuntime(input: PatchServiceRuntimeInput): Promise<void>;
+/**
+ * Claim a registry slot at L3 startup — propagates {@link ServiceRegistryError} (e.g. `SERVICE_SLOTS_FULL`).
+ */
+export declare function registerServiceAtStartup(input: RegisterServiceInput): Promise<void>;
+/**
+ * Release the ACTIVE slot owned by this Service instance (`ACTIVE → EMPTY` only).
+ *
+ * - Idempotent when no ACTIVE slot is bound to `service.id`
+ * - Does not mutate the Service row or `details.runtime`
+ * - Does not release slots owned by other instances
+ */
+export declare function unregisterService(input: RegisterServiceInput): Promise<void>;
+/**
+ * Best-effort slot release for process shutdown — never throws.
+ */
+export declare function unregisterServiceAtShutdown(input: RegisterServiceInput): Promise<void>;
+//# sourceMappingURL=registry.service.d.ts.map

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

@@ -0,0 +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"}

package/dist/service/service-bootstrap.d.ts

@@ -0,0 +1,28 @@
+import { type LoggerWithScope } from "../shared/log";
+import type { ServiceLifecycle } from "./base.interface";
+import type { Service, ServiceDetails } from "./service.interface";
+/** Default ACTIVE lifecycle for a newly posted Service instance row. */
+export declare function createActiveServiceLifecycle(activeSince?: string): ServiceLifecycle;
+/** Standard L3 Service `details` — empty apiKeys, manifest v0, ACTIVE lifecycle. */
+export declare function defaultL3ServiceDetails(options?: {
+    dependencies?: string[];
+}): ServiceDetails;
+export interface PostServiceInstanceOptions {
+    name: string;
+    value: string;
+    tagList?: string[];
+    dependencies?: string[];
+    logger?: LoggerWithScope;
+    /** Log topic for instance-created message. Default `bootstrap`. */
+    logTopic?: string;
+}
+/**
+ * Post a new Service instance row (L3 blueprint).
+ * Same `value` may exist on many rows; registry slot claim selects the live instance.
+ */
+export declare function postServiceInstance(options: PostServiceInstanceOptions): Promise<Service>;
+export interface ServiceBootstrapResult {
+    service: Service;
+    baseUrl: string;
+}
+//# sourceMappingURL=service-bootstrap.d.ts.map

package/dist/service/service-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bootstrap.d.ts","sourceRoot":"","sources":["../../src/service/service-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AASnE,wEAAwE;AACxE,wBAAgB,4BAA4B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAOnF;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,cAAc,CAO7F;AAED,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB/F;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB"}

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

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { NodeStatus } from "../node/node.interface";
 import { type FieldDefinition, type SchemaDefinition, ServiceLifecycleStatus } from "./base.interface";
 import { type Api, ApiMethod, type Service } from "./service.interface";
 declare const schemaDefinitionSchema: z.ZodType<SchemaDefinition>;
@@ -90,6 +91,49 @@ export declare const apiDetailsSchema: z.ZodObject<{
         sunsetAt: string | null;
     };
 }>;
+export declare const serviceNodeSnapshotSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    status: z.ZodNativeEnum<typeof NodeStatus>;
+    lastHeartBeat: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: NodeStatus;
+    nodeId: string;
+    lastHeartBeat: number;
+}, {
+    status: NodeStatus;
+    nodeId: string;
+    lastHeartBeat: number;
+}>;
+export declare const serviceRuntimeSchema: z.ZodObject<{
+    lastHeartBeat: z.ZodNumber;
+    nodes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        status: z.ZodNativeEnum<typeof NodeStatus>;
+        lastHeartBeat: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        status: NodeStatus;
+        nodeId: string;
+        lastHeartBeat: number;
+    }, {
+        status: NodeStatus;
+        nodeId: string;
+        lastHeartBeat: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    lastHeartBeat: number;
+    nodes: {
+        status: NodeStatus;
+        nodeId: string;
+        lastHeartBeat: number;
+    }[];
+}, {
+    lastHeartBeat: number;
+    nodes?: {
+        status: NodeStatus;
+        nodeId: string;
+        lastHeartBeat: number;
+    }[] | undefined;
+}>;
 export declare const serviceDetailsSchema: z.ZodObject<{
     manifestVersion: z.ZodNumber;
     apiKeys: z.ZodArray<z.ZodString, "many">;
@@ -110,6 +154,36 @@ export declare const serviceDetailsSchema: z.ZodObject<{
         deprecatedAt: string | null;
         sunsetAt: string | null;
     }>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        lastHeartBeat: z.ZodNumber;
+        nodes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            status: z.ZodNativeEnum<typeof NodeStatus>;
+            lastHeartBeat: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            status: NodeStatus;
+            nodeId: string;
+            lastHeartBeat: number;
+        }, {
+            status: NodeStatus;
+            nodeId: string;
+            lastHeartBeat: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        lastHeartBeat: number;
+        nodes: {
+            status: NodeStatus;
+            nodeId: string;
+            lastHeartBeat: number;
+        }[];
+    }, {
+        lastHeartBeat: number;
+        nodes?: {
+            status: NodeStatus;
+            nodeId: string;
+            lastHeartBeat: number;
+        }[] | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     manifestVersion: number;
     lifecycle: {
@@ -120,6 +194,14 @@ export declare const serviceDetailsSchema: z.ZodObject<{
     };
     apiKeys: string[];
     dependencies: string[];
+    runtime?: {
+        lastHeartBeat: number;
+        nodes: {
+            status: NodeStatus;
+            nodeId: string;
+            lastHeartBeat: number;
+        }[];
+    } | undefined;
 }, {
     manifestVersion: number;
     lifecycle: {
@@ -130,6 +212,14 @@ export declare const serviceDetailsSchema: z.ZodObject<{
     };
     apiKeys: string[];
     dependencies?: string[] | undefined;
+    runtime?: {
+        lastHeartBeat: number;
+        nodes?: {
+            status: NodeStatus;
+            nodeId: string;
+            lastHeartBeat: number;
+        }[] | undefined;
+    } | undefined;
 }>;
 export declare const postApiSchema: z.ZodObject<{
     name: z.ZodString;
@@ -317,6 +407,36 @@ export declare const postServiceSchema: z.ZodObject<{
             deprecatedAt: string | null;
             sunsetAt: string | null;
         }>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            lastHeartBeat: z.ZodNumber;
+            nodes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                nodeId: z.ZodString;
+                status: z.ZodNativeEnum<typeof NodeStatus>;
+                lastHeartBeat: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }, {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            lastHeartBeat: number;
+            nodes: {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }[];
+        }, {
+            lastHeartBeat: number;
+            nodes?: {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }[] | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         manifestVersion: number;
         lifecycle: {
@@ -327,6 +447,14 @@ export declare const postServiceSchema: z.ZodObject<{
         };
         apiKeys: string[];
         dependencies: string[];
+        runtime?: {
+            lastHeartBeat: number;
+            nodes: {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }[];
+        } | undefined;
     }, {
         manifestVersion: number;
         lifecycle: {
@@ -337,6 +465,14 @@ export declare const postServiceSchema: z.ZodObject<{
         };
         apiKeys: string[];
         dependencies?: string[] | undefined;
+        runtime?: {
+            lastHeartBeat: number;
+            nodes?: {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }[] | undefined;
+        } | undefined;
     }>;
     tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     extra: z.ZodOptional<z.ZodString>;
@@ -354,6 +490,14 @@ export declare const postServiceSchema: z.ZodObject<{
         };
         apiKeys: string[];
         dependencies: string[];
+        runtime?: {
+            lastHeartBeat: number;
+            nodes: {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }[];
+        } | undefined;
     };
     extra?: string | undefined;
 }, {
@@ -369,6 +513,14 @@ export declare const postServiceSchema: z.ZodObject<{
         };
         apiKeys: string[];
         dependencies?: string[] | undefined;
+        runtime?: {
+            lastHeartBeat: number;
+            nodes?: {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }[] | undefined;
+        } | undefined;
     };
     tagList?: string[] | undefined;
     extra?: string | undefined;
@@ -497,6 +649,14 @@ export declare const postService: (payload: {
         };
         apiKeys: string[];
         dependencies: string[];
+        runtime?: {
+            lastHeartBeat: number;
+            nodes: {
+                status: NodeStatus;
+                nodeId: string;
+                lastHeartBeat: number;
+            }[];
+        } | undefined;
     };
     extra?: string | undefined;
 }) => import("..").SupabaseResponse<Service> | Promise<import("..").SupabaseResponse<Service>>;