@beignet/core 0.0.13 → 0.0.15

package/dist/search/index.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @beignet/core/search
+ *
+ * Provider-neutral search primitives for Beignet applications.
+ */
+/**
+ * Primitive values accepted in indexed documents and provider-neutral filters.
+ */
+export type SearchPrimitive = null | boolean | number | string;
+/**
+ * JSON-like values accepted in indexed documents.
+ */
+export type SearchValue = SearchPrimitive | readonly SearchValue[] | {
+    readonly [key: string]: SearchValue;
+};
+/**
+ * Minimal document shape accepted by search indexes.
+ */
+export type SearchDocumentBase = {
+    id: string;
+};
+/**
+ * General search document shape.
+ */
+export type SearchDocument = SearchDocumentBase & {
+    readonly [field: string]: SearchValue | undefined;
+};
+type SearchField<TDocument extends SearchDocumentBase> = Extract<keyof TDocument, string>;
+/**
+ * Provider-neutral index definition.
+ */
+export type SearchIndexDef<TDocument extends SearchDocumentBase = SearchDocument> = {
+    name: string;
+    primaryKey: SearchField<TDocument>;
+    searchableAttributes?: readonly SearchField<TDocument>[];
+    filterableAttributes?: readonly SearchField<TDocument>[];
+    sortableAttributes?: readonly SearchField<TDocument>[];
+    displayedAttributes?: readonly SearchField<TDocument>[];
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Options accepted when defining a search index.
+ */
+export type DefineSearchIndexOptions<TDocument extends SearchDocumentBase> = Omit<SearchIndexDef<TDocument>, "name" | "primaryKey"> & {
+    primaryKey?: SearchField<TDocument>;
+};
+/**
+ * Provider-neutral filter values.
+ */
+export type SearchFilterValue = SearchPrimitive | readonly Exclude<SearchPrimitive, null>[];
+/**
+ * Provider-neutral exact-match filters.
+ */
+export type SearchFilters = Record<string, SearchFilterValue>;
+/**
+ * Provider-neutral sort expression. Use `field:asc` or `field:desc`.
+ */
+export type SearchSort = `${string}:asc` | `${string}:desc` | (string & {});
+/**
+ * Query accepted by search providers.
+ */
+export type SearchQuery = {
+    query?: string;
+    filters?: SearchFilters;
+    sort?: readonly SearchSort[];
+    facets?: readonly string[];
+    limit?: number;
+    offset?: number;
+};
+/**
+ * Page metadata returned from search providers.
+ */
+export type SearchResultPage = {
+    kind: "offset";
+    limit: number;
+    offset: number;
+    total?: number;
+    hasMore: boolean;
+};
+/**
+ * Search result payload.
+ */
+export type SearchResults<TDocument extends SearchDocumentBase> = {
+    hits: TDocument[];
+    query: string;
+    page: SearchResultPage;
+    processingTimeMs?: number;
+    facets?: Record<string, Record<string, number>>;
+};
+/**
+ * Result returned after indexing documents.
+ */
+export type SearchIndexResult = {
+    indexed: number;
+    taskId?: string | number;
+};
+/**
+ * Result returned after deleting indexed documents.
+ */
+export type SearchDeleteResult = {
+    deleted: number;
+    taskId?: string | number;
+};
+/**
+ * App-facing search port.
+ */
+export type SearchPort = {
+    configureIndex<TDocument extends SearchDocumentBase>(index: SearchIndexDef<TDocument>): Promise<void>;
+    indexDocuments<TDocument extends SearchDocumentBase>(index: SearchIndexDef<TDocument>, documents: TDocument | readonly TDocument[]): Promise<SearchIndexResult>;
+    deleteDocuments<TDocument extends SearchDocumentBase>(index: SearchIndexDef<TDocument>, ids: string | readonly string[]): Promise<SearchDeleteResult>;
+    clearIndex<TDocument extends SearchDocumentBase>(index: SearchIndexDef<TDocument>): Promise<SearchDeleteResult>;
+    search<TDocument extends SearchDocumentBase>(index: SearchIndexDef<TDocument>, query: SearchQuery): Promise<SearchResults<TDocument>>;
+};
+/**
+ * Captured memory index state exposed for tests.
+ */
+export type MemorySearchIndexState<TDocument extends SearchDocumentBase = SearchDocument> = {
+    definition?: SearchIndexDef<TDocument>;
+    documents: Map<string, TDocument>;
+};
+/**
+ * In-memory search port exposed for assertions in tests.
+ */
+export type MemorySearchPort = SearchPort & {
+    indexes: Map<string, MemorySearchIndexState>;
+    reset(index?: SearchIndexDef): void;
+};
+/**
+ * Options for the in-memory search adapter.
+ */
+export type CreateMemorySearchOptions = {
+    now?: () => Date;
+};
+/**
+ * Options for the in-memory search provider.
+ */
+export type MemorySearchProviderOptions = CreateMemorySearchOptions & {
+    name?: string;
+};
+/**
+ * Ports contributed by the memory search provider.
+ */
+export interface MemorySearchProviderPorts {
+    search: SearchPort;
+}
+/**
+ * Error thrown when search inputs are invalid.
+ */
+export declare class SearchOptionsError extends Error {
+    constructor(message: string);
+}
+/**
+ * Define a typed search index.
+ */
+export declare function defineSearchIndex<TDocument extends SearchDocumentBase = SearchDocument>(name: string, options?: DefineSearchIndexOptions<TDocument>): SearchIndexDef<TDocument>;
+/**
+ * Index documents through any `SearchPort`.
+ */
+export declare function indexSearchDocuments<TDocument extends SearchDocumentBase>(search: SearchPort, index: SearchIndexDef<TDocument>, documents: TDocument | readonly TDocument[]): Promise<SearchIndexResult>;
+/**
+ * Query documents through any `SearchPort`.
+ */
+export declare function searchDocuments<TDocument extends SearchDocumentBase>(search: SearchPort, index: SearchIndexDef<TDocument>, query: SearchQuery): Promise<SearchResults<TDocument>>;
+/**
+ * Create an in-memory search port for tests and single-process development.
+ */
+export declare function createMemorySearch(_options?: CreateMemorySearchOptions): MemorySearchPort;
+/**
+ * Create a provider that contributes an in-memory search port.
+ */
+export declare function createMemorySearchProvider(options?: MemorySearchProviderOptions): import("../providers/provider.js").ServiceProvider<unknown, import("@standard-schema/spec").StandardSchemaV1<void, void>, {
+    search: SearchPort;
+}, unknown, void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/search/index.js

@@ -0,0 +1,344 @@
+/**
+ * @beignet/core/search
+ *
+ * Provider-neutral search primitives for Beignet applications.
+ */
+import { createProvider, createProviderInstrumentation, } from "../providers/index.js";
+/**
+ * Error thrown when search inputs are invalid.
+ */
+export class SearchOptionsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SearchOptionsError";
+    }
+}
+/**
+ * Define a typed search index.
+ */
+export function defineSearchIndex(name, options = {}) {
+    if (!name)
+        throw new SearchOptionsError("Search index name is required.");
+    return {
+        name,
+        primaryKey: options.primaryKey ?? "id",
+        searchableAttributes: options.searchableAttributes,
+        filterableAttributes: options.filterableAttributes,
+        sortableAttributes: options.sortableAttributes,
+        displayedAttributes: options.displayedAttributes,
+        metadata: options.metadata,
+    };
+}
+/**
+ * Index documents through any `SearchPort`.
+ */
+export function indexSearchDocuments(search, index, documents) {
+    return search.indexDocuments(index, documents);
+}
+/**
+ * Query documents through any `SearchPort`.
+ */
+export function searchDocuments(search, index, query) {
+    return search.search(index, query);
+}
+/**
+ * Create an in-memory search port for tests and single-process development.
+ */
+export function createMemorySearch(_options = {}) {
+    const indexes = new Map();
+    const port = {
+        indexes,
+        async configureIndex(index) {
+            validateIndex(index);
+            stateFor(indexes, index).definition = index;
+        },
+        async indexDocuments(index, documents) {
+            validateIndex(index);
+            const state = stateFor(indexes, index);
+            state.definition = state.definition ?? index;
+            const list = Array.isArray(documents) ? documents : [documents];
+            for (const document of list) {
+                validateDocument(index, document);
+                state.documents.set(String(document[index.primaryKey]), clone(document));
+            }
+            return { indexed: list.length };
+        },
+        async deleteDocuments(index, ids) {
+            validateIndex(index);
+            const state = stateFor(indexes, index);
+            const list = Array.isArray(ids) ? ids : [ids];
+            let deleted = 0;
+            for (const id of list) {
+                if (state.documents.delete(id))
+                    deleted++;
+            }
+            return { deleted };
+        },
+        async clearIndex(index) {
+            validateIndex(index);
+            const state = stateFor(indexes, index);
+            const deleted = state.documents.size;
+            state.documents.clear();
+            return { deleted };
+        },
+        async search(index, query) {
+            validateIndex(index);
+            validateQuery(query);
+            const state = stateFor(indexes, index);
+            const effectiveIndex = state.definition ?? index;
+            const queryText = query.query?.trim() ?? "";
+            const limit = query.limit ?? 20;
+            const offset = query.offset ?? 0;
+            const filtered = [...state.documents.values()]
+                .filter((document) => matchesFilters(document, query.filters))
+                .filter((document) => matchesQuery(document, effectiveIndex, queryText));
+            const sorted = sortDocuments(filtered, query.sort);
+            const hits = sorted.slice(offset, offset + limit).map(clone);
+            return {
+                hits,
+                query: queryText,
+                page: {
+                    kind: "offset",
+                    limit,
+                    offset,
+                    total: filtered.length,
+                    hasMore: offset + hits.length < filtered.length,
+                },
+                facets: buildFacets(sorted, query.facets),
+            };
+        },
+        reset(index) {
+            if (index) {
+                indexes.delete(index.name);
+                return;
+            }
+            indexes.clear();
+        },
+    };
+    return port;
+}
+/**
+ * Create a provider that contributes an in-memory search port.
+ */
+export function createMemorySearchProvider(options = {}) {
+    const { name = "memory-search", ...searchOptions } = options;
+    return createProvider({
+        name,
+        metadata: {
+            ports: ["search"],
+            watchers: ["search"],
+        },
+        setup({ ports }) {
+            const instrumentation = createProviderInstrumentation(ports, {
+                providerName: name,
+                watcher: "search",
+            });
+            return {
+                ports: {
+                    search: instrumentSearch(createMemorySearch(searchOptions), instrumentation),
+                },
+            };
+        },
+    });
+}
+function instrumentSearch(search, instrumentation) {
+    return {
+        async configureIndex(index) {
+            const startedAt = Date.now();
+            await search.configureIndex(index);
+            instrumentation.custom({
+                name: "search.configureIndex",
+                label: "Search index configured",
+                summary: index.name,
+                details: { index: index.name, durationMs: Date.now() - startedAt },
+            });
+        },
+        async indexDocuments(index, documents) {
+            const startedAt = Date.now();
+            const result = await search.indexDocuments(index, documents);
+            instrumentation.custom({
+                name: "search.indexDocuments",
+                label: "Search documents indexed",
+                summary: `${index.name}: ${result.indexed}`,
+                details: {
+                    index: index.name,
+                    indexed: result.indexed,
+                    durationMs: Date.now() - startedAt,
+                },
+            });
+            return result;
+        },
+        async deleteDocuments(index, ids) {
+            const startedAt = Date.now();
+            const result = await search.deleteDocuments(index, ids);
+            instrumentation.custom({
+                name: "search.deleteDocuments",
+                label: "Search documents deleted",
+                summary: `${index.name}: ${result.deleted}`,
+                details: {
+                    index: index.name,
+                    deleted: result.deleted,
+                    durationMs: Date.now() - startedAt,
+                },
+            });
+            return result;
+        },
+        async clearIndex(index) {
+            const startedAt = Date.now();
+            const result = await search.clearIndex(index);
+            instrumentation.custom({
+                name: "search.clearIndex",
+                label: "Search index cleared",
+                summary: `${index.name}: ${result.deleted}`,
+                details: {
+                    index: index.name,
+                    deleted: result.deleted,
+                    durationMs: Date.now() - startedAt,
+                },
+            });
+            return result;
+        },
+        async search(index, query) {
+            const startedAt = Date.now();
+            const result = await search.search(index, query);
+            instrumentation.custom({
+                name: "search.query",
+                label: "Search query",
+                summary: `${index.name}: ${result.query}`,
+                details: {
+                    index: index.name,
+                    query: result.query,
+                    hits: result.hits.length,
+                    total: result.page.total,
+                    durationMs: Date.now() - startedAt,
+                },
+            });
+            return result;
+        },
+    };
+}
+function stateFor(indexes, index) {
+    let state = indexes.get(index.name);
+    if (!state) {
+        state = { documents: new Map() };
+        indexes.set(index.name, state);
+    }
+    return state;
+}
+function validateIndex(index) {
+    if (!index.name)
+        throw new SearchOptionsError("Search index name is required.");
+    if (!index.primaryKey) {
+        throw new SearchOptionsError("Search index primaryKey is required.");
+    }
+}
+function validateDocument(index, document) {
+    const id = document[index.primaryKey];
+    if (typeof id !== "string" || id.length === 0) {
+        throw new SearchOptionsError(`Search document for index "${index.name}" must include a non-empty "${index.primaryKey}" string.`);
+    }
+}
+function validateQuery(query) {
+    if (query.limit !== undefined &&
+        (!Number.isFinite(query.limit) ||
+            !Number.isInteger(query.limit) ||
+            query.limit < 1)) {
+        throw new SearchOptionsError("Search query limit must be a positive integer.");
+    }
+    if (query.offset !== undefined &&
+        (!Number.isFinite(query.offset) ||
+            !Number.isInteger(query.offset) ||
+            query.offset < 0)) {
+        throw new SearchOptionsError("Search query offset must be a zero or greater integer.");
+    }
+}
+function matchesFilters(document, filters) {
+    if (!filters)
+        return true;
+    return Object.entries(filters).every(([field, expected]) => {
+        const actual = document[field];
+        return matchesFilterValue(actual, expected);
+    });
+}
+function matchesFilterValue(actual, expected) {
+    if (Array.isArray(expected)) {
+        if (Array.isArray(actual)) {
+            return actual.some((entry) => expected.some((expectedEntry) => expectedEntry === entry));
+        }
+        return expected.some((entry) => entry === actual);
+    }
+    if (Array.isArray(actual)) {
+        return actual.some((entry) => entry === expected);
+    }
+    return actual === expected;
+}
+function matchesQuery(document, index, query) {
+    if (!query)
+        return true;
+    const needle = query.toLowerCase();
+    const fields = index.searchableAttributes ??
+        Object.keys(document);
+    return fields.some((field) => searchableText(document[field])
+        .toLowerCase()
+        .includes(needle));
+}
+function sortDocuments(documents, sort) {
+    if (!sort || sort.length === 0)
+        return documents;
+    return [...documents].sort((left, right) => {
+        for (const expression of sort) {
+            const [field, direction = "asc"] = expression.split(":");
+            const result = compareValues(left[field], right[field]);
+            if (result !== 0) {
+                return direction === "desc" ? -result : result;
+            }
+        }
+        return 0;
+    });
+}
+function compareValues(left, right) {
+    if (left === right)
+        return 0;
+    if (left === undefined || left === null)
+        return 1;
+    if (right === undefined || right === null)
+        return -1;
+    if (typeof left === "number" && typeof right === "number") {
+        return left - right;
+    }
+    return String(left).localeCompare(String(right));
+}
+function buildFacets(documents, facets) {
+    if (!facets || facets.length === 0)
+        return undefined;
+    const result = {};
+    for (const facet of facets) {
+        const counts = {};
+        for (const document of documents) {
+            const value = document[facet];
+            const values = Array.isArray(value) ? value : [value];
+            for (const entry of values) {
+                if (entry === undefined || entry === null)
+                    continue;
+                const key = String(entry);
+                counts[key] = (counts[key] ?? 0) + 1;
+            }
+        }
+        result[facet] = counts;
+    }
+    return result;
+}
+function searchableText(value) {
+    if (value === undefined || value === null)
+        return "";
+    if (Array.isArray(value))
+        return value.map(searchableText).join(" ");
+    if (typeof value === "object") {
+        return Object.values(value).map(searchableText).join(" ");
+    }
+    return String(value);
+}
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

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

