@faable/deploy-sdk 2.17.1 → 2.18.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./FaableDeployApi.js";
+export * from "./informers/index.js";
 export * from "./api/generated-client.js";
 export * from "./api/custom-types.js";
 export * from "./api/types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAM/B,cAAc,kBAAkB,CAAC;AAMjC,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAM/B,cAAc,kBAAkB,CAAC;AAMjC,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./FaableDeployApi.js";
+export * from "./informers/index.js";
 export * from "./api/generated-client.js";
 // custom-types re-exports the auto-generated api-types plus the hand-maintained
 // extras (friendlier event names, the AppTraffic interface).

package/dist/informers/Indexer.d.ts

@@ -0,0 +1,24 @@
+export type IndexFn<T> = (obj: T) => string[];
+export declare class Indexer<T extends {
+    id: string;
+}> {
+    private objects;
+    private indexFns;
+    private indexes;
+    addIndex(name: string, fn: IndexFn<T>): void;
+    get(id: string): T | undefined;
+    rvOf(id: string): string | undefined;
+    list(): T[];
+    ids(): string[];
+    byIndex(name: string, key: string): T[];
+    /** Upsert if newer. Returns the previous object, or null if dropped. */
+    upsert(obj: T, rv: string): {
+        applied: boolean;
+        old?: T;
+    };
+    /** Remove unless what is held is newer than the delete. */
+    delete(id: string, rv: string): T | undefined;
+    private indexObj;
+    private unindex;
+}
+//# sourceMappingURL=Indexer.d.ts.map

package/dist/informers/Indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Indexer.d.ts","sourceRoot":"","sources":["../../src/informers/Indexer.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,EAAE,CAAA;AAE7C,qBAAa,OAAO,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC3C,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,OAAO,CAA8C;IAE7D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAO5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI9B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC,IAAI,IAAI,CAAC,EAAE;IAIX,GAAG,IAAI,MAAM,EAAE;IAIf,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE;IAMvC,wEAAwE;IACxE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,CAAC,CAAA;KAAE;IASzD,2DAA2D;IAC3D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQ7C,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,OAAO;CAShB"}

package/dist/informers/Indexer.js

@@ -0,0 +1,70 @@
+import { compareRv } from "./rv.js";
+export class Indexer {
+    objects = new Map();
+    indexFns = new Map();
+    indexes = new Map();
+    addIndex(name, fn) {
+        this.indexFns.set(name, fn);
+        const idx = new Map();
+        this.indexes.set(name, idx);
+        for (const { obj } of this.objects.values())
+            this.indexObj(name, fn, obj);
+    }
+    get(id) {
+        return this.objects.get(id)?.obj;
+    }
+    rvOf(id) {
+        return this.objects.get(id)?.rv;
+    }
+    list() {
+        return [...this.objects.values()].map((e) => e.obj);
+    }
+    ids() {
+        return [...this.objects.keys()];
+    }
+    byIndex(name, key) {
+        const ids = this.indexes.get(name)?.get(key);
+        if (!ids)
+            return [];
+        return [...ids].map((id) => this.objects.get(id).obj);
+    }
+    /** Upsert if newer. Returns the previous object, or null if dropped. */
+    upsert(obj, rv) {
+        const cur = this.objects.get(obj.id);
+        if (cur && compareRv(rv, cur.rv) <= 0)
+            return { applied: false };
+        if (cur)
+            this.unindex(cur.obj);
+        this.objects.set(obj.id, { obj, rv });
+        for (const [name, fn] of this.indexFns)
+            this.indexObj(name, fn, obj);
+        return { applied: true, old: cur?.obj };
+    }
+    /** Remove unless what is held is newer than the delete. */
+    delete(id, rv) {
+        const cur = this.objects.get(id);
+        if (!cur || compareRv(cur.rv, rv) > 0)
+            return undefined;
+        this.unindex(cur.obj);
+        this.objects.delete(id);
+        return cur.obj;
+    }
+    indexObj(name, fn, obj) {
+        const idx = this.indexes.get(name);
+        for (const key of fn(obj)) {
+            if (!idx.has(key))
+                idx.set(key, new Set());
+            idx.get(key).add(obj.id);
+        }
+    }
+    unindex(obj) {
+        for (const [name, fn] of this.indexFns) {
+            const idx = this.indexes.get(name);
+            for (const key of fn(obj)) {
+                idx.get(key)?.delete(obj.id);
+                if (idx.get(key)?.size === 0)
+                    idx.delete(key);
+            }
+        }
+    }
+}

