birrstack-core 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,8 @@
-# Temporary Holding Version
+# birrstack-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> BismiLLAH Ar-Rahman Ar-Raheem. Ash-hadu an laa ilaaha illa-Llah wahdaHu laa sharikalah, wa ash-hadu anna Muhammadan 'Abduhu wa Rasooluh. Laa hawla wa laa quwwata illaa biLLAH.
+
+Part of **BirrStack** — the zero-compute fullstack framework: enterprise platforms on Cloudflare Pages with zero CF Workers, zero external compute (ADR-002, protocol §5.5C), all app logic on the client device, all authority in the BaaS data plane.
+
+- Docs: https://github.com/ridwanullahh/BirrStack#readme
+- License: MIT

package/dist/async/index.d.ts

@@ -0,0 +1,16 @@
+import { type Signal } from '../signals/index.js';
+export interface QueryOptions {
+    ttl?: number;
+    immediate?: boolean;
+    retries?: number;
+}
+export interface Query<T> {
+    readonly data: Signal<T | undefined>;
+    readonly loading: Signal<boolean>;
+    readonly error: Signal<Error | undefined>;
+    refetch(force?: boolean): Promise<void>;
+    mutate(next: T): () => void;
+    invalidate(): void;
+}
+export declare function query<T>(fetcher: () => Promise<T>, options?: QueryOptions): Query<T>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAE3B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAE1C,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;IAE5B,UAAU,IAAI,IAAI,CAAC;CACpB;AAMD,wBAAgB,KAAK,CAAC,CAAC,EACrB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,YAAiB,GACzB,KAAK,CAAC,CAAC,CAAC,CA8EV"}

package/dist/async/index.js

