@abloatai/ablo 0.36.0 → 0.37.0

package/dist/views/ViewRegistry.js

@@ -1,55 +0,0 @@
-/**
- * ViewRegistry — tracks active QueryViews per typename.
- *
- * When the InstanceCache mutates a model, it calls notifyAdded / notifyUpdated /
- * notifyRemoved on the registry, which fans the event out to every active
- * QueryView subscribed to that typename.
- */
-import { modelAsRow } from '../Model.js';
-export class ViewRegistry {
-    views = new Map();
-    register(typename, view) {
-        let set = this.views.get(typename);
-        if (!set) {
-            set = new Set();
-            this.views.set(typename, set);
-        }
-        set.add(view);
-    }
-    unregister(typename, view) {
-        const set = this.views.get(typename);
-        if (!set)
-            return;
-        set.delete(view);
-        if (set.size === 0) {
-            this.views.delete(typename);
-        }
-    }
-    /** Called by InstanceCache after a model is added to the pool. */
-    notifyAdded(typename, model) {
-        const set = this.views.get(typename);
-        if (!set)
-            return;
-        for (const view of set) {
-            view.handleAdded(modelAsRow(model));
-        }
-    }
-    /** Called by InstanceCache after a model is updated in the pool. */
-    notifyUpdated(typename, model) {
-        const set = this.views.get(typename);
-        if (!set)
-            return;
-        for (const view of set) {
-            view.handleUpdated(modelAsRow(model));
-        }
-    }
-    /** Called by InstanceCache after a model is removed from the pool. */
-    notifyRemoved(typename, modelId) {
-        const set = this.views.get(typename);
-        if (!set)
-            return;
-        for (const view of set) {
-            view.handleRemoved(modelId);
-        }
-    }
-}

package/dist/views/incrementalView.d.ts

@@ -1,45 +0,0 @@
-/**
- * The {@link IncrementalView} contract — the interface a live view implements
- * to receive add/update/remove notifications — together with the sorting,
- * matching, and binary-insertion rules every view shares. Keeping the rules in
- * one place ensures every view sorts and filters identically. The functions
- * here work on plain arrays and values — they hold no reference to models,
- * pools, or the reactivity system.
- */
-/**
- * The interface a live view implements to receive incremental updates: one call
- * when an entity is added, one when it changes, and one when it is removed. A
- * view registry holds its views under this non-generic base type so it can keep
- * views over different entity shapes in a single collection and notify them
- * uniformly. Because a generic `View<T>` is invariant in `T`, this shared base
- * is what lets the registry store and dispatch to them without unsafe casts.
- */
-export interface IncrementalView {
-    handleAdded(entity: Record<string, unknown>): void;
-    handleUpdated(entity: Record<string, unknown>): void;
-    handleRemoved(id: string): void;
-}
-/**
- * Compares two values for sorting, tolerating `null` and `undefined`, which
- * always sort last regardless of direction. `dir` is 1 for ascending or -1 for
- * descending. Returns -1, 0, or 1.
- */
-export declare function compareValues(a: unknown, b: unknown, dir: 1 | -1): number;
-/**
- * Finds, by binary search, the index at which `item` should be inserted to keep
- * an array ordered. The array must already be sorted by `sortKey` in direction
- * `dir`, using the same rule as {@link compareValues}. Returns that insertion
- * index.
- */
-export declare function binaryInsertionIndex<T>(arr: ArrayLike<T>, item: T, sortKey: string, dir: 1 | -1): number;
-/**
- * Returns true when an entity satisfies a declarative `where` filter: every key
- * present in `where` must equal the entity's value for that key. A key whose
- * filter value is `undefined` is skipped, so a partially-filled filter matches
- * on only its defined keys.
- */
-export declare function matchesWhere<T extends Record<string, unknown>>(entity: T, where: Partial<T>): boolean;
-/**
- * Find the index of an entity by id in an array. Returns -1 if not found.
- */
-export declare function findIndexById<T extends Record<string, unknown>>(arr: ArrayLike<T>, id: string): number;

package/dist/views/incrementalView.js

@@ -1,69 +0,0 @@
-/**
- * The {@link IncrementalView} contract — the interface a live view implements
- * to receive add/update/remove notifications — together with the sorting,
- * matching, and binary-insertion rules every view shares. Keeping the rules in
- * one place ensures every view sorts and filters identically. The functions
- * here work on plain arrays and values — they hold no reference to models,
- * pools, or the reactivity system.
- */
-/**
- * Compares two values for sorting, tolerating `null` and `undefined`, which
- * always sort last regardless of direction. `dir` is 1 for ascending or -1 for
- * descending. Returns -1, 0, or 1.
- */
-export function compareValues(a, b, dir) {
-    if (a === b)
-        return 0;
-    if (a == null)
-        return 1;
-    if (b == null)
-        return -1;
-    return (a < b ? -1 : 1) * dir;
-}
-/**
- * Finds, by binary search, the index at which `item` should be inserted to keep
- * an array ordered. The array must already be sorted by `sortKey` in direction
- * `dir`, using the same rule as {@link compareValues}. Returns that insertion
- * index.
- */
-export function binaryInsertionIndex(arr, item, sortKey, dir) {
-    let lo = 0;
-    let hi = arr.length;
-    const itemVal = item[sortKey];
-    while (lo < hi) {
-        const mid = (lo + hi) >>> 1;
-        const midVal = arr[mid][sortKey];
-        if (compareValues(midVal, itemVal, dir) <= 0) {
-            lo = mid + 1;
-        }
-        else {
-            hi = mid;
-        }
-    }
-    return lo;
-}
-/**
- * Returns true when an entity satisfies a declarative `where` filter: every key
- * present in `where` must equal the entity's value for that key. A key whose
- * filter value is `undefined` is skipped, so a partially-filled filter matches
- * on only its defined keys.
- */
-export function matchesWhere(entity, where) {
-    for (const [key, value] of Object.entries(where)) {
-        if (value === undefined)
-            continue;
-        if (entity[key] !== value)
-            return false;
-    }
-    return true;
-}
-/**
- * Find the index of an entity by id in an array. Returns -1 if not found.
- */
-export function findIndexById(arr, id) {
-    for (let i = 0; i < arr.length; i++) {
-        if (arr[i]?.id === id)
-            return i;
-    }
-    return -1;
-}