package/dist/informers/InformerFactory.d.ts

@@ -0,0 +1,67 @@
+import { Indexer, type IndexFn } from "./Indexer.js";
+import { type WatchClient, type WatchResource } from "./WatchClient.js";
+export type InformerEvent = "add" | "update" | "delete";
+type Handler<T> = (obj: T, old?: T) => void;
+export declare class SharedInformer<T extends {
+    id: string;
+}> {
+    readonly store: Indexer<T>;
+    private handlers;
+    readonly resource: WatchResource;
+    constructor(resource: WatchResource);
+    on(event: InformerEvent, handler: Handler<T>): this;
+    addIndex(name: string, fn: IndexFn<T>): this;
+    get(id: string): T | undefined;
+    list(): T[];
+    byIndex(name: string, key: string): T[];
+    /** @internal */
+    emit(event: InformerEvent, obj: T, old?: T): void;
+    /** @internal Apply an upsert; emits add/update. */
+    apply(obj: T, rv: string): void;
+    /** @internal Apply a delete; emits delete. */
+    remove(id: string, rv: string): void;
+    /** @internal A relist: apply every item, then delete what was not listed. */
+    replace(items: {
+        rv: string;
+        object: T;
+    }[], listRv: string): void;
+}
+export type InformerFactoryOptions = {
+    resources: WatchResource[];
+    logger?: {
+        warn: (o: object, m?: string) => void;
+        info?: (o: object, m?: string) => void;
+    };
+    /** Backoff after a failed list or watch: first and max delay. */
+    backoffMs?: [number, number];
+};
+export declare class InformerFactory {
+    private informers;
+    private abort?;
+    private loop?;
+    private synced;
+    private syncWaiters;
+    private rv?;
+    private stopped;
+    readonly stats: {
+        relists: number;
+        reconnects: number;
+        events: number;
+        lastEventAt: number;
+    };
+    private client;
+    private options;
+    constructor(client: WatchClient, options: InformerFactoryOptions);
+    informer<T extends {
+        id: string;
+    } = any>(resource: WatchResource): SharedInformer<T>;
+    hasSynced(): boolean;
+    waitForSync(): Promise<void>;
+    start(): void;
+    stop(): Promise<void>;
+    private relist;
+    private handle;
+    private run;
+}
+export {};
+//# sourceMappingURL=InformerFactory.d.ts.map

package/dist/informers/InformerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InformerFactory.d.ts","sourceRoot":"","sources":["../../src/informers/InformerFactory.ts"],"names":[],"mappings":"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"}

package/dist/informers/InformerFactory.js

