target-supabase-sdk 0.2.0 → 0.2.1

package/dist/link/link.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.interface.d.ts","sourceRoot":"","sources":["../../src/link/link.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,YAAY;IACpB,sBAAsB;IACtB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"link.interface.d.ts","sourceRoot":"","sources":["../../src/link/link.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACrB"}

package/dist/list/list.api.d.ts

@@ -1,5 +1,5 @@
 import { BaseValidator } from "../core.utils";
-import { List, ListDetails } from "./list.interface";
+import { type List, type ListDetails } from "./list.interface";
 export interface PostListCreatePayload {
     name: List["name"];
     value: List["value"];
@@ -12,4 +12,6 @@ export declare class PostListValidator extends BaseValidator<PostListCreatePaylo
     constructor();
 }
 export declare const postListCreate: (payload: PostListCreatePayload) => Promise<import("..").SupabaseResponse<List>>;
+/** Log batch create — idempotent on List.value (stable batch hash). */
+export declare const postLogListCreate: (payload: PostListCreatePayload) => Promise<import("..").SupabaseResponse<List>>;
 //# sourceMappingURL=list.api.d.ts.map

package/dist/list/list.api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.api.d.ts","sourceRoot":"","sources":["../../src/list/list.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IACzE,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAA4C;IACrG,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAAM;;CAShE;AAID,eAAO,MAAM,cAAc,YAAmB,qBAAqB,iDAgBlE,CAAC"}
+{"version":3,"file":"list.api.d.ts","sourceRoot":"","sources":["../../src/list/list.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAgB,KAAK,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACxB;AAED,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IACvE,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAA4C;IACrG,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,qBAAqB,CAAC,EAAE,CAAM;;CASlE;AAED,eAAO,MAAM,cAAc,YAAmB,qBAAqB,iDAgBlE,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,YAAmB,qBAAqB,iDAoBrE,CAAC"}

package/dist/list/list.interface.d.ts

@@ -1,4 +1,4 @@
-import { Target, TargetPayload } from "../core.interface";
+import type { Target } from "../core.interface";
 export declare enum CategoryList {
     LIST = "list"
 }
@@ -16,6 +16,6 @@ export interface ListDetails {
     preview: string;
     /** How to render the List */
     loaderKey: string;
-    items: Array<TargetPayload<Target>>;
+    items: Array<unknown>;
 }
 //# sourceMappingURL=list.interface.d.ts.map

package/dist/list/list.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.interface.d.ts","sourceRoot":"","sources":["../../src/list/list.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE1D,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;CACtC"}
+{"version":3,"file":"list.interface.d.ts","sourceRoot":"","sources":["../../src/list/list.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB"}

package/dist/node/env/env-parsers.d.ts

@@ -0,0 +1,19 @@
+export interface EnvIntOptions {
+    env?: NodeJS.ProcessEnv;
+    min?: number;
+    max?: number;
+}
+export declare function envInt(name: string, defaultValue: number, options?: EnvIntOptions): number;
+export declare function envMs(name: string, defaultMs: number, options?: EnvIntOptions): number;
+export declare function envPort(defaultPort?: number, options?: EnvIntOptions & {
+    envKey?: string;
+}): number;
+export interface EnvNumberOptions {
+    env?: NodeJS.ProcessEnv;
+    min?: number;
+    /** When true, use Math.floor on parsed value. */
+    floor?: boolean;
+}
+export declare function envNumber(name: string, defaultValue: number, options?: EnvNumberOptions): number;
+export declare function envBool(name: string, defaultValue?: boolean, env?: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=env-parsers.d.ts.map

package/dist/node/env/env-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parsers.d.ts","sourceRoot":"","sources":["../../../src/node/env/env-parsers.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAuB1F;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAEtF;AAED,wBAAgB,OAAO,CAAC,WAAW,SAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGjG;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAmBhG;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,UAAQ,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAMzG"}

package/dist/node/env/index.d.ts

@@ -0,0 +1,11 @@
+export type { EnvIntOptions, EnvNumberOptions } from "./env-parsers";
+export { envBool, envInt, envMs, envNumber, envPort } from "./env-parsers";
+export type { InitSupabaseFromStandardEnvOptions } from "./init-supabase-from-env";
+export { initSupabaseFromStandardEnv } from "./init-supabase-from-env";
+export type { LoadEnvFilesOptions } from "./load-env";
+export { loadEnvFiles, parseEnvFile, parseEnvFileContent, parseEnvLine } from "./load-env";
+export { resolveProjectRootByPackageName, resolveProjectRootFromModule } from "./project-root";
+export type { PublicBaseUrlFromEnvOptions } from "./public-base-url";
+export { publicBaseUrlFromEnv } from "./public-base-url";
+export { readEnv, requireEnv } from "./require-env";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/env/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/node/env/init-supabase-from-env.d.ts

@@ -0,0 +1,17 @@
+export interface InitSupabaseFromStandardEnvOptions {
+    /** Project root for `.env` files (required when `loadEnv` is true). */
+    root?: string;
+    /** Load `.env.local` / `.env` before initialize (default true). */
+    loadEnv?: boolean;
+    /** Hook after env files loaded (legacy aliases, etc.). */
+    afterLoadEnv?: () => void;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Load standard Supabase env vars and initialize the process-wide Supabase holder.
+ *
+ * Required: `SUPABASE_URL`, `SUPABASE_ANON_KEY`
+ * Optional: `SUPABASE_NEED_AUTH_URL`, `SUPABASE_NEED_AUTH_ANON_KEY`
+ */
+export declare function initSupabaseFromStandardEnv(options?: InitSupabaseFromStandardEnvOptions): Promise<void>;
+//# sourceMappingURL=init-supabase-from-env.d.ts.map

package/dist/node/env/init-supabase-from-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-supabase-from-env.d.ts","sourceRoot":"","sources":["../../../src/node/env/init-supabase-from-env.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kCAAkC;IAC/C,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,kCAAuC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjH"}

package/dist/node/env/load-env.d.ts

@@ -0,0 +1,20 @@
+export interface LoadEnvFilesOptions {
+    /** Files to load in order (later files do not override existing env). */
+    files?: readonly string[];
+    env?: NodeJS.ProcessEnv;
+    /** Called after all files are merged (e.g. legacy alias normalization). */
+    afterLoad?: () => void;
+}
+/** Parse one KEY=VALUE line; returns null if line should be skipped. */
+export declare function parseEnvLine(line: string): {
+    key: string;
+    value: string;
+} | null;
+export declare function parseEnvFileContent(content: string, env: NodeJS.ProcessEnv): void;
+export declare function parseEnvFile(filePath: string, env: NodeJS.ProcessEnv): void;
+/**
+ * Load `.env.local` then `.env` into `process.env` (or `options.env`).
+ * Existing non-empty env values are not overwritten.
+ */
+export declare function loadEnvFiles(root: string, options?: LoadEnvFilesOptions): void;
+//# sourceMappingURL=load-env.d.ts.map

package/dist/node/env/load-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../../src/node/env/load-env.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAChC,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAMD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAchF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAUjF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAK3E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAS9E"}

package/dist/node/env/project-root.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve project root from a module URL (typically `import.meta.url`).
+ * @param relativePath Path relative to the module file (default `".."` = parent directory).
+ */
+export declare function resolveProjectRootFromModule(importMetaUrl: string, relativePath?: string): string;
+/**
+ * Walk upward from `importMetaUrl` until a `package.json` with matching `name` is found.
+ * Use for esbuild bundles under `dist/` where a single `..` hop lands in `dist/`, not repo root.
+ */
+export declare function resolveProjectRootByPackageName(importMetaUrl: string, packageName: string): string;
+//# sourceMappingURL=project-root.d.ts.map

package/dist/node/env/project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../../../src/node/env/project-root.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,SAAO,GAAG,MAAM,CAE/F;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAiBlG"}

package/dist/node/env/public-base-url.d.ts

@@ -0,0 +1,10 @@
+export interface PublicBaseUrlFromEnvOptions {
+    /** Env var for public URL override (e.g. `STORAGE_PUBLIC_URL`). */
+    envKey: string;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Public base URL: `envKey` if set (trailing slash stripped), else `http://localhost:{port}`.
+ */
+export declare function publicBaseUrlFromEnv(port: number, options: PublicBaseUrlFromEnvOptions): string;
+//# sourceMappingURL=public-base-url.d.ts.map

package/dist/node/env/public-base-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-base-url.d.ts","sourceRoot":"","sources":["../../../src/node/env/public-base-url.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,2BAA2B;IACxC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAM/F"}

package/dist/node/env/require-env.d.ts

@@ -0,0 +1,3 @@
+export declare function readEnv(name: string, env?: NodeJS.ProcessEnv): string | undefined;
+export declare function requireEnv(name: string, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=require-env.d.ts.map

package/dist/node/env/require-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-env.d.ts","sourceRoot":"","sources":["../../../src/node/env/require-env.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAM9F;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAMrF"}

package/dist/node/fs/json-state-store.d.ts

@@ -0,0 +1,19 @@
+export type JsonStatePatch<T extends object, NK extends keyof T> = Partial<Omit<T, NK>> & {
+    [K in NK]?: T[K] extends object ? Partial<T[K]> : T[K];
+};
+export interface JsonFileStateStore<T extends object, NK extends keyof T = never> {
+    read(): Promise<T>;
+    write(patch: JsonStatePatch<T, NK>): Promise<T>;
+    reset(): Promise<T>;
+}
+export interface CreateJsonFileStateStoreOptions<T extends object, NK extends keyof T = never> {
+    filePath: string;
+    defaultState: T;
+    /** Top-level keys shallow-merged one level deep on read and write. */
+    nestedKeys?: NK[];
+    /** When set, assigned `new Date().toISOString()` on write and reset. */
+    updatedAtKey?: keyof T;
+}
+/** JSON file-backed state with optional nested key merge and atomic writes. */
+export declare function createJsonFileStateStore<T extends object, NK extends keyof T = never>(options: CreateJsonFileStateStoreOptions<T, NK>): JsonFileStateStore<T, NK>;
+//# sourceMappingURL=json-state-store.d.ts.map

package/dist/node/fs/json-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-state-store.d.ts","sourceRoot":"","sources":["../../../src/node/fs/json-state-store.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG;KACrF,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,CAAC,GAAG,KAAK;IAC5E,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,+BAA+B,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,CAAC,GAAG,KAAK;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,CAAC,CAAC;IAChB,sEAAsE;IACtE,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC;IAClB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;CAC1B;AAoCD,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,CAAC,GAAG,KAAK,EACjF,OAAO,EAAE,+BAA+B,CAAC,CAAC,EAAE,EAAE,CAAC,GAChD,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,CAqC3B"}

package/dist/node/fs/read-source-file.d.ts

@@ -0,0 +1,19 @@
+export interface SourceFilePayload {
+    absolutePath: string;
+    buffer: ArrayBuffer;
+    size: number;
+    sha256: string;
+}
+export interface ReadAndVerifySourceFileOptions {
+    /** When set, digest must match or an error is thrown. */
+    expectedSha256?: string;
+    /** Reject files larger than this many bytes. */
+    maxBytes?: number;
+    /** When false, allow zero-byte files (default rejects empty). */
+    allowEmpty?: boolean;
+}
+/** Copy a Node.js Buffer view to a standalone ArrayBuffer. */
+export declare function nodeBufferToArrayBuffer(nodeBuffer: Buffer): ArrayBuffer;
+/** Read a local file with basic validation and SHA-256 digest. */
+export declare function readAndVerifySourceFile(filePath: string, options?: ReadAndVerifySourceFileOptions): Promise<SourceFilePayload>;
+//# sourceMappingURL=read-source-file.d.ts.map

package/dist/node/fs/read-source-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-source-file.d.ts","sourceRoot":"","sources":["../../../src/node/fs/read-source-file.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC3C,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAEvE;AAED,kEAAkE;AAClE,wBAAsB,uBAAuB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,8BAAmC,GAC7C,OAAO,CAAC,iBAAiB,CAAC,CA4C5B"}

package/dist/node/node-liveness.d.ts

@@ -0,0 +1,30 @@
+import { type Node } from "./node.interface";
+export interface TaskNodeLivenessFreshest {
+    nodeId: string;
+    status: string;
+    lastHeartBeat: string;
+    ageMs: number;
+}
+export interface TaskNodeLivenessReport {
+    healthy: boolean;
+    staleMs: number;
+    /** BUSY nodes with numeric heartbeat after {@link EvaluateBusyNodeLivenessOptions.excludeNodeId}. */
+    busyWorkerCount: number;
+    /** Subset of candidates with heartbeat age < staleMs. */
+    freshWorkerCount: number;
+    freshest: TaskNodeLivenessFreshest | null;
+}
+export interface EvaluateBusyNodeLivenessOptions {
+    staleMs: number;
+    now?: number;
+    /** Omit this node id (e.g. supervisor self). */
+    excludeNodeId?: string;
+    /**
+     * When true, pick freshest only among peers already within staleMs (supervisor spawn guard).
+     * When false, pick freshest among all BUSY peers then compare age to staleMs (observability).
+     */
+    onlyFreshCandidates?: boolean;
+}
+/** Evaluate TaskNode liveness from a scanned node list (no I/O). */
+export declare function evaluateBusyNodeLiveness(nodes: Node[], options: EvaluateBusyNodeLivenessOptions): TaskNodeLivenessReport;
+//# sourceMappingURL=node-liveness.d.ts.map

package/dist/node/node-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-liveness.d.ts","sourceRoot":"","sources":["../../src/node/node-liveness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAc,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,+BAA+B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC;AAMD,oEAAoE;AACpE,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,+BAA+B,GACzC,sBAAsB,CAwCxB"}

package/dist/node/node-runtime.base.d.ts

@@ -1,12 +1,19 @@
 import { CommandType } from "../command/command.interface";
-import { type LoggerWithScope } from "../shared/log";
-import { NodeLoopContext } from "./node.interface";
+import { type LoggerWithScope, LogLevel } from "../shared/log";
+/** 主循环单轮运行时上下文 — 由 start() 创建并向下传递 */
+export interface NodeLoopContext {
+    loopTraceId: string;
+    nodeId: string;
+}
+export declare const LOG_TOPIC_NODE = "node";
 /**
  * Shared node process runtime: bootstrap, main-loop frame, heartbeat, commands, shutdown.
  * Subclasses implement {@link onBeforeRegisterNode} and {@link runLoopSteps}.
  */
 declare abstract class BaseNodeRuntime {
     protected static readonly HEARTBEAT_FAILURE_THRESHOLD = 3;
+    /** Log `nodeId` label while startup has not yet received an assigned id from Supabase. */
+    private static readonly NODE_ID_PENDING_ASSIGNMENT;
     protected readonly runtimeModule: string;
     private _localNodeId;
     private _isNodeIdLocked;
@@ -24,19 +31,30 @@ declare abstract class BaseNodeRuntime {
     protected abstract onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
     /** Hook: one iteration body after commands + heartbeat gate. */
     protected abstract runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;
+    /** Hook: minimum log level for main-loop scoped loggers (heartbeat, batchCommand, iteration). */
+    protected loopLoggerMinLevel(): LogLevel;
+    /** Hook: ms to wait between loop iterations. Default: random 15–60s. */
+    protected getLoopIntervalMs(): number;
     private getLogNodeId;
     protected isShuttingDown(): boolean;
     protected requestShutdown(trigger: string): void;
     private registerProcessLifecycle;
     start(): Promise<void>;
     private runStart;
+    private runLoop;
     shutdown(options?: {
         trigger?: string;
     }): Promise<void>;
     private runShutdown;
     heartbeat(ctx: NodeLoopContext): Promise<boolean>;
     batchCommand(ctx: NodeLoopContext): Promise<void>;
-    executeCommand(cmd: CommandType): Promise<void>;
+    /** Shared commands, then {@link resolveNodeCommand} for subclass-specific handling. */
+    protected executeCommand(cmd: CommandType, ctx: NodeLoopContext): Promise<void>;
+    /**
+     * Hook: handle node-type-specific {@link CommandType} values.
+     * Default rejects anything not handled in {@link executeCommand}.
+     */
+    protected resolveNodeCommand(cmd: CommandType, _ctx: NodeLoopContext): Promise<void>;
 }
 export { BaseNodeRuntime };
 //# sourceMappingURL=node-runtime.base.d.ts.map

package/dist/node/node-runtime.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-runtime.base.d.ts","sourceRoot":"","sources":["../../src/node/node-runtime.base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAKH,KAAK,eAAe,EAEvB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,eAAe,EAAc,MAAM,kBAAkB,CAAC;AAG/D;;;GAGG;AACH,uBAAe,eAAe;IAC1B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,KAAK;IAE1D,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,YAAY,CAA8B;IAElD,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,SAAS,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAUtC;IAED,SAAS,aAAa,aAAa,EAAE,MAAM;IAQ3C,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/E,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1F,OAAO,CAAC,YAAY;IAIpB,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,wBAAwB;IAsD1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,QAAQ;IAkHhB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B/C,WAAW;IAqCnB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDjD,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEjD,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAWxD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"node-runtime.base.d.ts","sourceRoot":"","sources":["../../src/node/node-runtime.base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAGH,KAAK,eAAe,EACpB,QAAQ,EAIX,MAAM,eAAe,CAAC;AAMvB,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,SAAS,CAAC;AAIrC;;;GAGG;AACH,uBAAe,eAAe;IAC1B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,KAAK;IAC1D,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAqB;IAEvE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,YAAY,CAA8B;IAElD,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,SAAS,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAUtC;IAED,SAAS,aAAa,aAAa,EAAE,MAAM;IAQ3C,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/E,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1F,iGAAiG;IACjG,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC,wEAAwE;IACxE,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,OAAO,CAAC,YAAY;IAIpB,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,wBAAwB;IAsD1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,QAAQ;YAsER,OAAO;IAoDf,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B/C,WAAW;IAoCnB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDjD,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DvD,uFAAuF;cACvE,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrF;;;OAGG;cACa,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7F;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/node/node.api.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { Node, NodeStatus } from "./node.interface";
+import { type Node, NodeStatus } from "./node.interface";
 export declare const postRegisterNodeSchema: z.ZodObject<{
     traceId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {

package/dist/node/node.api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.api.d.ts","sourceRoot":"","sources":["../../src/node/node.api.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,IAAI,EAAe,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS/E,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE7E,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEjF,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE,eAAO,MAAM,2BAA2B;;;IAGpC,yEAAyE;;;;;;;;;;;;;EAG3E,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAUvF,eAAO,MAAM,gBAAgB;;wFAqB3B,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;4FAa7B,CAAC;AAIH,eAAO,MAAM,aAAa;;;4FAexB,CAAC;AAIH,eAAO,MAAM,qBAAqB;;;;;wFA0BhC,CAAC"}
+{"version":3,"file":"node.api.d.ts","sourceRoot":"","sources":["../../src/node/node.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAgB,KAAK,IAAI,EAAoB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUzF,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE7E,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEjF,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE,eAAO,MAAM,2BAA2B;;;IAGpC,yEAAyE;;;;;;;;;;;;;EAG3E,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAUvF,eAAO,MAAM,gBAAgB;;wFAqB3B,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;4FAa7B,CAAC;AAIH,eAAO,MAAM,aAAa;;;4FAexB,CAAC;AAIH,eAAO,MAAM,qBAAqB;;;;;wFA0BhC,CAAC"}

package/dist/node/node.interface.d.ts

@@ -1,4 +1,4 @@
-import { Target } from "../core.interface";
+import type { Target } from "../core.interface";
 export declare enum NodeStatus {
     /** Registered, not yet in worker loop. */
     READY = "READY",
@@ -27,9 +27,4 @@ export interface NodeDetails {
     status: NodeStatus;
     lastHeartBeat: number;
 }
-/** 主循环单轮运行时上下文 — 由 start() 创建并向下传递 */
-export interface NodeLoopContext {
-    loopTraceId: string;
-    nodeId: string;
-}
 //# sourceMappingURL=node.interface.d.ts.map

package/dist/node/node.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.interface.d.ts","sourceRoot":"","sources":["../../src/node/node.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,UAAU;IAClB,0CAA0C;IAC1C,KAAK,UAAU;IACf,kEAAkE;IAClE,IAAI,SAAS;IACb,sFAAsF;IACtF,IAAI,SAAS;IACb,kGAAkG;IAClG,QAAQ,aAAa;IACrB,mEAAmE;IACnE,QAAQ,aAAa;CACxB;AAED,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"node.interface.d.ts","sourceRoot":"","sources":["../../src/node/node.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,UAAU;IAClB,0CAA0C;IAC1C,KAAK,UAAU;IACf,kEAAkE;IAClE,IAAI,SAAS;IACb,sFAAsF;IACtF,IAAI,SAAS;IACb,kGAAkG;IAClG,QAAQ,aAAa;IACrB,mEAAmE;IACnE,QAAQ,aAAa;CACxB;AAED,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB"}

package/dist/node/preload/run-service-preload.d.ts

@@ -0,0 +1,14 @@
+import type { ServicePreloadOptions } from "./service-preload.interface";
+/**
+ * Unified Node `--import` preload runner (sync only).
+ *
+ * Phase 1 — Resolve project root from service package name
+ * Phase 2 — Load `.env.local` / `.env`
+ * Phase 3 — Apply SDK service env defaults + optional L3 hook
+ * Phase 4 — Validate log-persist env when enabled
+ * Phase 5 — Process diagnostics (TODO)
+ *
+ * Supabase init and log-persist enable stay in app `main()` (async).
+ */
+export declare function runServicePreload(options: ServicePreloadOptions): void;
+//# sourceMappingURL=run-service-preload.d.ts.map

package/dist/node/preload/run-service-preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-service-preload.d.ts","sourceRoot":"","sources":["../../../src/node/preload/run-service-preload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAmBzE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAYtE"}

package/dist/node/preload/service-preload.interface.d.ts

@@ -0,0 +1,15 @@
+export interface ServicePreloadOptions {
+    /** `import.meta.url` from the service `scripts/preload.mjs`. */
+    callerImportMetaUrl: string;
+    /** package.json `name` — for resolveProjectRootByPackageName. */
+    packageName: string;
+    /** LOG_PERSIST_SERVICE default when persistence enabled. */
+    serviceValue: string;
+    /** Relative to project root; default `data/runtime`. */
+    runtimeDataDirRelative?: string;
+    /** Passed to loadEnvFiles `afterLoad`. */
+    afterLoadEnv?: () => void;
+    /** L3 hook after SDK defaults (legacy aliases, etc.). */
+    applyEnvDefaults?: (projectRoot: string) => void;
+}
+//# sourceMappingURL=service-preload.interface.d.ts.map

package/dist/node/preload/service-preload.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-preload.interface.d.ts","sourceRoot":"","sources":["../../../src/node/preload/service-preload.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IAClC,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD"}

package/dist/node/process/index.d.ts

@@ -0,0 +1,5 @@
+export type { ManagedChildProcessesOptions, SpawnChildResult, StopAllChildrenOptions, } from "./managed-child-processes";
+export { ManagedChildProcesses } from "./managed-child-processes";
+export type { BuildNodeImportArgsInput, SpawnTsxChildOptions } from "./process-spawn";
+export { buildNodeImportArgs, isChildProcessRunning, spawnTsxChild } from "./process-spawn";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/process/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/process/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/node/process/managed-child-processes.d.ts

@@ -0,0 +1,37 @@
+import type { ChildProcess } from "node:child_process";
+import type { LoggerWithScope } from "../../shared/log";
+export interface ManagedChildProcessesOptions {
+    projectRoot: string;
+    preloadModules?: readonly string[];
+    /** SIGTERM -> wait -> SIGKILL delay (default 5000 ms). */
+    graceMs?: number;
+    logger?: Pick<LoggerWithScope, "info" | "warn" | "error">;
+}
+export interface SpawnChildResult {
+    child: ChildProcess;
+    /** false when an equivalent label was already running. */
+    created: boolean;
+}
+export interface StopAllChildrenOptions {
+    /** PIDs to SIGTERM when not tracked by this registry (cross-process cleanup). */
+    extraPids?: readonly number[];
+}
+/**
+ * Process-local registry for tsx child processes (supervisor, worker, etc.).
+ * Each OS process has its own instance - do not expect cross-process PID tracking.
+ */
+export declare class ManagedChildProcesses {
+    private readonly projectRoot;
+    private readonly preloadModules;
+    private readonly graceMs;
+    private readonly logger?;
+    private readonly byLabel;
+    constructor(options: ManagedChildProcessesOptions);
+    get(label: string): ChildProcess | null;
+    getRunning(label: string): ChildProcess | null;
+    runningLabels(): string[];
+    spawn(label: string, entryScript: string): SpawnChildResult;
+    stopAll(options?: StopAllChildrenOptions): Promise<void>;
+    private stopChild;
+}
+//# sourceMappingURL=managed-child-processes.d.ts.map

package/dist/node/process/managed-child-processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-child-processes.d.ts","sourceRoot":"","sources":["../../../src/node/process/managed-child-processes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,4BAA4B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,iFAAiF;IACjF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAmD;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAE/C,OAAO,EAAE,4BAA4B;IAOjD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIvC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK9C,aAAa,IAAI,MAAM,EAAE;IAMzB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAkCrD,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D,OAAO,CAAC,SAAS;CAWpB"}

package/dist/node/process/process-spawn.d.ts

@@ -0,0 +1,27 @@
+import { type ChildProcess, type StdioOptions } from "node:child_process";
+export interface BuildNodeImportArgsInput {
+    /** Relative `--import` paths (e.g. `./scripts/preload-env.mjs`). */
+    preloadModules?: readonly string[];
+    /** When true (default), inserts `--import tsx` before the entry script. */
+    useTsx?: boolean;
+    /** Entry script relative to `projectRoot` when spawning. */
+    entryScript: string;
+}
+/**
+ * Build argv for `node --import … --import tsx <entry>`.
+ * Use **relative** preload paths with `cwd: projectRoot` — Node 24 on Windows rejects
+ * absolute paths like `D:\…` for `--import` (ESM URL scheme error).
+ */
+export declare function buildNodeImportArgs(input: BuildNodeImportArgsInput): string[];
+export interface SpawnTsxChildOptions {
+    projectRoot: string;
+    entryScript: string;
+    preloadModules?: readonly string[];
+    useTsx?: boolean;
+    env?: NodeJS.ProcessEnv;
+    stdio?: StdioOptions;
+}
+/** Spawn `node` with preload chain + tsx + TypeScript entry (relative to projectRoot). */
+export declare function spawnTsxChild(options: SpawnTsxChildOptions): ChildProcess;
+export declare function isChildProcessRunning(child: ChildProcess | null | undefined): child is ChildProcess;
+//# sourceMappingURL=process-spawn.d.ts.map

package/dist/node/process/process-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-spawn.d.ts","sourceRoot":"","sources":["../../../src/node/process/process-spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAEjF,MAAM,WAAW,wBAAwB;IACrC,oEAAoE;IACpE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAa7E;AAED,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,YAAY,CAezE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,YAAY,CAEnG"}

package/dist/node/readiness/index.d.ts

@@ -0,0 +1,9 @@
+export type { PollUntilOptions } from "./poll-until";
+export { pollUntil } from "./poll-until";
+export type { ReadinessCheck, ReadinessCheckResult, ReadinessReport } from "./readiness.types";
+export type { PathsExistCheckOptions, RequiredEnvCheckOptions, SupabaseReachableCheckOptions, } from "./readiness-checks";
+export { createPathsExistCheck, createRequiredEnvCheck, createSupabaseReachableCheck, } from "./readiness-checks";
+export { runReadinessChecks } from "./run-readiness-checks";
+export type { ServiceReadyGate, ServiceReadySnapshot, WaitForServiceReadyOptions, } from "./service-ready-gate";
+export { waitForServiceReady } from "./service-ready-gate";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/readiness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/readiness/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/F,YAAY,EACR,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,GAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,GAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EACR,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/node/readiness/poll-until.d.ts

@@ -0,0 +1,11 @@
+export interface PollUntilOptions {
+    timeoutMs: number;
+    intervalMs?: number;
+    until: () => boolean | Promise<boolean>;
+}
+/**
+ * Poll `until()` until it returns true or `timeoutMs` elapses.
+ * @throws Error on timeout
+ */
+export declare function pollUntil(options: PollUntilOptions): Promise<void>;
+//# sourceMappingURL=poll-until.d.ts.map

package/dist/node/readiness/poll-until.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-until.d.ts","sourceRoot":"","sources":["../../../src/node/readiness/poll-until.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxE"}

package/dist/node/readiness/readiness-checks.d.ts

@@ -0,0 +1,22 @@
+import type { ReadinessCheck } from "./readiness.types";
+export interface RequiredEnvCheckOptions {
+    env?: NodeJS.ProcessEnv;
+}
+/** Factory: all listed env keys must be non-empty. */
+export declare function createRequiredEnvCheck(name: string, keys: string[], options?: RequiredEnvCheckOptions): ReadinessCheck;
+export interface PathsExistCheckOptions {
+    /** Detail string when all paths exist (default: last path). */
+    successDetail?: string;
+    /** Detail prefix when a path is missing. */
+    missingDetail?: string;
+}
+/** Factory: every path must exist on disk. */
+export declare function createPathsExistCheck(name: string, paths: string[], options?: PathsExistCheckOptions): ReadinessCheck;
+export interface SupabaseReachableCheckOptions {
+    name?: string;
+    category?: string;
+    maxRows?: number;
+}
+/** Factory: lightweight Supabase query via {@link scanTargetList}. */
+export declare function createSupabaseReachableCheck(options?: SupabaseReachableCheckOptions): ReadinessCheck;
+//# sourceMappingURL=readiness-checks.d.ts.map

package/dist/node/readiness/readiness-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-checks.d.ts","sourceRoot":"","sources":["../../../src/node/readiness/readiness-checks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AAE9E,MAAM,WAAW,uBAAuB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,uBAAuB,GAClC,cAAc,CAahB;AAED,MAAM,WAAW,sBAAsB;IACnC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,8CAA8C;AAC9C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,cAAc,CAkBrH;AAED,MAAM,WAAW,6BAA6B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,6BAA6B,GAAG,cAAc,CAcpG"}

package/dist/node/readiness/readiness.types.d.ts

@@ -0,0 +1,12 @@
+export interface ReadinessCheckResult {
+    name: string;
+    ok: boolean;
+    detail?: string;
+}
+export interface ReadinessReport {
+    ok: boolean;
+    checks: ReadinessCheckResult[];
+    message: string | null;
+}
+export type ReadinessCheck = () => ReadinessCheckResult | Promise<ReadinessCheckResult>;
+//# sourceMappingURL=readiness.types.d.ts.map

package/dist/node/readiness/readiness.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.types.d.ts","sourceRoot":"","sources":["../../../src/node/readiness/readiness.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/node/readiness/run-readiness-checks.d.ts

@@ -0,0 +1,4 @@
+import type { ReadinessCheck, ReadinessReport } from "./readiness.types";
+/** Run checks in order and aggregate into a {@link ReadinessReport}. */
+export declare function runReadinessChecks(checks: ReadinessCheck[]): Promise<ReadinessReport>;
+//# sourceMappingURL=run-readiness-checks.d.ts.map

package/dist/node/readiness/run-readiness-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-readiness-checks.d.ts","sourceRoot":"","sources":["../../../src/node/readiness/run-readiness-checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASzE,wEAAwE;AACxE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAS3F"}