package/dist/server/hooks/error-reporting.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Error reporting hook utilities for @beignet/core/server
+ */
+import type { HttpContractConfig } from "../../contracts/index.js";
+import type { ErrorReporterPort, ErrorReportOptions } from "../../error-reporting/index.js";
+import type { HttpRequestLike, ServerCaughtErrorHook, ServerHook } from "../types.js";
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Minimal context shape used by `createErrorReportingHooks(...)`.
+ */
+export type ErrorReportingContext = {
+    ports?: {
+        errorReporter?: ErrorReporterPort;
+    };
+    requestId?: string;
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    traceparent?: string;
+    actor?: {
+        type?: string;
+        id?: string;
+    };
+    tenant?: {
+        id?: string;
+    };
+};
+/**
+ * Arguments passed to error reporting hook callbacks.
+ */
+export type ErrorReportingHookArgs<Ctx> = Parameters<ServerCaughtErrorHook<Ctx>>[0];
+/**
+ * Error reporter resolver accepted by `createErrorReportingHooks(...)`.
+ */
+export type ErrorReporterResolver<Ctx> = (args: ErrorReportingHookArgs<Ctx>) => MaybePromise<ErrorReporterPort | undefined>;
+/**
+ * Options accepted by `createErrorReportingHooks(...)`.
+ */
+export interface ErrorReportingHooksOptions<Ctx> {
+    /**
+     * Reporter to use instead of `ctx.ports.errorReporter`.
+     */
+    reporter?: ErrorReporterPort | ErrorReporterResolver<Ctx>;
+    /**
+     * Decide whether a caught error should be captured. The default reports
+     * unexpected failures and skips expected catalog/auth/validation outcomes.
+     */
+    shouldReport?: (args: ErrorReportingHookArgs<Ctx>) => MaybePromise<boolean>;
+    /**
+     * Additional capture options. These are merged over Beignet's request,
+     * actor, tenant, contract, and trace metadata.
+     */
+    reportOptions?: ErrorReportOptions | ((args: ErrorReportingHookArgs<Ctx>) => MaybePromise<ErrorReportOptions>);
+    /**
+     * Observer for reporter failures. Reporter failures are otherwise ignored so
+     * error reporting cannot change the HTTP response.
+     */
+    onReporterError?: (args: {
+        error: unknown;
+        reportingError: unknown;
+        ctx?: Ctx;
+        req: HttpRequestLike;
+        contract: HttpContractConfig;
+    }) => MaybePromise<void>;
+}
+/**
+ * Create server hooks that capture unexpected HTTP request failures through
+ * `ctx.ports.errorReporter`.
+ *
+ * The hook observes `onCaughtError`, never maps responses, and ignores capture
+ * failures by default so reporting cannot affect request handling.
+ */
+export declare function createErrorReportingHooks<Ctx extends ErrorReportingContext = ErrorReportingContext>(config?: ErrorReportingHooksOptions<Ctx>): ServerHook<Ctx>;
+/**
+ * Default filter for HTTP error reporting.
+ */
+export declare function shouldReportServerError(error: unknown): boolean;
+export {};
+//# sourceMappingURL=error-reporting.d.ts.map

package/dist/server/hooks/error-reporting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporting.d.ts","sourceRoot":"","sources":["../../../src/server/hooks/error-reporting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAYxC,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,iBAAiB,CAAC;KACnC,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,MAAM,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAAC,GAAG,IAAI,UAAU,CAClD,qBAAqB,CAAC,GAAG,CAAC,CAC3B,CAAC,CAAC,CAAC,CAAC;AAEL;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,GAAG,IAAI,CACvC,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC,KAC9B,YAAY,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,GAAG;IAC7C;;OAEG;IACH,QAAQ,CAAC,EAAE,iBAAiB,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC1D;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5E;;;OAGG;IACH,aAAa,CAAC,EACV,kBAAkB,GAClB,CAAC,CAAC,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC9E;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,KAAK,EAAE,OAAO,CAAC;QACf,cAAc,EAAE,OAAO,CAAC;QACxB,GAAG,CAAC,EAAE,GAAG,CAAC;QACV,GAAG,EAAE,eAAe,CAAC;QACrB,QAAQ,EAAE,kBAAkB,CAAC;KAC9B,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,SAAS,qBAAqB,GAAG,qBAAqB,EACzD,MAAM,GAAE,0BAA0B,CAAC,GAAG,CAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAsC/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU/D"}