@@ -0,0 +1,184 @@
+import { Indexer } from "./Indexer.js";
+import { compareRv, minRv } from "./rv.js";
+import { WatchExpiredError, } from "./WatchClient.js";
+export class SharedInformer {
+    store = new Indexer();
+    handlers = {
+        add: [],
+        update: [],
+        delete: [],
+    };
+    resource;
+    constructor(resource) {
+        this.resource = resource;
+    }
+    on(event, handler) {
+        this.handlers[event].push(handler);
+        return this;
+    }
+    addIndex(name, fn) {
+        this.store.addIndex(name, fn);
+        return this;
+    }
+    get(id) {
+        return this.store.get(id);
+    }
+    list() {
+        return this.store.list();
+    }
+    byIndex(name, key) {
+        return this.store.byIndex(name, key);
+    }
+    /** @internal */
+    emit(event, obj, old) {
+        for (const h of this.handlers[event]) {
+            try {
+                h(obj, old);
+            }
+            catch {
+                // A handler's failure is the handler's: the store and the other
+                // handlers carry on.
+            }
+        }
+    }
+    /** @internal Apply an upsert; emits add/update. */
+    apply(obj, rv) {
+        const { applied, old } = this.store.upsert(obj, rv);
+        if (applied)
+            this.emit(old ? "update" : "add", obj, old);
+    }
+    /** @internal Apply a delete; emits delete. */
+    remove(id, rv) {
+        const gone = this.store.delete(id, rv);
+        if (gone)
+            this.emit("delete", gone);
+    }
+    /** @internal A relist: apply every item, then delete what was not listed. */
+    replace(items, listRv) {
+        const seen = new Set();
+        for (const { rv, object } of items) {
+            seen.add(object.id);
+            this.apply(object, rv);
+        }
+        for (const id of this.store.ids())
+            if (!seen.has(id))
+                this.remove(id, listRv);
+    }
+}
+export class InformerFactory {
+    informers = new Map();
+    abort;
+    loop;
+    synced = false;
+    syncWaiters = [];
+    rv;
+    stopped = true;
+    stats = { relists: 0, reconnects: 0, events: 0, lastEventAt: 0 };
+    client;
+    options;
+    constructor(client, options) {
+        this.client = client;
+        this.options = options;
+        for (const r of options.resources)
+            this.informers.set(r, new SharedInformer(r));
+    }
+    informer(resource) {
+        const inf = this.informers.get(resource);
+        if (!inf)
+            throw new Error(`informer for "${resource}" not in this factory`);
+        return inf;
+    }
+    hasSynced() {
+        return this.synced;
+    }
+    waitForSync() {
+        if (this.synced)
+            return Promise.resolve();
+        return new Promise((r) => this.syncWaiters.push(r));
+    }
+    start() {
+        if (!this.stopped)
+            return;
+        this.stopped = false;
+        this.abort = new AbortController();
+        this.loop = this.run();
+    }
+    async stop() {
+        this.stopped = true;
+        this.abort?.abort();
+        await this.loop?.catch(() => { });
+    }
+    async relist() {
+        const rvs = [];
+        for (const [resource, inf] of this.informers) {
+            const { rv, items } = await this.client.list(resource);
+            inf.replace(items, rv);
+            rvs.push(rv);
+        }
+        // Watch from the OLDEST list rv: events already reflected in a newer
+        // list are dropped by the per-object rv.
+        this.rv = minRv(rvs);
+        this.stats.relists++;
+        if (!this.synced) {
+            this.synced = true;
+            for (const w of this.syncWaiters.splice(0))
+                w();
+        }
+    }
+    handle(ev) {
+        this.stats.events++;
+        this.stats.lastEventAt = Date.now();
+        switch (ev.type) {
+            case "BOOKMARK":
+                break;
+            case "MODIFIED":
+                this.informers.get(ev.resource)?.apply(ev.object, ev.objectRv);
+                break;
+            case "DELETED":
+                this.informers.get(ev.resource)?.remove(ev.object.id, ev.rv);
+                break;
+            case "ERROR":
+                return ev.code === "watch_expired" ? "relist" : "ok";
+        }
+        // Resume point: the stream position, which only moves forward.
+        if ("rv" in ev && ev.rv && (!this.rv || compareRv(ev.rv, this.rv) > 0))
+            this.rv = ev.rv;
+        return "ok";
+    }
+    async run() {
+        const [first, max] = this.options.backoffMs ?? [500, 30_000];
+        let backoff = first;
+        let needList = true;
+        while (!this.stopped) {
+            try {
+                if (needList) {
+                    await this.relist();
+                    needList = false;
+                }
+                let relist = false;
+                for await (const ev of this.client.watch(this.options.resources, this.rv, this.abort.signal)) {
+                    if (this.handle(ev) === "relist") {
+                        relist = true;
+                        break;
+                    }
+                    backoff = first;
+                }
+                if (relist)
+                    needList = true;
+                else
+                    this.stats.reconnects++;
+            }
+            catch (err) {
+                if (this.stopped)
+                    break;
+                if (err instanceof WatchExpiredError) {
+                    needList = true;
+                    continue;
+                }
+                this.options.logger?.warn({ err, backoff }, "informers: list/watch failed, retrying");
+                await new Promise((r) => setTimeout(r, backoff));
+                backoff = Math.min(backoff * 2, max);
+            }
+        }
+    }
+}