package/dist/webhooks/events.d.ts

@@ -1,43 +0,0 @@
-/**
- * A webhook event delivered to a customer's endpoint, representing a single
- * committed change to a row. {@link deltaToWebhookEvent} produces it, and the
- * recipient verifies the delivery signature before trusting its contents.
- */
-export interface AbloWebhookEvent {
-    /** A stable, unique event identifier equal to `String(syncId)`. Use it to
-     *  deduplicate deliveries. */
-    readonly id: string;
-    /** The event type, formatted as `<model>.<verb>`, such as `"report.updated"`.
-     *  Branch on this to route the event. */
-    readonly type: string;
-    /** The name of the model whose row changed, such as `"Report"`. */
-    readonly model: string;
-    /** The identifier of the row that changed. */
-    readonly objectId: string;
-    /** The change's position in the transaction log, increasing monotonically.
-     *  Order events by this value. */
-    readonly syncId: number;
-    /** The row as it stands after the change, or `null` when the change was a
-     *  delete. */
-    readonly data: Record<string, unknown> | null;
-    /** The time the change was committed, as an ISO 8601 timestamp. */
-    readonly createdAt: string;
-}
-/** The minimal delta shape {@link deltaToWebhookEvent} reads; a full server-side
- *  delta record satisfies it. */
-export interface WebhookSourceDelta {
-    readonly id: number;
-    readonly actionType: string;
-    readonly modelName: string;
-    readonly modelId: string;
-    /** The row payload: an already-parsed object, a raw JSON string, or `null`. */
-    readonly data: Record<string, unknown> | string | null;
-    readonly createdAt: string;
-}
-/**
- * Converts a committed delta into an {@link AbloWebhookEvent}. Returns `null`
- * when the delta records an internal permission or group change rather than a
- * row-level change, in which case the caller emits no webhook. The mapping is
- * deterministic: the event id and timestamp come directly from the delta.
- */
-export declare function deltaToWebhookEvent(delta: WebhookSourceDelta): AbloWebhookEvent | null;

package/dist/webhooks/events.js

@@ -1,42 +0,0 @@
-/**
- * Maps each delta action code to the verb that appears in an event type. Only
- * the row-level create, update, delete, archive, and unarchive actions produce a
- * webhook. The remaining action codes describe internal permission and
- * visibility changes and are deliberately absent, so {@link deltaToWebhookEvent}
- * returns `null` for them.
- */
-const ACTION_VERB = {
-    I: 'created',
-    U: 'updated',
-    D: 'deleted',
-    A: 'archived',
-    V: 'unarchived',
-};
-function parseRow(data) {
-    if (data == null)
-        return null;
-    if (typeof data === 'string') {
-        return data === '' ? null : JSON.parse(data);
-    }
-    return data;
-}
-/**
- * Converts a committed delta into an {@link AbloWebhookEvent}. Returns `null`
- * when the delta records an internal permission or group change rather than a
- * row-level change, in which case the caller emits no webhook. The mapping is
- * deterministic: the event id and timestamp come directly from the delta.
- */
-export function deltaToWebhookEvent(delta) {
-    const verb = ACTION_VERB[delta.actionType];
-    if (!verb)
-        return null; // an internal permission or group change, not a customer event
-    return {
-        id: String(delta.id),
-        type: `${delta.modelName.toLowerCase()}.${verb}`,
-        model: delta.modelName,
-        objectId: delta.modelId,
-        syncId: delta.id,
-        data: parseRow(delta.data),
-        createdAt: delta.createdAt,
-    };
-}

package/dist/webhooks/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * The public entry point for webhooks. Import {@link AbloWebhookEvent} to type
- * your event handler, and use {@link deltaToWebhookEvent} to turn a committed
- * change from the transaction log into an event to deliver. This module does not
- * verify signatures and ships no cryptography; recipients verify deliveries with
- * a standard webhooks library.
- */
-export { deltaToWebhookEvent, type AbloWebhookEvent, type WebhookSourceDelta, } from './events.js';

package/dist/webhooks/index.js

@@ -1,8 +0,0 @@
-/**
- * The public entry point for webhooks. Import {@link AbloWebhookEvent} to type
- * your event handler, and use {@link deltaToWebhookEvent} to turn a committed
- * change from the transaction log into an event to deliver. This module does not
- * verify signatures and ships no cryptography; recipients verify deliveries with
- * a standard webhooks library.
- */
-export { deltaToWebhookEvent, } from './events.js';

package/dist/wire/index.d.ts

@@ -1 +0,0 @@
-export * from '../transaction/wire/index.js';

package/dist/wire/index.js

@@ -1,8 +0,0 @@
-// Moved to @ablo/transaction (ADR 0013 — the settlement core extraction).
-// This shim re-exports it at the original path so in-package importers of
-// `wire/index.js` keep working; rewire to `@ablo/transaction/wire`
-// and delete this shim once the core package is fully wired.
-//
-// Line comments on purpose: tsc copies a leading JSDoc block into the
-// published `.d.ts`, and this note names a package npm has never heard of.
-export * from '../transaction/wire/index.js';