@objectstack/service-cluster 5.1.1

package/dist/index.js

@@ -0,0 +1,444 @@
+// src/cluster.ts
+import { ClusterCapabilityConfigSchema } from "@objectstack/spec/kernel";
+
+// src/memory/pubsub.ts
+var MemoryPubSub = class {
+  constructor(opts = {}) {
+    this.subs = /* @__PURE__ */ new Map();
+    this.closed = false;
+    this.onError = opts.onError ?? ((err, channel) => {
+      console.error(`[MemoryPubSub] handler error on channel "${channel}":`, err);
+    });
+    this.nodeId = opts.nodeId;
+  }
+  async publish(channel, payload, _opts) {
+    if (this.closed) throw new Error("MemoryPubSub is closed");
+    const bucket = this.subs.get(channel);
+    if (!bucket || bucket.size === 0) return;
+    const publishedAt = Date.now();
+    const snapshot = Array.from(bucket);
+    for (const sub of snapshot) {
+      try {
+        const result = sub.handler({
+          channel,
+          payload,
+          publishedAt,
+          fromNode: this.nodeId
+        });
+        if (result && typeof result.then === "function") {
+          result.catch((err) => this.onError(err, channel));
+        }
+      } catch (err) {
+        this.onError(err, channel);
+      }
+    }
+  }
+  subscribe(channel, handler, _opts) {
+    if (this.closed) throw new Error("MemoryPubSub is closed");
+    let bucket = this.subs.get(channel);
+    if (!bucket) {
+      bucket = /* @__PURE__ */ new Set();
+      this.subs.set(channel, bucket);
+    }
+    const sub = { channel, handler };
+    bucket.add(sub);
+    let disposed = false;
+    return () => {
+      if (disposed) return;
+      disposed = true;
+      const b = this.subs.get(channel);
+      if (!b) return;
+      b.delete(sub);
+      if (b.size === 0) this.subs.delete(channel);
+    };
+  }
+  async close() {
+    this.closed = true;
+    this.subs.clear();
+  }
+};
+
+// src/memory/lock.ts
+var DEFAULT_TTL_MS = 15e3;
+var MemoryLock = class {
+  constructor(opts = {}) {
+    this.holders = /* @__PURE__ */ new Map();
+    this.queues = /* @__PURE__ */ new Map();
+    this.fenceSeq = 0n;
+    this.closed = false;
+    this.defaultTtlMs = opts.defaultTtlMs ?? DEFAULT_TTL_MS;
+  }
+  async acquire(key, opts = {}) {
+    if (this.closed) throw new Error("MemoryLock is closed");
+    const ttlMs = opts.ttlMs ?? this.defaultTtlMs;
+    const waitMs = opts.waitMs ?? 0;
+    if (!this.holders.has(key)) {
+      return this.grant(key, ttlMs);
+    }
+    if (waitMs <= 0) return null;
+    return new Promise((resolve) => {
+      const deadline = Date.now() + waitMs;
+      const waiter = { resolve, deadline, opts };
+      const queue = this.queues.get(key) ?? [];
+      queue.push(waiter);
+      this.queues.set(key, queue);
+      waiter.timer = setTimeout(() => {
+        const q = this.queues.get(key);
+        if (q) {
+          const idx = q.indexOf(waiter);
+          if (idx >= 0) q.splice(idx, 1);
+        }
+        resolve(null);
+      }, waitMs);
+    });
+  }
+  async withLock(key, fn, opts) {
+    const handle = await this.acquire(key, opts);
+    if (!handle) return null;
+    try {
+      return await fn(handle);
+    } finally {
+      await handle.release();
+    }
+  }
+  async close() {
+    this.closed = true;
+    for (const [, holder] of this.holders) {
+      if (holder.timer) clearTimeout(holder.timer);
+      holder.released = true;
+    }
+    this.holders.clear();
+    for (const [, q] of this.queues) {
+      for (const w of q) {
+        if (w.timer) clearTimeout(w.timer);
+        w.resolve(null);
+      }
+    }
+    this.queues.clear();
+  }
+  grant(key, ttlMs) {
+    const fencingToken = ++this.fenceSeq;
+    const holder = {
+      fencingToken,
+      expiresAt: Date.now() + ttlMs,
+      released: false
+    };
+    holder.timer = setTimeout(() => this.expire(key, holder), ttlMs);
+    this.holders.set(key, holder);
+    const self = this;
+    const handle = {
+      key,
+      fencingToken,
+      isHeld: () => !holder.released && self.holders.get(key) === holder,
+      async renew(extendMs) {
+        if (holder.released || self.holders.get(key) !== holder) {
+          throw new Error(`Lock "${key}" no longer held (fence=${fencingToken})`);
+        }
+        const next = extendMs ?? ttlMs;
+        holder.expiresAt = Date.now() + next;
+        if (holder.timer) clearTimeout(holder.timer);
+        holder.timer = setTimeout(() => self.expire(key, holder), next);
+      },
+      async release() {
+        if (holder.released || self.holders.get(key) !== holder) return;
+        holder.released = true;
+        if (holder.timer) clearTimeout(holder.timer);
+        self.holders.delete(key);
+        self.handoff(key);
+      }
+    };
+    return handle;
+  }
+  expire(key, holder) {
+    if (holder.released) return;
+    if (this.holders.get(key) !== holder) return;
+    holder.released = true;
+    this.holders.delete(key);
+    this.handoff(key);
+  }
+  handoff(key) {
+    const queue = this.queues.get(key);
+    if (!queue || queue.length === 0) return;
+    const next = queue.shift();
+    if (next.timer) clearTimeout(next.timer);
+    if (Date.now() > next.deadline) {
+      next.resolve(null);
+      this.handoff(key);
+      return;
+    }
+    const ttlMs = next.opts.ttlMs ?? this.defaultTtlMs;
+    next.resolve(this.grant(key, ttlMs));
+    if (queue.length === 0) this.queues.delete(key);
+  }
+};
+
+// src/memory/kv.ts
+var MemoryKV = class {
+  constructor() {
+    this.store = /* @__PURE__ */ new Map();
+    this.closed = false;
+  }
+  async get(key) {
+    const e = this.store.get(key);
+    if (!e) return void 0;
+    if (e.expiresAt && Date.now() >= e.expiresAt) {
+      this.store.delete(key);
+      return void 0;
+    }
+    return {
+      key,
+      value: e.value,
+      version: e.version,
+      expiresAt: e.expiresAt
+    };
+  }
+  async set(key, value, opts = {}) {
+    if (this.closed) throw new Error("MemoryKV is closed");
+    const existing = this.store.get(key);
+    const existingVersion = existing ? existing.expiresAt && Date.now() >= existing.expiresAt ? 0n : existing.version : 0n;
+    if (opts.ifVersion !== void 0 && opts.ifVersion !== existingVersion) {
+      throw new VersionMismatchError(key, opts.ifVersion, existingVersion);
+    }
+    if (existing?.timer) clearTimeout(existing.timer);
+    const version = existingVersion + 1n;
+    const expiresAt = opts.ttl && opts.ttl > 0 ? Date.now() + opts.ttl * 1e3 : void 0;
+    const entry = { value, version, expiresAt };
+    if (expiresAt) {
+      entry.timer = setTimeout(() => {
+        const current = this.store.get(key);
+        if (current === entry) this.store.delete(key);
+      }, expiresAt - Date.now());
+    }
+    this.store.set(key, entry);
+    return { key, value, version, expiresAt };
+  }
+  async delete(key, opts = {}) {
+    const e = this.store.get(key);
+    if (!e) return false;
+    if (e.expiresAt && Date.now() >= e.expiresAt) {
+      this.store.delete(key);
+      return false;
+    }
+    if (opts.ifVersion !== void 0 && opts.ifVersion !== e.version) {
+      throw new VersionMismatchError(key, opts.ifVersion, e.version);
+    }
+    if (e.timer) clearTimeout(e.timer);
+    this.store.delete(key);
+    return true;
+  }
+  async cas(key, expectedVersion, next, opts = {}) {
+    try {
+      return await this.set(key, next, { ...opts, ifVersion: expectedVersion });
+    } catch (err) {
+      if (err instanceof VersionMismatchError) return void 0;
+      throw err;
+    }
+  }
+  async close() {
+    this.closed = true;
+    for (const [, e] of this.store) {
+      if (e.timer) clearTimeout(e.timer);
+    }
+    this.store.clear();
+  }
+};
+var VersionMismatchError = class extends Error {
+  constructor(key, expected, actual) {
+    super(
+      `KV version mismatch on "${key}": expected v${expected}, found v${actual}`
+    );
+    this.key = key;
+    this.expected = expected;
+    this.actual = actual;
+    this.name = "VersionMismatchError";
+  }
+};
+
+// src/memory/counter.ts
+var MemoryCounter = class {
+  constructor() {
+    this.counters = /* @__PURE__ */ new Map();
+    this.closed = false;
+  }
+  async incr(key, opts = {}) {
+    if (this.closed) throw new Error("MemoryCounter is closed");
+    const by = BigInt(opts.by ?? 1);
+    const current = this.counters.get(key) ?? 0n;
+    const next = current + by;
+    this.counters.set(key, next);
+    return next;
+  }
+  async peek(key) {
+    return this.counters.get(key) ?? 0n;
+  }
+  async reset(key, value = 0n) {
+    if (this.closed) throw new Error("MemoryCounter is closed");
+    if (value === 0n) this.counters.delete(key);
+    else this.counters.set(key, value);
+  }
+  async close() {
+    this.closed = true;
+    this.counters.clear();
+  }
+};
+
+// src/cluster.ts
+var ComposedClusterService = class {
+  constructor(nodeId, driver, pubsub, lock, kv, counter) {
+    this.nodeId = nodeId;
+    this.driver = driver;
+    this.pubsub = pubsub;
+    this.lock = lock;
+    this.kv = kv;
+    this.counter = counter;
+  }
+  async close() {
+    const closers = [this.counter, this.kv, this.lock, this.pubsub];
+    for (const c of closers) {
+      try {
+        await c.close();
+      } catch (err) {
+        console.error("[ClusterService] close error:", err);
+      }
+    }
+  }
+};
+function defineCluster(config = {}) {
+  const parsed = ClusterCapabilityConfigSchema.parse(config);
+  const nodeId = parsed.nodeId ?? generateNodeId();
+  if (parsed.driver === "memory") {
+    return new ComposedClusterService(
+      nodeId,
+      "memory",
+      new MemoryPubSub({ nodeId }),
+      new MemoryLock({ defaultTtlMs: parsed.lockTtlMs }),
+      new MemoryKV(),
+      new MemoryCounter()
+    );
+  }
+  const factory = driverRegistry.get(parsed.driver);
+  if (!factory) {
+    throw new Error(
+      `Cluster driver "${parsed.driver}" is not registered. Did you forget to import @objectstack/service-cluster-${parsed.driver} or call registerClusterDriver()? See content/docs/concepts/cluster-semantics.mdx \xA76.`
+    );
+  }
+  return factory({ ...parsed, nodeId });
+}
+var driverRegistry = /* @__PURE__ */ new Map();
+function registerClusterDriver(name, factory) {
+  if (name === "memory") {
+    throw new Error('The "memory" driver is reserved.');
+  }
+  driverRegistry.set(name, factory);
+}
+function generateNodeId() {
+  const rand = Math.random().toString(36).slice(2, 10);
+  const ts = Date.now().toString(36);
+  return `node-${ts}-${rand}`;
+}
+
+// src/cluster-service-plugin.ts
+var ClusterServicePlugin = class {
+  constructor(options = {}) {
+    this.name = "com.objectstack.service.cluster";
+    this.version = "1.0.0";
+    this.type = "standard";
+    this.owned = false;
+    this.options = options;
+  }
+  async init(ctx) {
+    if (this.options.cluster) {
+      this.cluster = this.options.cluster;
+      this.owned = false;
+    } else {
+      this.cluster = defineCluster(this.options.config ?? {});
+      this.owned = true;
+    }
+    ctx.registerService("cluster", this.cluster);
+    ctx.logger.info(
+      `ClusterServicePlugin: registered "${this.cluster.driver}" driver (node=${this.cluster.nodeId})`
+    );
+    ctx.hook("kernel:shutdown", async () => {
+      if (this.owned && this.cluster) {
+        try {
+          await this.cluster.close();
+        } catch (err) {
+          ctx.logger.error("ClusterServicePlugin: close error", err);
+        }
+      }
+    });
+  }
+};
+
+// src/metadata-cluster-bridge-plugin.ts
+var MetadataClusterBridgePlugin = class {
+  constructor() {
+    this.name = "com.objectstack.service.metadata-cluster-bridge";
+    this.version = "1.0.0";
+    this.type = "standard";
+  }
+  async init(ctx) {
+    ctx.hook("kernel:ready", async () => {
+      let cluster;
+      let md;
+      try {
+        cluster = ctx.getService("cluster");
+      } catch {
+        ctx.logger.debug(
+          'MetadataClusterBridgePlugin: no "cluster" service registered, skipping'
+        );
+        return;
+      }
+      try {
+        md = ctx.getService("metadata");
+      } catch {
+        ctx.logger.debug(
+          'MetadataClusterBridgePlugin: no "metadata" service registered, skipping'
+        );
+        return;
+      }
+      const attach = md.attachClusterPubSub;
+      if (typeof attach !== "function") {
+        ctx.logger.warn(
+          "MetadataClusterBridgePlugin: metadata service does not expose attachClusterPubSub(); cross-node cache invalidation disabled"
+        );
+        return;
+      }
+      try {
+        this.detach = attach.call(md, cluster.pubsub, cluster.nodeId);
+        ctx.logger.info(
+          `MetadataClusterBridgePlugin: bridged metadata.changed \u2192 cluster.pubsub (node=${cluster.nodeId})`
+        );
+      } catch (err) {
+        ctx.logger.error(
+          "MetadataClusterBridgePlugin: attach failed",
+          err
+        );
+      }
+    });
+    ctx.hook("kernel:shutdown", async () => {
+      try {
+        this.detach?.();
+      } catch (err) {
+        ctx.logger.error(
+          "MetadataClusterBridgePlugin: detach error",
+          err
+        );
+      }
+      this.detach = void 0;
+    });
+  }
+};
+export {
+  ClusterServicePlugin,
+  ComposedClusterService,
+  MemoryCounter,
+  MemoryKV,
+  MemoryLock,
+  MemoryPubSub,
+  MetadataClusterBridgePlugin,
+  VersionMismatchError,
+  defineCluster,
+  registerClusterDriver
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cluster.ts","../src/memory/pubsub.ts","../src/memory/lock.ts","../src/memory/kv.ts","../src/memory/counter.ts","../src/cluster-service-plugin.ts","../src/metadata-cluster-bridge-plugin.ts"],"sourcesContent":["// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n    IClusterService,\n    IPubSub,\n    ILock,\n    IKV,\n    ICounter,\n} from '@objectstack/spec/contracts';\nimport type { ClusterCapabilityConfigInput } from '@objectstack/spec/kernel';\nimport { ClusterCapabilityConfigSchema } from '@objectstack/spec/kernel';\n\nimport { MemoryPubSub } from './memory/pubsub.js';\nimport { MemoryLock } from './memory/lock.js';\nimport { MemoryKV } from './memory/kv.js';\nimport { MemoryCounter } from './memory/counter.js';\n\n/**\n * Compose four cluster primitives into a single `IClusterService` facade.\n * Useful for custom driver authors who want to mix and match.\n */\nexport class ComposedClusterService implements IClusterService {\n    constructor(\n        public readonly nodeId: string,\n        public readonly driver: string,\n        public readonly pubsub: IPubSub,\n        public readonly lock: ILock,\n        public readonly kv: IKV,\n        public readonly counter: ICounter,\n    ) { }\n\n    async close(): Promise<void> {\n        // Reverse order, swallow errors so a slow close doesn't block siblings.\n        const closers = [this.counter, this.kv, this.lock, this.pubsub];\n        for (const c of closers) {\n            try {\n                await c.close();\n            } catch (err) {\n                // eslint-disable-next-line no-console\n                console.error('[ClusterService] close error:', err);\n            }\n        }\n    }\n}\n\n/**\n * Build an `IClusterService` from a `ClusterCapabilityConfig`. The only\n * driver shipped from this package is `memory`; other drivers (postgres,\n * redis, nats) live in dedicated packages and register themselves via\n * `registerClusterDriver()`.\n *\n * @example\n *   const cluster = defineCluster({ driver: 'memory' });\n *   await cluster.pubsub.publish('metadata.changed', { id: 'x' });\n */\nexport function defineCluster(\n    config: ClusterCapabilityConfigInput = {},\n): IClusterService {\n    const parsed = ClusterCapabilityConfigSchema.parse(config);\n    const nodeId = parsed.nodeId ?? generateNodeId();\n\n    if (parsed.driver === 'memory') {\n        return new ComposedClusterService(\n            nodeId,\n            'memory',\n            new MemoryPubSub({ nodeId }),\n            new MemoryLock({ defaultTtlMs: parsed.lockTtlMs }),\n            new MemoryKV(),\n            new MemoryCounter(),\n        );\n    }\n\n    const factory = driverRegistry.get(parsed.driver);\n    if (!factory) {\n        throw new Error(\n            `Cluster driver \"${parsed.driver}\" is not registered. ` +\n                `Did you forget to import @objectstack/service-cluster-${parsed.driver} ` +\n                `or call registerClusterDriver()? ` +\n                `See content/docs/concepts/cluster-semantics.mdx §6.`,\n        );\n    }\n    return factory({ ...parsed, nodeId });\n}\n\n// ---------------------------------------------------------------------------\n// Driver registry (for postgres/redis/nats/custom drivers)\n// ---------------------------------------------------------------------------\n\nexport interface DriverFactoryConfig {\n    driver: string;\n    nodeId: string;\n    url?: string;\n    useExistingPool?: boolean;\n    heartbeatMs?: number;\n    lockTtlMs?: number;\n    tenantIsolation?: string;\n    driverOptions?: Record<string, unknown>;\n}\n\nexport type ClusterDriverFactory = (config: DriverFactoryConfig) => IClusterService;\n\nconst driverRegistry = new Map<string, ClusterDriverFactory>();\n\n/**\n * Register a custom cluster driver. Driver packages (e.g.\n * `@objectstack/service-cluster-postgres`) should call this at module\n * load time so `defineCluster({ driver: 'postgres' })` resolves them.\n */\nexport function registerClusterDriver(\n    name: string,\n    factory: ClusterDriverFactory,\n): void {\n    if (name === 'memory') {\n        throw new Error('The \"memory\" driver is reserved.');\n    }\n    driverRegistry.set(name, factory);\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction generateNodeId(): string {\n    // Avoid the `crypto` import dance for a single use; this is dev-only\n    // randomness and the driver upgrades replace it.\n    const rand = Math.random().toString(36).slice(2, 10);\n    const ts = Date.now().toString(36);\n    return `node-${ts}-${rand}`;\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n    IPubSub,\n    PubSubHandler,\n    PublishOptions,\n    SubscribeOptions,\n    Unsubscribe,\n} from '@objectstack/spec/contracts';\n\n/**\n * In-memory PubSub for single-process deployments and tests.\n *\n * Behavior:\n *   - Synchronous fan-out: every subscriber's handler is invoked in the\n *     same tick that `publish()` resolves. Handler errors are swallowed\n *     and logged via `onError` (so one bad subscriber can't poison the bus).\n *   - At-least-once semantics held vacuously (a single in-process delivery).\n *   - No cross-process delivery — use the redis/postgres/nats driver for\n *     real multi-node setups.\n */\nexport interface MemoryPubSubOptions {\n    /** Optional error sink for handler exceptions. Defaults to console.error. */\n    onError?: (err: unknown, channel: string) => void;\n    /** Optional node id surfaced as `fromNode` on every message. */\n    nodeId?: string;\n}\n\ninterface Subscription {\n    channel: string;\n    handler: PubSubHandler<unknown>;\n}\n\nexport class MemoryPubSub implements IPubSub {\n    private readonly subs = new Map<string, Set<Subscription>>();\n    private readonly onError: (err: unknown, channel: string) => void;\n    private readonly nodeId?: string;\n    private closed = false;\n\n    constructor(opts: MemoryPubSubOptions = {}) {\n        this.onError =\n            opts.onError ??\n            ((err, channel) => {\n                // eslint-disable-next-line no-console\n                console.error(`[MemoryPubSub] handler error on channel \"${channel}\":`, err);\n            });\n        this.nodeId = opts.nodeId;\n    }\n\n    async publish<T = unknown>(\n        channel: string,\n        payload: T,\n        _opts?: PublishOptions,\n    ): Promise<void> {\n        if (this.closed) throw new Error('MemoryPubSub is closed');\n        const bucket = this.subs.get(channel);\n        if (!bucket || bucket.size === 0) return;\n        const publishedAt = Date.now();\n        // Snapshot so handler-driven unsubscribes during dispatch are safe.\n        const snapshot = Array.from(bucket);\n        for (const sub of snapshot) {\n            try {\n                const result = sub.handler({\n                    channel,\n                    payload,\n                    publishedAt,\n                    fromNode: this.nodeId,\n                });\n                if (result && typeof (result as Promise<void>).then === 'function') {\n                    (result as Promise<void>).catch((err) => this.onError(err, channel));\n                }\n            } catch (err) {\n                this.onError(err, channel);\n            }\n        }\n    }\n\n    subscribe<T = unknown>(\n        channel: string,\n        handler: PubSubHandler<T>,\n        _opts?: SubscribeOptions,\n    ): Unsubscribe {\n        if (this.closed) throw new Error('MemoryPubSub is closed');\n        let bucket = this.subs.get(channel);\n        if (!bucket) {\n            bucket = new Set();\n            this.subs.set(channel, bucket);\n        }\n        const sub: Subscription = { channel, handler: handler as PubSubHandler<unknown> };\n        bucket.add(sub);\n        let disposed = false;\n        return () => {\n            if (disposed) return;\n            disposed = true;\n            const b = this.subs.get(channel);\n            if (!b) return;\n            b.delete(sub);\n            if (b.size === 0) this.subs.delete(channel);\n        };\n    }\n\n    async close(): Promise<void> {\n        this.closed = true;\n        this.subs.clear();\n    }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n    ILock,\n    LockAcquireOptions,\n    LockHandle,\n} from '@objectstack/spec/contracts';\n\n/**\n * In-memory lock for single-process deployments and tests.\n *\n * Behavior:\n *   - Per-key FIFO wait queue (so `waitMs > 0` callers receive the lock\n *     in arrival order).\n *   - TTL is honored: if a holder doesn't renew before `ttlMs` elapses,\n *     the lock is auto-released and the next waiter wakes.\n *   - Fencing tokens are process-local monotonic bigints.\n */\n\nconst DEFAULT_TTL_MS = 15_000;\n\nexport interface MemoryLockOptions {\n    /** Default TTL for `acquire` when caller doesn't supply one. */\n    defaultTtlMs?: number;\n}\n\ninterface Holder {\n    fencingToken: bigint;\n    expiresAt: number;\n    released: boolean;\n    timer?: NodeJS.Timeout;\n}\n\ninterface Waiter {\n    resolve: (h: LockHandle | null) => void;\n    deadline: number;\n    opts: LockAcquireOptions;\n    timer?: NodeJS.Timeout;\n}\n\nexport class MemoryLock implements ILock {\n    private readonly holders = new Map<string, Holder>();\n    private readonly queues = new Map<string, Waiter[]>();\n    private readonly defaultTtlMs: number;\n    private fenceSeq = 0n;\n    private closed = false;\n\n    constructor(opts: MemoryLockOptions = {}) {\n        this.defaultTtlMs = opts.defaultTtlMs ?? DEFAULT_TTL_MS;\n    }\n\n    async acquire(key: string, opts: LockAcquireOptions = {}): Promise<LockHandle | null> {\n        if (this.closed) throw new Error('MemoryLock is closed');\n        const ttlMs = opts.ttlMs ?? this.defaultTtlMs;\n        const waitMs = opts.waitMs ?? 0;\n\n        if (!this.holders.has(key)) {\n            return this.grant(key, ttlMs);\n        }\n        if (waitMs <= 0) return null;\n\n        return new Promise<LockHandle | null>((resolve) => {\n            const deadline = Date.now() + waitMs;\n            const waiter: Waiter = { resolve, deadline, opts };\n            const queue = this.queues.get(key) ?? [];\n            queue.push(waiter);\n            this.queues.set(key, queue);\n            waiter.timer = setTimeout(() => {\n                const q = this.queues.get(key);\n                if (q) {\n                    const idx = q.indexOf(waiter);\n                    if (idx >= 0) q.splice(idx, 1);\n                }\n                resolve(null);\n            }, waitMs);\n        });\n    }\n\n    async withLock<T>(\n        key: string,\n        fn: (h: LockHandle) => Promise<T>,\n        opts?: LockAcquireOptions,\n    ): Promise<T | null> {\n        const handle = await this.acquire(key, opts);\n        if (!handle) return null;\n        try {\n            return await fn(handle);\n        } finally {\n            await handle.release();\n        }\n    }\n\n    async close(): Promise<void> {\n        this.closed = true;\n        for (const [, holder] of this.holders) {\n            if (holder.timer) clearTimeout(holder.timer);\n            holder.released = true;\n        }\n        this.holders.clear();\n        for (const [, q] of this.queues) {\n            for (const w of q) {\n                if (w.timer) clearTimeout(w.timer);\n                w.resolve(null);\n            }\n        }\n        this.queues.clear();\n    }\n\n    private grant(key: string, ttlMs: number): LockHandle {\n        const fencingToken = ++this.fenceSeq;\n        const holder: Holder = {\n            fencingToken,\n            expiresAt: Date.now() + ttlMs,\n            released: false,\n        };\n        holder.timer = setTimeout(() => this.expire(key, holder), ttlMs);\n        this.holders.set(key, holder);\n\n        const self = this;\n        const handle: LockHandle = {\n            key,\n            fencingToken,\n            isHeld: () => !holder.released && self.holders.get(key) === holder,\n            async renew(extendMs?: number) {\n                if (holder.released || self.holders.get(key) !== holder) {\n                    throw new Error(`Lock \"${key}\" no longer held (fence=${fencingToken})`);\n                }\n                const next = extendMs ?? ttlMs;\n                holder.expiresAt = Date.now() + next;\n                if (holder.timer) clearTimeout(holder.timer);\n                holder.timer = setTimeout(() => self.expire(key, holder), next);\n            },\n            async release() {\n                if (holder.released || self.holders.get(key) !== holder) return;\n                holder.released = true;\n                if (holder.timer) clearTimeout(holder.timer);\n                self.holders.delete(key);\n                self.handoff(key);\n            },\n        };\n        return handle;\n    }\n\n    private expire(key: string, holder: Holder): void {\n        if (holder.released) return;\n        if (this.holders.get(key) !== holder) return;\n        holder.released = true;\n        this.holders.delete(key);\n        this.handoff(key);\n    }\n\n    private handoff(key: string): void {\n        const queue = this.queues.get(key);\n        if (!queue || queue.length === 0) return;\n        const next = queue.shift()!;\n        if (next.timer) clearTimeout(next.timer);\n        if (Date.now() > next.deadline) {\n            next.resolve(null);\n            this.handoff(key);\n            return;\n        }\n        const ttlMs = next.opts.ttlMs ?? this.defaultTtlMs;\n        next.resolve(this.grant(key, ttlMs));\n        if (queue.length === 0) this.queues.delete(key);\n    }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IKV, KVEntry, KVSetOptions } from '@objectstack/spec/contracts';\n\ninterface Entry<T = unknown> {\n    value: T;\n    version: bigint;\n    expiresAt?: number;\n    timer?: NodeJS.Timeout;\n}\n\n/**\n * In-memory coordination KV. Supports optimistic concurrency via\n * `ifVersion` and TTL via `ttl` (seconds).\n *\n * NOT a cache, NOT a database — intended for small cluster bookkeeping.\n */\nexport class MemoryKV implements IKV {\n    private readonly store = new Map<string, Entry>();\n    private closed = false;\n\n    async get<T = unknown>(key: string): Promise<KVEntry<T> | undefined> {\n        const e = this.store.get(key);\n        if (!e) return undefined;\n        if (e.expiresAt && Date.now() >= e.expiresAt) {\n            this.store.delete(key);\n            return undefined;\n        }\n        return {\n            key,\n            value: e.value as T,\n            version: e.version,\n            expiresAt: e.expiresAt,\n        };\n    }\n\n    async set<T = unknown>(\n        key: string,\n        value: T,\n        opts: KVSetOptions = {},\n    ): Promise<KVEntry<T>> {\n        if (this.closed) throw new Error('MemoryKV is closed');\n        const existing = this.store.get(key);\n        const existingVersion = existing\n            ? existing.expiresAt && Date.now() >= existing.expiresAt\n                ? 0n\n                : existing.version\n            : 0n;\n        if (opts.ifVersion !== undefined && opts.ifVersion !== existingVersion) {\n            throw new VersionMismatchError(key, opts.ifVersion, existingVersion);\n        }\n        if (existing?.timer) clearTimeout(existing.timer);\n        const version = existingVersion + 1n;\n        const expiresAt = opts.ttl && opts.ttl > 0 ? Date.now() + opts.ttl * 1000 : undefined;\n        const entry: Entry<T> = { value, version, expiresAt };\n        if (expiresAt) {\n            entry.timer = setTimeout(() => {\n                const current = this.store.get(key);\n                if (current === (entry as Entry<unknown>)) this.store.delete(key);\n            }, expiresAt - Date.now());\n        }\n        this.store.set(key, entry as Entry<unknown>);\n        return { key, value, version, expiresAt };\n    }\n\n    async delete(key: string, opts: { ifVersion?: bigint } = {}): Promise<boolean> {\n        const e = this.store.get(key);\n        if (!e) return false;\n        if (e.expiresAt && Date.now() >= e.expiresAt) {\n            this.store.delete(key);\n            return false;\n        }\n        if (opts.ifVersion !== undefined && opts.ifVersion !== e.version) {\n            throw new VersionMismatchError(key, opts.ifVersion, e.version);\n        }\n        if (e.timer) clearTimeout(e.timer);\n        this.store.delete(key);\n        return true;\n    }\n\n    async cas<T = unknown>(\n        key: string,\n        expectedVersion: bigint,\n        next: T,\n        opts: Omit<KVSetOptions, 'ifVersion'> = {},\n    ): Promise<KVEntry<T> | undefined> {\n        try {\n            return await this.set(key, next, { ...opts, ifVersion: expectedVersion });\n        } catch (err) {\n            if (err instanceof VersionMismatchError) return undefined;\n            throw err;\n        }\n    }\n\n    async close(): Promise<void> {\n        this.closed = true;\n        for (const [, e] of this.store) {\n            if (e.timer) clearTimeout(e.timer);\n        }\n        this.store.clear();\n    }\n}\n\nexport class VersionMismatchError extends Error {\n    constructor(\n        public readonly key: string,\n        public readonly expected: bigint,\n        public readonly actual: bigint,\n    ) {\n        super(\n            `KV version mismatch on \"${key}\": expected v${expected}, found v${actual}`,\n        );\n        this.name = 'VersionMismatchError';\n    }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { ICounter, CounterIncrOptions } from '@objectstack/spec/contracts';\n\n/**\n * In-memory monotonic counter. Single-process only — for cross-node id\n * allocation, use the postgres or redis driver.\n */\nexport class MemoryCounter implements ICounter {\n    private readonly counters = new Map<string, bigint>();\n    private closed = false;\n\n    async incr(key: string, opts: CounterIncrOptions = {}): Promise<bigint> {\n        if (this.closed) throw new Error('MemoryCounter is closed');\n        const by = BigInt(opts.by ?? 1);\n        const current = this.counters.get(key) ?? 0n;\n        const next = current + by;\n        this.counters.set(key, next);\n        return next;\n    }\n\n    async peek(key: string): Promise<bigint> {\n        return this.counters.get(key) ?? 0n;\n    }\n\n    async reset(key: string, value: bigint = 0n): Promise<void> {\n        if (this.closed) throw new Error('MemoryCounter is closed');\n        if (value === 0n) this.counters.delete(key);\n        else this.counters.set(key, value);\n    }\n\n    async close(): Promise<void> {\n        this.closed = true;\n        this.counters.clear();\n    }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IClusterService } from '@objectstack/spec/contracts';\nimport type { ClusterCapabilityConfigInput } from '@objectstack/spec/kernel';\nimport { defineCluster } from './cluster.js';\n\n/**\n * Options for `ClusterServicePlugin`.\n *\n * Pass either a pre-built `cluster` instance (advanced — for tests or\n * custom drivers), or a `config` object that will be passed to\n * `defineCluster()`. If both are omitted, a memory-driver cluster is\n * created with auto-generated nodeId.\n */\nexport interface ClusterServicePluginOptions {\n    /** Pre-built cluster service. Wins over `config` when both provided. */\n    cluster?: IClusterService;\n    /** Config forwarded to `defineCluster()` when `cluster` is absent. */\n    config?: ClusterCapabilityConfigInput;\n}\n\n/**\n * Registers an `IClusterService` under the well-known service name\n * `'cluster'`. Plugins consume it via:\n *\n * ```ts\n * import type { IClusterService } from '@objectstack/spec/contracts';\n * const cluster = ctx.getService<IClusterService>('cluster');\n * await cluster.pubsub.publish('metadata.changed', payload);\n * ```\n *\n * The plugin closes the cluster on kernel shutdown.\n *\n * @example default memory driver\n *   kernel.use(new ClusterServicePlugin());\n *\n * @example explicit config\n *   kernel.use(new ClusterServicePlugin({ config: { driver: 'memory', nodeId: 'web-1' } }));\n */\nexport class ClusterServicePlugin implements Plugin {\n    name = 'com.objectstack.service.cluster';\n    version = '1.0.0';\n    type = 'standard';\n\n    private readonly options: ClusterServicePluginOptions;\n    private cluster?: IClusterService;\n    private owned = false;\n\n    constructor(options: ClusterServicePluginOptions = {}) {\n        this.options = options;\n    }\n\n    async init(ctx: PluginContext): Promise<void> {\n        if (this.options.cluster) {\n            this.cluster = this.options.cluster;\n            this.owned = false;\n        } else {\n            this.cluster = defineCluster(this.options.config ?? {});\n            this.owned = true;\n        }\n        ctx.registerService('cluster', this.cluster);\n        ctx.logger.info(\n            `ClusterServicePlugin: registered \"${this.cluster.driver}\" driver (node=${this.cluster.nodeId})`,\n        );\n\n        ctx.hook('kernel:shutdown', async () => {\n            if (this.owned && this.cluster) {\n                try {\n                    await this.cluster.close();\n                } catch (err) {\n                    ctx.logger.error('ClusterServicePlugin: close error', err as Error);\n                }\n            }\n        });\n    }\n}\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IClusterService } from '@objectstack/spec/contracts';\n\n/**\n * Bridges the cluster pub/sub bus to the metadata service so that\n * metadata mutations on one node invalidate registry caches on peer\n * nodes. Implements the \"first real consumer\" of the cluster API.\n *\n * Implementation detail: this plugin lives in `@objectstack/service-cluster`\n * (not in `@objectstack/metadata`) to avoid forcing every metadata\n * consumer to pull the cluster service. The metadata package only needs\n * the `IPubSub` interface, which lives in `@objectstack/spec/contracts`.\n *\n * Activates only when both services are present and the metadata service\n * exposes `attachClusterPubSub()`. Late binding is achieved via the\n * `kernel:ready` lifecycle hook.\n *\n * Channel: `metadata.changed` — payload shape defined by\n * `ClusterMetadataChangedPayload` in `@objectstack/metadata`.\n *\n * See `content/docs/concepts/cluster-semantics.mdx` §5.\n */\nexport class MetadataClusterBridgePlugin implements Plugin {\n    name = 'com.objectstack.service.metadata-cluster-bridge';\n    version = '1.0.0';\n    type = 'standard';\n\n    private detach?: () => void;\n\n    async init(ctx: PluginContext): Promise<void> {\n        ctx.hook('kernel:ready', async () => {\n            let cluster: IClusterService | undefined;\n            let md: unknown;\n            try {\n                cluster = ctx.getService<IClusterService>('cluster');\n            } catch {\n                ctx.logger.debug(\n                    'MetadataClusterBridgePlugin: no \"cluster\" service registered, skipping',\n                );\n                return;\n            }\n            try {\n                md = ctx.getService<unknown>('metadata');\n            } catch {\n                ctx.logger.debug(\n                    'MetadataClusterBridgePlugin: no \"metadata\" service registered, skipping',\n                );\n                return;\n            }\n\n            const attach = (md as { attachClusterPubSub?: unknown })\n                .attachClusterPubSub;\n            if (typeof attach !== 'function') {\n                ctx.logger.warn(\n                    'MetadataClusterBridgePlugin: metadata service does not expose attachClusterPubSub(); cross-node cache invalidation disabled',\n                );\n                return;\n            }\n\n            try {\n                this.detach = (attach as (\n                    pubsub: IClusterService['pubsub'],\n                    nodeId: string,\n                ) => () => void).call(md, cluster.pubsub, cluster.nodeId);\n                ctx.logger.info(\n                    `MetadataClusterBridgePlugin: bridged metadata.changed → cluster.pubsub (node=${cluster.nodeId})`,\n                );\n            } catch (err) {\n                ctx.logger.error(\n                    'MetadataClusterBridgePlugin: attach failed',\n                    err as Error,\n                );\n            }\n        });\n\n        ctx.hook('kernel:shutdown', async () => {\n            try {\n                this.detach?.();\n            } catch (err) {\n                ctx.logger.error(\n                    'MetadataClusterBridgePlugin: detach error',\n                    err as Error,\n                );\n            }\n            this.detach = undefined;\n        });\n    }\n}\n"],"mappings":";AAUA,SAAS,qCAAqC;;;ACuBvC,IAAM,eAAN,MAAsC;AAAA,EAMzC,YAAY,OAA4B,CAAC,GAAG;AAL5C,SAAiB,OAAO,oBAAI,IAA+B;AAG3D,SAAQ,SAAS;AAGb,SAAK,UACD,KAAK,YACJ,CAAC,KAAK,YAAY;AAEf,cAAQ,MAAM,4CAA4C,OAAO,MAAM,GAAG;AAAA,IAC9E;AACJ,SAAK,SAAS,KAAK;AAAA,EACvB;AAAA,EAEA,MAAM,QACF,SACA,SACA,OACa;AACb,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,wBAAwB;AACzD,UAAM,SAAS,KAAK,KAAK,IAAI,OAAO;AACpC,QAAI,CAAC,UAAU,OAAO,SAAS,EAAG;AAClC,UAAM,cAAc,KAAK,IAAI;AAE7B,UAAM,WAAW,MAAM,KAAK,MAAM;AAClC,eAAW,OAAO,UAAU;AACxB,UAAI;AACA,cAAM,SAAS,IAAI,QAAQ;AAAA,UACvB;AAAA,UACA;AAAA,UACA;AAAA,UACA,UAAU,KAAK;AAAA,QACnB,CAAC;AACD,YAAI,UAAU,OAAQ,OAAyB,SAAS,YAAY;AAChE,UAAC,OAAyB,MAAM,CAAC,QAAQ,KAAK,QAAQ,KAAK,OAAO,CAAC;AAAA,QACvE;AAAA,MACJ,SAAS,KAAK;AACV,aAAK,QAAQ,KAAK,OAAO;AAAA,MAC7B;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,UACI,SACA,SACA,OACW;AACX,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,wBAAwB;AACzD,QAAI,SAAS,KAAK,KAAK,IAAI,OAAO;AAClC,QAAI,CAAC,QAAQ;AACT,eAAS,oBAAI,IAAI;AACjB,WAAK,KAAK,IAAI,SAAS,MAAM;AAAA,IACjC;AACA,UAAM,MAAoB,EAAE,SAAS,QAA2C;AAChF,WAAO,IAAI,GAAG;AACd,QAAI,WAAW;AACf,WAAO,MAAM;AACT,UAAI,SAAU;AACd,iBAAW;AACX,YAAM,IAAI,KAAK,KAAK,IAAI,OAAO;AAC/B,UAAI,CAAC,EAAG;AACR,QAAE,OAAO,GAAG;AACZ,UAAI,EAAE,SAAS,EAAG,MAAK,KAAK,OAAO,OAAO;AAAA,IAC9C;AAAA,EACJ;AAAA,EAEA,MAAM,QAAuB;AACzB,SAAK,SAAS;AACd,SAAK,KAAK,MAAM;AAAA,EACpB;AACJ;;;ACtFA,IAAM,iBAAiB;AAqBhB,IAAM,aAAN,MAAkC;AAAA,EAOrC,YAAY,OAA0B,CAAC,GAAG;AAN1C,SAAiB,UAAU,oBAAI,IAAoB;AACnD,SAAiB,SAAS,oBAAI,IAAsB;AAEpD,SAAQ,WAAW;AACnB,SAAQ,SAAS;AAGb,SAAK,eAAe,KAAK,gBAAgB;AAAA,EAC7C;AAAA,EAEA,MAAM,QAAQ,KAAa,OAA2B,CAAC,GAA+B;AAClF,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,sBAAsB;AACvD,UAAM,QAAQ,KAAK,SAAS,KAAK;AACjC,UAAM,SAAS,KAAK,UAAU;AAE9B,QAAI,CAAC,KAAK,QAAQ,IAAI,GAAG,GAAG;AACxB,aAAO,KAAK,MAAM,KAAK,KAAK;AAAA,IAChC;AACA,QAAI,UAAU,EAAG,QAAO;AAExB,WAAO,IAAI,QAA2B,CAAC,YAAY;AAC/C,YAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,YAAM,SAAiB,EAAE,SAAS,UAAU,KAAK;AACjD,YAAM,QAAQ,KAAK,OAAO,IAAI,GAAG,KAAK,CAAC;AACvC,YAAM,KAAK,MAAM;AACjB,WAAK,OAAO,IAAI,KAAK,KAAK;AAC1B,aAAO,QAAQ,WAAW,MAAM;AAC5B,cAAM,IAAI,KAAK,OAAO,IAAI,GAAG;AAC7B,YAAI,GAAG;AACH,gBAAM,MAAM,EAAE,QAAQ,MAAM;AAC5B,cAAI,OAAO,EAAG,GAAE,OAAO,KAAK,CAAC;AAAA,QACjC;AACA,gBAAQ,IAAI;AAAA,MAChB,GAAG,MAAM;AAAA,IACb,CAAC;AAAA,EACL;AAAA,EAEA,MAAM,SACF,KACA,IACA,MACiB;AACjB,UAAM,SAAS,MAAM,KAAK,QAAQ,KAAK,IAAI;AAC3C,QAAI,CAAC,OAAQ,QAAO;AACpB,QAAI;AACA,aAAO,MAAM,GAAG,MAAM;AAAA,IAC1B,UAAE;AACE,YAAM,OAAO,QAAQ;AAAA,IACzB;AAAA,EACJ;AAAA,EAEA,MAAM,QAAuB;AACzB,SAAK,SAAS;AACd,eAAW,CAAC,EAAE,MAAM,KAAK,KAAK,SAAS;AACnC,UAAI,OAAO,MAAO,cAAa,OAAO,KAAK;AAC3C,aAAO,WAAW;AAAA,IACtB;AACA,SAAK,QAAQ,MAAM;AACnB,eAAW,CAAC,EAAE,CAAC,KAAK,KAAK,QAAQ;AAC7B,iBAAW,KAAK,GAAG;AACf,YAAI,EAAE,MAAO,cAAa,EAAE,KAAK;AACjC,UAAE,QAAQ,IAAI;AAAA,MAClB;AAAA,IACJ;AACA,SAAK,OAAO,MAAM;AAAA,EACtB;AAAA,EAEQ,MAAM,KAAa,OAA2B;AAClD,UAAM,eAAe,EAAE,KAAK;AAC5B,UAAM,SAAiB;AAAA,MACnB;AAAA,MACA,WAAW,KAAK,IAAI,IAAI;AAAA,MACxB,UAAU;AAAA,IACd;AACA,WAAO,QAAQ,WAAW,MAAM,KAAK,OAAO,KAAK,MAAM,GAAG,KAAK;AAC/D,SAAK,QAAQ,IAAI,KAAK,MAAM;AAE5B,UAAM,OAAO;AACb,UAAM,SAAqB;AAAA,MACvB;AAAA,MACA;AAAA,MACA,QAAQ,MAAM,CAAC,OAAO,YAAY,KAAK,QAAQ,IAAI,GAAG,MAAM;AAAA,MAC5D,MAAM,MAAM,UAAmB;AAC3B,YAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,GAAG,MAAM,QAAQ;AACrD,gBAAM,IAAI,MAAM,SAAS,GAAG,2BAA2B,YAAY,GAAG;AAAA,QAC1E;AACA,cAAM,OAAO,YAAY;AACzB,eAAO,YAAY,KAAK,IAAI,IAAI;AAChC,YAAI,OAAO,MAAO,cAAa,OAAO,KAAK;AAC3C,eAAO,QAAQ,WAAW,MAAM,KAAK,OAAO,KAAK,MAAM,GAAG,IAAI;AAAA,MAClE;AAAA,MACA,MAAM,UAAU;AACZ,YAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,GAAG,MAAM,OAAQ;AACzD,eAAO,WAAW;AAClB,YAAI,OAAO,MAAO,cAAa,OAAO,KAAK;AAC3C,aAAK,QAAQ,OAAO,GAAG;AACvB,aAAK,QAAQ,GAAG;AAAA,MACpB;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA,EAEQ,OAAO,KAAa,QAAsB;AAC9C,QAAI,OAAO,SAAU;AACrB,QAAI,KAAK,QAAQ,IAAI,GAAG,MAAM,OAAQ;AACtC,WAAO,WAAW;AAClB,SAAK,QAAQ,OAAO,GAAG;AACvB,SAAK,QAAQ,GAAG;AAAA,EACpB;AAAA,EAEQ,QAAQ,KAAmB;AAC/B,UAAM,QAAQ,KAAK,OAAO,IAAI,GAAG;AACjC,QAAI,CAAC,SAAS,MAAM,WAAW,EAAG;AAClC,UAAM,OAAO,MAAM,MAAM;AACzB,QAAI,KAAK,MAAO,cAAa,KAAK,KAAK;AACvC,QAAI,KAAK,IAAI,IAAI,KAAK,UAAU;AAC5B,WAAK,QAAQ,IAAI;AACjB,WAAK,QAAQ,GAAG;AAChB;AAAA,IACJ;AACA,UAAM,QAAQ,KAAK,KAAK,SAAS,KAAK;AACtC,SAAK,QAAQ,KAAK,MAAM,KAAK,KAAK,CAAC;AACnC,QAAI,MAAM,WAAW,EAAG,MAAK,OAAO,OAAO,GAAG;AAAA,EAClD;AACJ;;;ACpJO,IAAM,WAAN,MAA8B;AAAA,EAA9B;AACH,SAAiB,QAAQ,oBAAI,IAAmB;AAChD,SAAQ,SAAS;AAAA;AAAA,EAEjB,MAAM,IAAiB,KAA8C;AACjE,UAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAC5B,QAAI,CAAC,EAAG,QAAO;AACf,QAAI,EAAE,aAAa,KAAK,IAAI,KAAK,EAAE,WAAW;AAC1C,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACX;AACA,WAAO;AAAA,MACH;AAAA,MACA,OAAO,EAAE;AAAA,MACT,SAAS,EAAE;AAAA,MACX,WAAW,EAAE;AAAA,IACjB;AAAA,EACJ;AAAA,EAEA,MAAM,IACF,KACA,OACA,OAAqB,CAAC,GACH;AACnB,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,oBAAoB;AACrD,UAAM,WAAW,KAAK,MAAM,IAAI,GAAG;AACnC,UAAM,kBAAkB,WAClB,SAAS,aAAa,KAAK,IAAI,KAAK,SAAS,YACzC,KACA,SAAS,UACb;AACN,QAAI,KAAK,cAAc,UAAa,KAAK,cAAc,iBAAiB;AACpE,YAAM,IAAI,qBAAqB,KAAK,KAAK,WAAW,eAAe;AAAA,IACvE;AACA,QAAI,UAAU,MAAO,cAAa,SAAS,KAAK;AAChD,UAAM,UAAU,kBAAkB;AAClC,UAAM,YAAY,KAAK,OAAO,KAAK,MAAM,IAAI,KAAK,IAAI,IAAI,KAAK,MAAM,MAAO;AAC5E,UAAM,QAAkB,EAAE,OAAO,SAAS,UAAU;AACpD,QAAI,WAAW;AACX,YAAM,QAAQ,WAAW,MAAM;AAC3B,cAAM,UAAU,KAAK,MAAM,IAAI,GAAG;AAClC,YAAI,YAAa,MAA0B,MAAK,MAAM,OAAO,GAAG;AAAA,MACpE,GAAG,YAAY,KAAK,IAAI,CAAC;AAAA,IAC7B;AACA,SAAK,MAAM,IAAI,KAAK,KAAuB;AAC3C,WAAO,EAAE,KAAK,OAAO,SAAS,UAAU;AAAA,EAC5C;AAAA,EAEA,MAAM,OAAO,KAAa,OAA+B,CAAC,GAAqB;AAC3E,UAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAC5B,QAAI,CAAC,EAAG,QAAO;AACf,QAAI,EAAE,aAAa,KAAK,IAAI,KAAK,EAAE,WAAW;AAC1C,WAAK,MAAM,OAAO,GAAG;AACrB,aAAO;AAAA,IACX;AACA,QAAI,KAAK,cAAc,UAAa,KAAK,cAAc,EAAE,SAAS;AAC9D,YAAM,IAAI,qBAAqB,KAAK,KAAK,WAAW,EAAE,OAAO;AAAA,IACjE;AACA,QAAI,EAAE,MAAO,cAAa,EAAE,KAAK;AACjC,SAAK,MAAM,OAAO,GAAG;AACrB,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,IACF,KACA,iBACA,MACA,OAAwC,CAAC,GACV;AAC/B,QAAI;AACA,aAAO,MAAM,KAAK,IAAI,KAAK,MAAM,EAAE,GAAG,MAAM,WAAW,gBAAgB,CAAC;AAAA,IAC5E,SAAS,KAAK;AACV,UAAI,eAAe,qBAAsB,QAAO;AAChD,YAAM;AAAA,IACV;AAAA,EACJ;AAAA,EAEA,MAAM,QAAuB;AACzB,SAAK,SAAS;AACd,eAAW,CAAC,EAAE,CAAC,KAAK,KAAK,OAAO;AAC5B,UAAI,EAAE,MAAO,cAAa,EAAE,KAAK;AAAA,IACrC;AACA,SAAK,MAAM,MAAM;AAAA,EACrB;AACJ;AAEO,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAC5C,YACoB,KACA,UACA,QAClB;AACE;AAAA,MACI,2BAA2B,GAAG,gBAAgB,QAAQ,YAAY,MAAM;AAAA,IAC5E;AANgB;AACA;AACA;AAKhB,SAAK,OAAO;AAAA,EAChB;AACJ;;;AC1GO,IAAM,gBAAN,MAAwC;AAAA,EAAxC;AACH,SAAiB,WAAW,oBAAI,IAAoB;AACpD,SAAQ,SAAS;AAAA;AAAA,EAEjB,MAAM,KAAK,KAAa,OAA2B,CAAC,GAAoB;AACpE,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,yBAAyB;AAC1D,UAAM,KAAK,OAAO,KAAK,MAAM,CAAC;AAC9B,UAAM,UAAU,KAAK,SAAS,IAAI,GAAG,KAAK;AAC1C,UAAM,OAAO,UAAU;AACvB,SAAK,SAAS,IAAI,KAAK,IAAI;AAC3B,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,KAAK,KAA8B;AACrC,WAAO,KAAK,SAAS,IAAI,GAAG,KAAK;AAAA,EACrC;AAAA,EAEA,MAAM,MAAM,KAAa,QAAgB,IAAmB;AACxD,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,yBAAyB;AAC1D,QAAI,UAAU,GAAI,MAAK,SAAS,OAAO,GAAG;AAAA,QACrC,MAAK,SAAS,IAAI,KAAK,KAAK;AAAA,EACrC;AAAA,EAEA,MAAM,QAAuB;AACzB,SAAK,SAAS;AACd,SAAK,SAAS,MAAM;AAAA,EACxB;AACJ;;;AJdO,IAAM,yBAAN,MAAwD;AAAA,EAC3D,YACoB,QACA,QACA,QACA,MACA,IACA,SAClB;AANkB;AACA;AACA;AACA;AACA;AACA;AAAA,EAChB;AAAA,EAEJ,MAAM,QAAuB;AAEzB,UAAM,UAAU,CAAC,KAAK,SAAS,KAAK,IAAI,KAAK,MAAM,KAAK,MAAM;AAC9D,eAAW,KAAK,SAAS;AACrB,UAAI;AACA,cAAM,EAAE,MAAM;AAAA,MAClB,SAAS,KAAK;AAEV,gBAAQ,MAAM,iCAAiC,GAAG;AAAA,MACtD;AAAA,IACJ;AAAA,EACJ;AACJ;AAYO,SAAS,cACZ,SAAuC,CAAC,GACzB;AACf,QAAM,SAAS,8BAA8B,MAAM,MAAM;AACzD,QAAM,SAAS,OAAO,UAAU,eAAe;AAE/C,MAAI,OAAO,WAAW,UAAU;AAC5B,WAAO,IAAI;AAAA,MACP;AAAA,MACA;AAAA,MACA,IAAI,aAAa,EAAE,OAAO,CAAC;AAAA,MAC3B,IAAI,WAAW,EAAE,cAAc,OAAO,UAAU,CAAC;AAAA,MACjD,IAAI,SAAS;AAAA,MACb,IAAI,cAAc;AAAA,IACtB;AAAA,EACJ;AAEA,QAAM,UAAU,eAAe,IAAI,OAAO,MAAM;AAChD,MAAI,CAAC,SAAS;AACV,UAAM,IAAI;AAAA,MACN,mBAAmB,OAAO,MAAM,8EAC6B,OAAO,MAAM;AAAA,IAG9E;AAAA,EACJ;AACA,SAAO,QAAQ,EAAE,GAAG,QAAQ,OAAO,CAAC;AACxC;AAmBA,IAAM,iBAAiB,oBAAI,IAAkC;AAOtD,SAAS,sBACZ,MACA,SACI;AACJ,MAAI,SAAS,UAAU;AACnB,UAAM,IAAI,MAAM,kCAAkC;AAAA,EACtD;AACA,iBAAe,IAAI,MAAM,OAAO;AACpC;AAMA,SAAS,iBAAyB;AAG9B,QAAM,OAAO,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE;AACnD,QAAM,KAAK,KAAK,IAAI,EAAE,SAAS,EAAE;AACjC,SAAO,QAAQ,EAAE,IAAI,IAAI;AAC7B;;;AKxFO,IAAM,uBAAN,MAA6C;AAAA,EAShD,YAAY,UAAuC,CAAC,GAAG;AARvD,gBAAO;AACP,mBAAU;AACV,gBAAO;AAIP,SAAQ,QAAQ;AAGZ,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,MAAM,KAAK,KAAmC;AAC1C,QAAI,KAAK,QAAQ,SAAS;AACtB,WAAK,UAAU,KAAK,QAAQ;AAC5B,WAAK,QAAQ;AAAA,IACjB,OAAO;AACH,WAAK,UAAU,cAAc,KAAK,QAAQ,UAAU,CAAC,CAAC;AACtD,WAAK,QAAQ;AAAA,IACjB;AACA,QAAI,gBAAgB,WAAW,KAAK,OAAO;AAC3C,QAAI,OAAO;AAAA,MACP,qCAAqC,KAAK,QAAQ,MAAM,kBAAkB,KAAK,QAAQ,MAAM;AAAA,IACjG;AAEA,QAAI,KAAK,mBAAmB,YAAY;AACpC,UAAI,KAAK,SAAS,KAAK,SAAS;AAC5B,YAAI;AACA,gBAAM,KAAK,QAAQ,MAAM;AAAA,QAC7B,SAAS,KAAK;AACV,cAAI,OAAO,MAAM,qCAAqC,GAAY;AAAA,QACtE;AAAA,MACJ;AAAA,IACJ,CAAC;AAAA,EACL;AACJ;;;ACpDO,IAAM,8BAAN,MAAoD;AAAA,EAApD;AACH,gBAAO;AACP,mBAAU;AACV,gBAAO;AAAA;AAAA,EAIP,MAAM,KAAK,KAAmC;AAC1C,QAAI,KAAK,gBAAgB,YAAY;AACjC,UAAI;AACJ,UAAI;AACJ,UAAI;AACA,kBAAU,IAAI,WAA4B,SAAS;AAAA,MACvD,QAAQ;AACJ,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AACA;AAAA,MACJ;AACA,UAAI;AACA,aAAK,IAAI,WAAoB,UAAU;AAAA,MAC3C,QAAQ;AACJ,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AACA;AAAA,MACJ;AAEA,YAAM,SAAU,GACX;AACL,UAAI,OAAO,WAAW,YAAY;AAC9B,YAAI,OAAO;AAAA,UACP;AAAA,QACJ;AACA;AAAA,MACJ;AAEA,UAAI;AACA,aAAK,SAAU,OAGE,KAAK,IAAI,QAAQ,QAAQ,QAAQ,MAAM;AACxD,YAAI,OAAO;AAAA,UACP,qFAAgF,QAAQ,MAAM;AAAA,QAClG;AAAA,MACJ,SAAS,KAAK;AACV,YAAI,OAAO;AAAA,UACP;AAAA,UACA;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ,CAAC;AAED,QAAI,KAAK,mBAAmB,YAAY;AACpC,UAAI;AACA,aAAK,SAAS;AAAA,MAClB,SAAS,KAAK;AACV,YAAI,OAAO;AAAA,UACP;AAAA,UACA;AAAA,QACJ;AAAA,MACJ;AACA,WAAK,SAAS;AAAA,IAClB,CAAC;AAAA,EACL;AACJ;","names":[]}