target-supabase-sdk 0.2.15 → 0.2.17

package/src/browser.ts

@@ -6,6 +6,12 @@
  */
 
 export type { SupabaseClient } from "@supabase/supabase-js";
+export type {
+    Config,
+    ConfigDetails,
+    GetConfigPayload,
+} from "./config/index";
+export { CategoryConfig, getConfig, getConfigSchema } from "./config/index";
 export * from "./core.api";
 export * from "./core.interface";
 export * from "./core.schema";
@@ -102,13 +108,10 @@ export * from "./repo/repo.interface";
 export type {
     Api,
     ApiDetails,
-    AppendSystemRegistrySlotsInput,
-    AppendSystemRegistrySlotsOutcome,
+    AppendSystemRegistryEmptySlotsInput,
+    AppendSystemRegistryEmptySlotsOutcome,
     ClaimRegistrySlotInput,
-    Config,
-    ConfigDetails,
     GetApiPayload,
-    GetConfigPayload,
     GetServicePayload,
     PatchServiceRuntimeInput,
     PostApiPayload,
@@ -136,12 +139,11 @@ export type {
 export {
     ApiMethod,
     apiDetailsSchema,
-    appendSystemRegistrySlots,
+    appendSystemRegistryEmptySlots,
     assertRegistrySlotAvailable,
     assertRegistrySlotOwner,
     buildEmptyServiceSlots,
     buildSystemRegistryConfigDetails,
-    CategoryConfig,
     CategoryService,
     claimServiceRegistrySlot,
     createActiveServiceLifecycle,
@@ -152,8 +154,6 @@ export {
     fieldDefinitionSchema,
     getApi,
     getApiSchema,
-    getConfig,
-    getConfigSchema,
     getService,
     getServiceSchema,
     getTargetSystemRegistry,
@@ -189,6 +189,7 @@ export {
     unregisterService,
     unregisterServiceAtShutdown,
 } from "./service/index";
+
 export type { FetchInitFactory, FetchRetryOptions } from "./shared/http/fetch-retry";
 export {
     fetchBinaryWithRetry,
@@ -222,6 +223,17 @@ export {
     parseLogBatchMeta,
     resolveLogMinLevel,
 } from "./shared/log";
+export type { BuildMediaLinkDraftInput, MediaOriginal, MediaValue } from "./shared/media";
+export {
+    buildMediaLinkDraft,
+    buildMediaNameFromLocator,
+    guessMediaMime,
+    isMediaValue,
+    MEDIA_CONTENT_HASH_ALGORITHM,
+    MEDIA_CONTENT_HASH_PREFIX_LENGTH,
+    MEDIA_VALUES,
+    mediaLinkDedupFilters,
+} from "./shared/media";
 export { isHttpUrl, resolveFetchUrl } from "./shared/utils/fetch-url";
 export { getValueAtPath } from "./shared/utils/get-value-at-path";
 export type {

package/src/config/config.api.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { getPossibleTarget, getTarget, type QueryFilter, validateWithSchema } from "../core.api";
+import { CategoryConfig, type Config } from "./config.interface";
+
+const targetIdSchema = z.string().trim().min(1);
+
+export const getConfigSchema = z
+    .object({
+        id: targetIdSchema.optional(),
+        value: z.string().trim().min(1).optional(),
+    })
+    .refine(
+        (payload) => {
+            const hasId = payload.id != null && payload.id !== "";
+            const hasValue = payload.value != null && payload.value !== "";
+            return hasId !== hasValue;
+        },
+        { message: "Provide exactly one of id or value" },
+    );
+
+export type GetConfigPayload = z.infer<typeof getConfigSchema>;
+
+const configCategoryFilter: QueryFilter = {
+    field: "category",
+    operator: "eq",
+    value: CategoryConfig.CONFIG,
+};
+
+function buildConfigLookupFilters(payload: GetConfigPayload): QueryFilter[] {
+    const filters: QueryFilter[] = [configCategoryFilter];
+
+    if (payload.id == null || payload.id === "") {
+        filters.push({ field: "value", operator: "eq", value: payload.value! });
+    }
+
+    return filters;
+}
+
+/** Fetch a Config by id or by {@link Config.value} key (`category=config`). */
+export const getConfig = validateWithSchema(
+    getConfigSchema,
+    "getConfigSchema",
+)(async (payload) => {
+    const filterList = buildConfigLookupFilters(payload);
+
+    if (payload.id != null && payload.id !== "") {
+        const result = await getTarget({
+            id: payload.id,
+            filterList,
+        });
+        return {
+            ...result,
+            data: result.data as Config,
+        };
+    }
+
+    const result = await getPossibleTarget({
+        filterList,
+    });
+
+    if (result.data == null) {
+        return {
+            ...result,
+            data: undefined,
+        };
+    }
+
+    return {
+        ...result,
+        data: result.data as Config,
+    };
+});

package/src/{service → config}/config.interface.ts

@@ -3,7 +3,7 @@ import type { Target } from "../core.interface";
 export interface Config extends Target {
     /** Human readable name */
     name: string;
-    /** Unique key, like TARGET_SYSTEM_REGISTRY_KEY */
+    /** Unique key (e.g. system registry Config value) */
     value: string;
     category: CategoryConfig;
     details: ConfigDetails;
@@ -13,9 +13,6 @@ export enum CategoryConfig {
     CONFIG = "config",
 }
 
-/** Globally unique Config key for the declarative system service registry. */
-export const TARGET_SYSTEM_REGISTRY_KEY = "target-system-registry";
-
 export interface ConfigDetails {
     manifestVersion: number;
     /** How to resolve the Config */

package/src/config/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Config domain public API — curated re-exports only.
+ * System registry seed / claim APIs live in `src/service/registry/`.
+ */
+
+export type { GetConfigPayload } from "./config.api";
+export { getConfig, getConfigSchema } from "./config.api";
+export type { Config, ConfigDetails } from "./config.interface";
+export { CategoryConfig } from "./config.interface";

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

@@ -1,4 +1,4 @@
-import { EMPTY_REGISTRY_SLOT_RUNTIME_STATE } from "../../service/registry-lifecycle";
+import { EMPTY_REGISTRY_SLOT_RUNTIME_STATE } from "../../service/registry/registry-lifecycle";
 import type { JsonStatePatch } from "../fs/json-state-store";
 import { createShardedJsonFileStateStore } from "../fs/sharded-json-state-store";
 import type {

package/src/node/runtime-state/service-runtime-state.types.ts

@@ -1,4 +1,4 @@
-import type { RegistrySlotRuntimeState } from "../../service/registry-lifecycle";
+import type { RegistrySlotRuntimeState } from "../../service/registry/registry-lifecycle";
 
 export type ReadinessStatus = "pending" | "passed" | "failed";
 

package/src/node/service-guard/registry-slot-guard-step.ts

@@ -1,4 +1,7 @@
-import { registrySlotRuntimePatchFromGuardResult, runRegistrySlotGuardCheck } from "../../service/registry-lifecycle";
+import {
+    registrySlotRuntimePatchFromGuardResult,
+    runRegistrySlotGuardCheck,
+} from "../../service/registry/registry-lifecycle";
 import type { LoggerWithScope } from "../../shared/log";
 
 export interface ApplyRegistrySlotGuardInput {

package/src/node/service-guard/run-service-guard-tick.ts

@@ -1,5 +1,5 @@
 import { scanTargetList } from "../../core.api";
-import { patchServiceRuntime } from "../../service/registry.service";
+import { patchServiceRuntime } from "../../service/registry/registry.service";
 import { CategoryNode, type Node } from "../node.interface";
 import { evaluateBusyNodeLiveness } from "../node-liveness";
 import { applyRegistrySlotGuardStep } from "./registry-slot-guard-step";

package/src/node/service-guard/service-guard.interface.ts

@@ -1,4 +1,4 @@
-import type { RegistrySlotRuntimeState } from "../../service/registry-lifecycle";
+import type { RegistrySlotRuntimeState } from "../../service/registry/registry-lifecycle";
 import type { LoggerWithScope } from "../../shared/log";
 import type { Node } from "../node.interface";
 import type { ReadinessCheck, ReadinessReport } from "../readiness/readiness.types";

package/src/node/service-host/claim-registry-slot.ts

@@ -1,5 +1,5 @@
-import { ServiceRegistryError } from "../../service/registry.service";
-import { claimServiceRegistrySlot, type ServiceRegistrySession } from "../../service/registry-lifecycle";
+import { ServiceRegistryError } from "../../service/registry/registry.service";
+import { claimServiceRegistrySlot, type ServiceRegistrySession } from "../../service/registry/registry-lifecycle";
 import type { Service } from "../../service/service.interface";
 import type { LoggerWithScope } from "../../shared/log";
 

package/src/node/service-host/service-host.ts

@@ -1,5 +1,5 @@
-import { ServiceRegistryError } from "../../service/registry.service";
-import type { ServiceRegistrySession } from "../../service/registry-lifecycle";
+import { ServiceRegistryError } from "../../service/registry/registry.service";
+import type { ServiceRegistrySession } from "../../service/registry/registry-lifecycle";
 import type { Service } from "../../service/service.interface";
 import { createLogger, type LoggerWithScope } from "../../shared/log";
 import { LOG_SPOOL_SERVICE_ID_ENV } from "../../shared/log/spool/config";

package/src/node/service-host/single-process-service.ts

@@ -1,4 +1,4 @@
-import type { ServiceRegistrySession } from "../../service/registry-lifecycle";
+import type { ServiceRegistrySession } from "../../service/registry/registry-lifecycle";
 import type { Service } from "../../service/service.interface";
 import { createLogger, type LoggerWithScope } from "../../shared/log";
 import { claimRegistrySlotOrExit } from "./claim-registry-slot";

package/src/node.ts

@@ -165,6 +165,19 @@ export {
     shutdownLogSpool,
 } from "./shared/log/spool/service-lifecycle";
 export type { LogBatchMeta, LogPersistLane } from "./shared/log/upload/interface";
+export type {
+    CheckMediaAvailabilityInput,
+    FindMediaLinkInput,
+    MediaAvailabilityResult,
+    RegisterMediaLinkInput,
+    RegisterMediaLinkResult,
+} from "./shared/media/node";
+export {
+    checkMediaAvailability,
+    findMediaLink,
+    probeMediaOriginal,
+    registerMediaLink,
+} from "./shared/media/node";
 export type {
     ConfigSchema,
     LoadCachedJsConfigOptions,

package/src/service/index.ts

@@ -1,5 +1,6 @@
 /**
  * Service domain public API — curated re-exports only.
+ * System registry: `./registry/` (seed, claim, slot views).
  */
 
 export type {
@@ -10,68 +11,58 @@ export type {
 } 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 {
-    AppendSystemRegistrySlotsInput,
-    AppendSystemRegistrySlotsOutcome,
+    AppendSystemRegistryEmptySlotsInput,
+    AppendSystemRegistryEmptySlotsOutcome,
+    ClaimRegistrySlotInput,
     PatchServiceRuntimeInput,
+    PostSystemRegistryConfigPayload,
     RegisterServiceInput,
+    RegistrySlotGuardResult,
+    RegistrySlotRuntimeState,
     ReleasedRegistrySlot,
     ReleaseSystemRegistrySlotsByServiceIdInput,
     ReleaseSystemRegistrySlotsByServiceIdOutcome,
     ReleaseSystemRegistrySlotsInput,
     ReleaseSystemRegistrySlotsOutcome,
+    ResetSystemRegistryConfigPayload,
+    ServiceRegistrySession,
+    ServiceSlot,
+    SystemRegistrySeedSlot,
     TargetSystemRegistrySlotView,
     TargetSystemRegistryView,
-} from "./registry.service";
+} from "./registry/index";
 export {
-    appendSystemRegistrySlots,
+    appendSystemRegistryEmptySlots,
     assertRegistrySlotAvailable,
     assertRegistrySlotOwner,
+    buildEmptyServiceSlots,
+    buildSystemRegistryConfigDetails,
+    claimServiceRegistrySlot,
+    createClaimedRegistrySlotRuntimeState,
+    DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS,
+    EMPTY_REGISTRY_SLOT_RUNTIME_STATE,
     getTargetSystemRegistry,
     parseServiceSlot,
     parseServiceSlots,
     patchServiceRuntime,
+    postSystemRegistryConfig,
+    postSystemRegistryConfigSchema,
     registerService,
     registerServiceAtStartup,
+    registrySlotRuntimePatchFromGuardResult,
     releaseSystemRegistrySlots,
     releaseSystemRegistrySlotsByServiceId,
+    resetSystemRegistryConfig,
+    resetSystemRegistryConfigSchema,
     resolveActiveRegistryServiceId,
+    runRegistrySlotGuardCheck,
     ServiceRegistryError,
+    ServiceSlotStatus,
+    systemRegistrySeedSlotSchema,
+    TARGET_SYSTEM_REGISTRY_KEY,
     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";
+} from "./registry/index";
 export type { GetApiPayload, GetServicePayload, PostApiPayload, PostServicePayload } from "./service.api";
 export {
     apiDetailsSchema,
@@ -97,9 +88,8 @@ export type {
     ServiceDetails,
     ServiceNodeSnapshot,
     ServiceRuntime,
-    ServiceSlot,
 } from "./service.interface";
-export { ApiMethod, CategoryApi, CategoryService, ServiceSlotStatus } from "./service.interface";
+export { ApiMethod, CategoryApi, CategoryService } from "./service.interface";
 export type { PostServiceInstanceOptions, ServiceBootstrapResult } from "./service-bootstrap";
 export {
     createActiveServiceLifecycle,

package/src/service/registry/index.ts

@@ -0,0 +1,65 @@
+/**
+ * System service registry — curated re-exports only.
+ * Generic Config CRUD lives in `src/config/`.
+ */
+
+export type {
+    PostSystemRegistryConfigPayload,
+    ResetSystemRegistryConfigPayload,
+    SystemRegistrySeedSlot,
+} from "./registry.api";
+export {
+    buildEmptyServiceSlots,
+    buildSystemRegistryConfigDetails,
+    postSystemRegistryConfig,
+    postSystemRegistryConfigSchema,
+    resetSystemRegistryConfig,
+    resetSystemRegistryConfigSchema,
+    systemRegistrySeedSlotSchema,
+} from "./registry.api";
+export { DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS, TARGET_SYSTEM_REGISTRY_KEY } from "./registry.constant";
+export type { ServiceSlot } from "./registry.interface";
+export { ServiceSlotStatus } from "./registry.interface";
+export type {
+    AppendSystemRegistryEmptySlotsInput,
+    AppendSystemRegistryEmptySlotsOutcome,
+    PatchServiceRuntimeInput,
+    RegisterServiceInput,
+    ReleasedRegistrySlot,
+    ReleaseSystemRegistrySlotsByServiceIdInput,
+    ReleaseSystemRegistrySlotsByServiceIdOutcome,
+    ReleaseSystemRegistrySlotsInput,
+    ReleaseSystemRegistrySlotsOutcome,
+    TargetSystemRegistrySlotView,
+    TargetSystemRegistryView,
+} from "./registry.service";
+export {
+    appendSystemRegistryEmptySlots,
+    assertRegistrySlotAvailable,
+    assertRegistrySlotOwner,
+    getTargetSystemRegistry,
+    parseServiceSlot,
+    parseServiceSlots,
+    patchServiceRuntime,
+    registerService,
+    registerServiceAtStartup,
+    releaseSystemRegistrySlots,
+    releaseSystemRegistrySlotsByServiceId,
+    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";

package/src/service/{registry-lifecycle.ts → registry/registry-lifecycle.ts}

@@ -1,5 +1,6 @@
-import { deleteTarget } from "../core.api";
-import { createLogger } from "../shared/log";
+import { deleteTarget } from "../../core.api";
+import { createLogger } from "../../shared/log";
+import type { Service } from "../service.interface";
 import {
     assertRegistrySlotAvailable,
     assertRegistrySlotOwner,
@@ -7,7 +8,6 @@ import {
     ServiceRegistryError,
     unregisterServiceAtShutdown,
 } from "./registry.service";
-import type { Service } from "./service.interface";
 
 const LOG_TOPIC = "service-registry-lifecycle";
 

package/src/service/{config.api.ts → registry/registry.api.ts}

@@ -1,34 +1,16 @@
 import { z } from "zod";
+import { getConfig } from "../../config/config.api";
+import { CategoryConfig, type Config, type ConfigDetails } from "../../config/config.interface";
 import {
     createTarget,
-    getPossibleTarget,
-    getTarget,
     isOptimisticLockError,
     type QueryFilter,
     updateTargetDetails,
     validateWithSchema,
-} from "../core.api";
-import { generateResponse } from "../core.interface";
-import { CategoryConfig, type Config, type ConfigDetails, TARGET_SYSTEM_REGISTRY_KEY } from "./config.interface";
-import { type ServiceSlot, ServiceSlotStatus } from "./service.interface";
-
-const targetIdSchema = z.string().trim().min(1);
-
-export const getConfigSchema = z
-    .object({
-        id: targetIdSchema.optional(),
-        value: z.string().trim().min(1).optional(),
-    })
-    .refine(
-        (payload) => {
-            const hasId = payload.id != null && payload.id !== "";
-            const hasValue = payload.value != null && payload.value !== "";
-            return hasId !== hasValue;
-        },
-        { message: "Provide exactly one of id or value" },
-    );
-
-export type GetConfigPayload = z.infer<typeof getConfigSchema>;
+} from "../../core.api";
+import { generateResponse } from "../../core.interface";
+import { DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS, TARGET_SYSTEM_REGISTRY_KEY } from "./registry.constant";
+import { type ServiceSlot, ServiceSlotStatus } from "./registry.interface";
 
 /** One declarative EMPTY slot entry for seeding the system registry. */
 export const systemRegistrySeedSlotSchema = z.object({
@@ -53,33 +35,12 @@ export type ResetSystemRegistryConfigPayload = PostSystemRegistryConfigPayload;
 const DEFAULT_RESET_RETRY_ATTEMPTS = 5;
 const RESET_RETRY_DELAY_MS = 50;
 
-/** Default one EMPTY slot per known L3 service (override via payload or seed file). */
-export const DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS: readonly SystemRegistrySeedSlot[] = [
-    { serviceValue: "log-service" },
-    { serviceValue: "watch-service" },
-    { serviceValue: "download-service" },
-    { serviceValue: "storage-service" },
-    { serviceValue: "gc-service" },
-    { serviceValue: "upload-service" },
-    { serviceValue: "cv-service" },
-] as const;
-
 const configCategoryFilter: QueryFilter = {
     field: "category",
     operator: "eq",
     value: CategoryConfig.CONFIG,
 };
 
-function buildConfigLookupFilters(payload: GetConfigPayload): QueryFilter[] {
-    const filters: QueryFilter[] = [configCategoryFilter];
-
-    if (payload.id == null || payload.id === "") {
-        filters.push({ field: "value", operator: "eq", value: payload.value! });
-    }
-
-    return filters;
-}
-
 /** Build EMPTY {@link ServiceSlot} rows from seed entries (one slot per array item). */
 export function buildEmptyServiceSlots(seedSlots: readonly SystemRegistrySeedSlot[]): ServiceSlot[] {
     return seedSlots.map(({ serviceValue }) => ({
@@ -113,41 +74,6 @@ export function buildSystemRegistryConfigDetails(slots: readonly ServiceSlot[]):
     };
 }
 
-/** Fetch a Config by id or by {@link Config.value} key (`category=config`). */
-export const getConfig = validateWithSchema(
-    getConfigSchema,
-    "getConfigSchema",
-)(async (payload) => {
-    const filterList = buildConfigLookupFilters(payload);
-
-    if (payload.id != null && payload.id !== "") {
-        const result = await getTarget({
-            id: payload.id,
-            filterList,
-        });
-        return {
-            ...result,
-            data: result.data as Config,
-        };
-    }
-
-    const result = await getPossibleTarget({
-        filterList,
-    });
-
-    if (result.data == null) {
-        return {
-            ...result,
-            data: undefined,
-        };
-    }
-
-    return {
-        ...result,
-        data: result.data as Config,
-    };
-});
-
 /**
  * Insert the globally unique system registry Config (`category=config`,
  * `value=target-system-registry`). Rejects duplicates via `checkRedundancyFilterList`.

package/src/service/registry/registry.constant.ts

@@ -0,0 +1,17 @@
+/** Globally unique Config key for the declarative system service registry. */
+export const TARGET_SYSTEM_REGISTRY_KEY = "target-system-registry";
+
+/**
+ * Default one EMPTY slot per known L3 service.
+ * Override via `postSystemRegistryConfig` / `resetSystemRegistryConfig` payload or gc-service seed file.
+ * Replica count = how many times the same `serviceValue` appears (not a separate maxInstances field).
+ */
+export const DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS = [
+    { serviceValue: "log-service" },
+    { serviceValue: "watch-service" },
+    { serviceValue: "download-service" },
+    { serviceValue: "storage-service" },
+    { serviceValue: "gc-service" },
+    { serviceValue: "upload-service" },
+    { serviceValue: "cv-service" },
+] as const;

package/src/service/registry/registry.interface.ts

@@ -0,0 +1,16 @@
+/**
+ * Capacity slots on the system registry Config (`details.objects`).
+ * Not fields on a Service Target row — see {@link Service} in `service.interface.ts`.
+ */
+
+export enum ServiceSlotStatus {
+    EMPTY = "EMPTY",
+    ACTIVE = "ACTIVE",
+}
+
+export interface ServiceSlot {
+    serviceValue: string;
+    /** Bound Service.id when {@link ServiceSlotStatus.ACTIVE}; null when EMPTY. */
+    serviceId: string | null;
+    status: ServiceSlotStatus;
+}