package/dist/informers/WatchClient.d.ts

@@ -0,0 +1,38 @@
+export type WatchResource = "app" | "deployment" | "domain" | "project";
+export type ListResult<T = any> = {
+    rv: string;
+    items: {
+        rv: string;
+        object: T;
+    }[];
+};
+export type WatchEvent<T = any> = {
+    type: "MODIFIED";
+    resource: WatchResource;
+    rv: string;
+    objectRv: string;
+    object: T;
+} | {
+    type: "DELETED";
+    resource: WatchResource;
+    rv: string;
+    object: {
+        id: string;
+    };
+} | {
+    type: "BOOKMARK";
+    rv: string;
+} | {
+    type: "ERROR";
+    code: string;
+    message?: string;
+};
+/** Thrown by `watch` when the rv cannot be resumed (HTTP 410): relist. */
+export declare class WatchExpiredError extends Error {
+    constructor(message?: string);
+}
+export interface WatchClient {
+    list(resource: WatchResource): Promise<ListResult>;
+    watch(resources: WatchResource[], rv: string, signal: AbortSignal): AsyncIterable<WatchEvent>;
+}
+//# sourceMappingURL=WatchClient.d.ts.map

package/dist/informers/WatchClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatchClient.d.ts","sourceRoot":"","sources":["../../src/informers/WatchClient.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEvE,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,CAAA;KAAE,EAAE,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAC1B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD,0EAA0E;AAC1E,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAA0B;CAI9C;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAClD,KAAK,CACH,SAAS,EAAE,aAAa,EAAE,EAC1B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC,UAAU,CAAC,CAAA;CAC7B"}

package/dist/informers/WatchClient.js

@@ -0,0 +1,9 @@
+// The transport under the informers: list a resource, watch from an rv
+// (arch/api/informers.md § 3). An interface so tests can play a server.
+/** Thrown by `watch` when the rv cannot be resumed (HTTP 410): relist. */
+export class WatchExpiredError extends Error {
+    constructor(message = "watch expired: relist") {
+        super(message);
+        this.name = "WatchExpiredError";
+    }
+}

package/dist/informers/deployApiWatchClient.d.ts

@@ -0,0 +1,4 @@
+import type { Fetcher } from "@faable/sdk-base";
+import { type WatchClient } from "./WatchClient.js";
+export declare const deployApiWatchClient: (fetcher: Fetcher) => WatchClient;
+//# sourceMappingURL=deployApiWatchClient.d.ts.map

package/dist/informers/deployApiWatchClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployApiWatchClient.d.ts","sourceRoot":"","sources":["../../src/informers/deployApiWatchClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,kBAAkB,CAAA;AAWzB,eAAO,MAAM,oBAAoB,YAAa,OAAO,KAAG,WA2BtD,CAAA"}

package/dist/informers/deployApiWatchClient.js

@@ -0,0 +1,36 @@
+import { ndjson } from "./ndjson.js";
+import { WatchExpiredError, } from "./WatchClient.js";
+// The WatchClient over the deploy API's fetcher (auth, identity headers and
+// baseURL included): GET /watch/list and the NDJSON stream of GET /watch.
+//
+// ⚠️ The client must not have `etagCache` on: the ETag path would treat the
+// stream as a cacheable body. Build a separate DeployApi for informers.
+const isGone = (err) => err?.response?.status === 410 || err?.status === 410 || err?.statusCode === 410;
+export const deployApiWatchClient = (fetcher) => ({
+    list: async (resource) => fetcher.request({
+        method: "GET",
+        url: "/watch/list",
+        params: { resource },
+    }),
+    watch: (resources, rv, signal) => ({
+        async *[Symbol.asyncIterator]() {
+            let stream;
+            try {
+                stream = await fetcher.request({
+                    method: "GET",
+                    url: "/watch",
+                    params: { resources: resources.join(","), rv },
+                    responseType: "stream",
+                    timeout: 0,
+                    signal,
+                });
+            }
+            catch (err) {
+                if (isGone(err))
+                    throw new WatchExpiredError();
+                throw err;
+            }
+            yield* ndjson(stream);
+        },
+    }),
+});