@@ -0,0 +1,82 @@
+import { signal } from '../signals/index.js';
+export function query(fetcher, options = {}) {
+    const ttl = options.ttl ?? 30_000;
+    const immediate = options.immediate ?? true;
+    const retries = options.retries ?? 0;
+    const data = signal(undefined);
+    const loading = signal(false);
+    const error = signal(undefined);
+    let lastFetchedAt = 0;
+    let inflight = null;
+    let runCount = 0;
+    async function run() {
+        if (inflight)
+            return inflight.promise;
+        const currentRun = ++runCount;
+        loading.value = true;
+        error.value = undefined;
+        const execute = async () => {
+            let attempt = 0;
+            for (;;) {
+                try {
+                    const result = await fetcher();
+                    if (currentRun !== runCount)
+                        return;
+                    data.value = result;
+                    lastFetchedAt = Date.now();
+                    error.value = undefined;
+                    return;
+                }
+                catch (err) {
+                    if (attempt < retries) {
+                        attempt++;
+                        continue;
+                    }
+                    if (currentRun !== runCount)
+                        return;
+                    error.value = err instanceof Error ? err : new Error(String(err));
+                    return;
+                }
+                finally {
+                    if (currentRun === runCount)
+                        loading.value = false;
+                }
+            }
+        };
+        const promise = execute();
+        inflight = { promise };
+        try {
+            await promise;
+        }
+        finally {
+            if (inflight?.promise === promise)
+                inflight = null;
+        }
+    }
+    if (immediate) {
+        void run();
+    }
+    return {
+        data,
+        loading,
+        error,
+        async refetch(force = false) {
+            if (!force && Date.now() - lastFetchedAt < ttl && lastFetchedAt > 0) {
+                return;
+            }
+            return run();
+        },
+        mutate(next) {
+            const previous = data.value;
+            data.value = next;
+            lastFetchedAt = Date.now();
+            return () => {
+                data.value = previous;
+            };
+        },
+        invalidate() {
+            lastFetchedAt = 0;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/async/index.js.map

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

package/dist/component/index.d.ts

@@ -0,0 +1,33 @@
+export type BirrProps = Record<string, unknown>;
+export type Slot = (parent: Node) => void;
+export interface ComponentContext {
+    host: HTMLElement;
+    props: BirrProps;
+    slots: Record<string, Slot>;
+    onUnmount(fn: () => void): void;
+    emit(event: string, ...args: unknown[]): void;
+}
+export interface ComponentDefinition {
+    name?: string;
+    props?: Record<string, {
+        type?: unknown;
+        default?: unknown;
+        required?: boolean;
+    }>;
+    setup(ctx: ComponentContext): Record<string, unknown>;
+    render(state: Record<string, unknown>, ctx: ComponentContext): Node;
+}
+export interface ComponentInstance {
+    root: Node;
+    unmount(): void;
+}
+export interface MountOptions {
+    hydrate?: boolean;
+}
+export declare function mount(definition: ComponentDefinition, host: HTMLElement, props?: BirrProps, slots?: Record<string, Slot>, options?: MountOptions): ComponentInstance;
+export declare function defineComponent(def: ComponentDefinition): ComponentDefinition;
+export declare function mountChild(host: HTMLElement, definition: ComponentDefinition, props?: BirrProps): ComponentInstance;
+export declare function watch<T>(source: () => T, callback: (value: T, oldValue: T | undefined) => void): () => void;
+export declare function onMount(ctx: ComponentContext, fn: () => void | (() => void)): void;
+export declare function onUnmount(ctx: ComponentContext, fn: () => void): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/component/index.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGhD,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,IAAI,CAAC;AAG1C,MAAM,WAAW,gBAAgB;IAE/B,IAAI,EAAE,WAAW,CAAC;IAElB,KAAK,EAAE,SAAS,CAAC;IAEjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEhC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC/C;AAGD,MAAM,WAAW,mBAAmB;IAElC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAKlF,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKtD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrE;AAGD,MAAM,WAAW,iBAAiB;IAEhC,IAAI,EAAE,IAAI,CAAC;IAEX,OAAO,IAAI,IAAI,CAAC;CACjB;AAGD,MAAM,WAAW,YAAY;IAO3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAWD,wBAAgB,KAAK,CACnB,UAAU,EAAE,mBAAmB,EAC/B,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,SAAc,EACrB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAM,EAChC,OAAO,GAAE,YAAiB,GACzB,iBAAiB,CAiFnB;AAOD,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,mBAAmB,CAE7E;AAYD,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,GAAE,SAAc,GACpB,iBAAiB,CAEnB;AAQD,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,MAAM,CAAC,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,GACpD,MAAM,IAAI,CAUZ;AAkBD,wBAAgB,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAgDlF;AAOD,wBAAgB,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAErE"}

package/dist/component/index.js

@@ -0,0 +1,135 @@
+import { effect, effectScope } from '../signals/index.js';
+import { disposeNode } from '../dom/index.js';
+export function mount(definition, host, props = {}, slots = {}, options = {}) {
+    const unmountCallbacks = [];
+    let unmounted = false;
+    const scope = effectScope();
+    const ctx = {
+        host,
+        props,
+        slots,
+        onUnmount(fn) {
+            unmountCallbacks.push(fn);
+        },
+        emit(event, ...args) {
+            const handler = props[`on${event.charAt(0).toUpperCase()}${event.slice(1)}`];
+            if (typeof handler === 'function') {
+                handler(...args);
+            }
+        },
+    };
+    if (definition.props) {
+        for (const [key, spec] of Object.entries(definition.props)) {
+            if (!(key in props)) {
+                if (spec.required) {
+                    throw new Error(`BirrStack: missing required prop "${key}" on component "${definition.name ?? '<anonymous>'}"`);
+                }
+                if (spec.default !== undefined) {
+                    props[key] = typeof spec.default === 'function' ? spec.default() : spec.default;
+                }
+            }
+        }
+    }
+    let state;
+    let root;
+    try {
+        scope.run(() => {
+            state = definition.setup(ctx);
+            root = definition.render(state, ctx);
+        });
+    }
+    catch (err) {
+        scope.dispose();
+        throw err;
+    }
+    if (options.hydrate && host.childNodes.length > 0) {
+        while (host.firstChild)
+            host.removeChild(host.firstChild);
+    }
+    host.appendChild(root);
+    return {
+        root,
+        unmount() {
+            if (unmounted)
+                return;
+            unmounted = true;
+            for (const cb of unmountCallbacks) {
+                try {
+                    cb();
+                }
+                catch (err) {
+                    console.error('BirrStack: error during unmount callback', err);
+                }
+            }
+            scope.dispose();
+            disposeNode(root);
+            if (root.parentNode === host) {
+                host.removeChild(root);
+            }
+        },
+    };
+}
+export function defineComponent(def) {
+    return def;
+}
+export function mountChild(host, definition, props = {}) {
+    return mount(definition, host, props, {}, {});
+}
+export function watch(source, callback) {
+    let oldValue = undefined;
+    const dispose = effect(() => {
+        const value = source();
+        if (!Object.is(value, oldValue)) {
+            callback(value, oldValue);
+            oldValue = value;
+        }
+    });
+    return dispose;
+}
+export function onMount(ctx, fn) {
+    let fired = false;
+    let cancelled = false;
+    let observer = null;
+    const detach = () => {
+        if (observer !== null) {
+            observer.disconnect();
+            observer = null;
+        }
+    };
+    const invoke = () => {
+        if (fired || cancelled)
+            return;
+        fired = true;
+        detach();
+        const cleanup = fn();
+        if (typeof cleanup === 'function') {
+            ctx.onUnmount(cleanup);
+        }
+    };
+    ctx.onUnmount(() => {
+        cancelled = true;
+        detach();
+    });
+    queueMicrotask(() => {
+        if (fired || cancelled)
+            return;
+        if (ctx.host.isConnected) {
+            invoke();
+            return;
+        }
+        const doc = ctx.host.ownerDocument ??
+            globalThis.document ??
+            null;
+        if (doc !== null && typeof MutationObserver === 'function') {
+            observer = new MutationObserver(() => {
+                if (ctx.host.isConnected)
+                    invoke();
+            });
+            observer.observe(doc.documentElement ?? doc, { childList: true, subtree: true });
+        }
+    });
+}
+export function onUnmount(ctx, fn) {
+    ctx.onUnmount(fn);
+}
+//# sourceMappingURL=index.js.map

package/dist/component/index.js.map

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

package/dist/data/index.d.ts

@@ -0,0 +1,142 @@
+export declare const DataErrorCode: Readonly<{
+    readonly timeout: "timeout";
+    readonly protocol: "protocol";
+    readonly not_found: "not_found";
+    readonly validation: "validation";
+    readonly forbidden: "forbidden";
+    readonly unauthorized: "unauthorized";
+    readonly server: "server";
+    readonly network: "network";
+}>;
+export type DataErrorCodeValue = (typeof DataErrorCode)[keyof typeof DataErrorCode];
+export interface DataErrorInit {
+    domain?: string;
+    status?: number;
+    correlationId?: string;
+}
+export declare class DataError extends Error {
+    readonly code: string;
+    readonly domain: string;
+    readonly status: number;
+    readonly correlationId: string;
+    constructor(message: string, code: string, init?: DataErrorInit);
+}
+export declare class DataTimeoutError extends DataError {
+    constructor(timeoutMs: number);
+}
+export declare class DataProtocolError extends DataError {
+    constructor(message: string, status?: number);
+}
+export interface DataConfig {
+    baseUrl: string;
+    projectId: string;
+    publicKey: string;
+    namespace?: string;
+    timeoutMs?: number;
+    retries?: number;
+    backoffBaseMs?: number;
+    fetchFn?: typeof fetch;
+}
+export type FilterOp = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'nin' | 'startsWith' | 'endsWith' | 'contains';
+export interface Filter {
+    column: string;
+    op: FilterOp;
+    value: string | string[];
+}
+export interface ListOrder {
+    column: string;
+    dir: 'asc' | 'desc';
+}
+export interface ListOpts {
+    select?: string[];
+    limit?: number;
+    offset?: number;
+    order?: ListOrder;
+    filters?: Filter[];
+    after?: string;
+}
+export interface DataClient {
+    list<T>(collection: string, opts?: ListOpts): Promise<T[]>;
+    get<T>(collection: string, id: string): Promise<T | null>;
+    count(collection: string, filters?: Filter[]): Promise<number>;
+    withSession(jwt: string): SessionClient;
+}
+export interface UpdateOptions {
+    expectedRevision?: number;
+}
+export interface SessionClient extends DataClient {
+    insert<T>(collection: string, row: Record<string, unknown>): Promise<T>;
+    insertMany<T>(collection: string, rows: Record<string, unknown>[]): Promise<T[]>;
+    update<T>(collection: string, id: string, patch: Record<string, unknown>, opts?: UpdateOptions): Promise<T>;
+    remove(collection: string, id: string): Promise<void>;
+}
+export interface AdminCollectionField {
+    name: string;
+    type: string;
+    required?: boolean;
+    unique?: boolean;
+    indexed?: boolean;
+    minimum?: number;
+    maximum?: number;
+    default?: unknown;
+}
+export interface AdminCollectionIndex {
+    name: string;
+    fields: string[];
+    unique?: boolean;
+}
+export interface AdminCollectionDef {
+    name: string;
+    fields?: AdminCollectionField[];
+    indexes?: AdminCollectionIndex[];
+}
+export interface AdminCollectionInfo {
+    name: string;
+    count: number;
+    bytes: number;
+    lastModified: string;
+}
+export interface BulkOps {
+    inserts?: {
+        collection: string;
+        document: Record<string, unknown>;
+    }[];
+    updates?: {
+        collection: string;
+        id: string;
+        patch: Record<string, unknown>;
+    }[];
+    deletes?: {
+        collection: string;
+        id: string;
+    }[];
+}
+export interface BulkResult {
+    inserted: number;
+    updated: number;
+    deleted: number;
+    errors: unknown[];
+}
+export type TokenScope = 'read' | 'write' | 'admin';
+export interface ExchangeTokenOptions {
+    ttlSeconds?: number;
+    scopes?: TokenScope[];
+}
+export interface TokenExchange {
+    accessToken: string;
+    tokenType: string;
+    expiresIn: number;
+    projectId: string;
+}
+export interface AdminClient {
+    createCollection(def: AdminCollectionDef): Promise<Record<string, unknown>>;
+    listCollections(): Promise<AdminCollectionInfo[]>;
+    bulk(ops: BulkOps): Promise<BulkResult>;
+    exchangeToken(opts?: ExchangeTokenOptions): Promise<TokenExchange>;
+}
+export declare function validateBaseUrl(url: string): string;
+export declare function validateCollectionName(name: string): string;
+export declare function resolveCollection(cfg: DataConfig, collection: string): string;
+export declare function createDataClient(cfg: DataConfig): DataClient;
+export declare function createAdminClient(cfg: DataConfig): AdminClient;
+//# sourceMappingURL=index.d.ts.map

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

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