package/dist/informers/index.d.ts

@@ -0,0 +1,6 @@
+export { Indexer, type IndexFn } from "./Indexer.js";
+export { InformerFactory, SharedInformer, type InformerEvent, type InformerFactoryOptions, } from "./InformerFactory.js";
+export { compareRv, minRv } from "./rv.js";
+export { WatchExpiredError, type ListResult, type WatchClient, type WatchEvent, type WatchResource, } from "./WatchClient.js";
+export { deployApiWatchClient } from "./deployApiWatchClient.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/informers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EACL,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/informers/index.js

@@ -0,0 +1,5 @@
+export { Indexer } from "./Indexer.js";
+export { InformerFactory, SharedInformer, } from "./InformerFactory.js";
+export { compareRv, minRv } from "./rv.js";
+export { WatchExpiredError, } from "./WatchClient.js";
+export { deployApiWatchClient } from "./deployApiWatchClient.js";

package/dist/informers/ndjson.d.ts

@@ -0,0 +1,2 @@
+export declare function ndjson(chunks: AsyncIterable<Uint8Array | string>): AsyncGenerator<any>;
+//# sourceMappingURL=ndjson.d.ts.map

package/dist/informers/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../src/informers/ndjson.ts"],"names":[],"mappings":"AAEA,wBAAuB,MAAM,CAC3B,MAAM,EAAE,aAAa,CAAC,UAAU,GAAG,MAAM,CAAC,GACzC,cAAc,CAAC,GAAG,CAAC,CAcrB"}

package/dist/informers/ndjson.js

@@ -0,0 +1,19 @@
+// Lines of an NDJSON byte stream (Node Readable or any async iterable of
+// chunks), parsed. A partial last line is kept until it completes.
+export async function* ndjson(chunks) {
+    const decoder = new TextDecoder();
+    let buf = "";
+    for await (const chunk of chunks) {
+        buf += typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true });
+        let i;
+        while ((i = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, i).trim();
+            buf = buf.slice(i + 1);
+            if (line)
+                yield JSON.parse(line);
+        }
+    }
+    const last = buf.trim();
+    if (last)
+        yield JSON.parse(last);
+}

package/dist/informers/rv.d.ts

@@ -0,0 +1,4 @@
+/** <0, 0, >0 like a comparator; an unparsable rv sorts first. */
+export declare const compareRv: (a: string, b: string) => number;
+export declare const minRv: (rvs: string[]) => string;
+//# sourceMappingURL=rv.d.ts.map

package/dist/informers/rv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rv.d.ts","sourceRoot":"","sources":["../../src/informers/rv.ts"],"names":[],"mappings":"AASA,iEAAiE;AACjE,eAAO,MAAM,SAAS,MAAO,MAAM,KAAK,MAAM,KAAG,MAKhD,CAAA;AAED,eAAO,MAAM,KAAK,QAAS,MAAM,EAAE,KAAG,MACe,CAAA"}

package/dist/informers/rv.js

@@ -0,0 +1,16 @@
+// A resourceVersion from the watch API: `<generation>.<streamMs>-<seq>`
+// (arch/api/informers.md § 1). Ordered by generation, then stream position.
+// Opaque to callers; only compared here.
+const parse = (rv) => {
+    const m = /^(\d+)\.(\d+)-(\d+)$/.exec(rv);
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+};
+/** <0, 0, >0 like a comparator; an unparsable rv sorts first. */
+export const compareRv = (a, b) => {
+    const pa = parse(a);
+    const pb = parse(b);
+    if (!pa || !pb)
+        return pa ? 1 : pb ? -1 : 0;
+    return pa[0] - pb[0] || pa[1] - pb[1] || pa[2] - pb[2];
+};
+export const minRv = (rvs) => rvs.reduce((m, r) => (compareRv(r, m) < 0 ? r : m));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@faable/deploy-sdk",
   "description": "Codebase for SDK building",
-  "version": "2.17.1",
+  "version": "2.18.0",
   "author": "Marc Pomar <marc@faable.com>",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",