@beignet/core 0.0.12 → 0.0.14

package/dist/ports/policy.js

@@ -71,6 +71,7 @@ export function definePolicy(policies) {
  */
 export function createGate(options) {
     const registry = new Map();
+    const observeDecision = createDecisionObserver(options.onDecision);
     for (const definition of options.policies) {
         for (const [ability, resolver] of Object.entries(definition.policies)) {
             if (registry.has(ability)) {
@@ -79,28 +80,73 @@ export function createGate(options) {
             registry.set(ability, resolver);
         }
     }
-    async function inspect(ctx, ability, subject) {
+    async function evaluate(ctx, ability, subject, source = "inspect", batchKey) {
+        const startedAt = policyNow();
         const resolver = registry.get(ability);
         if (!resolver) {
-            return deny({
+            const decision = deny({
                 reason: `No policy registered for "${ability}".`,
                 code: "POLICY_NOT_FOUND",
             });
+            observeDecision({
+                source,
+                batchKey,
+                ctx,
+                ability,
+                subject,
+                decision,
+                durationMs: policyNow() - startedAt,
+            });
+            return decision;
+        }
+        try {
+            const result = await resolver(ctx, subject);
+            const decision = normalizeDecision(result);
+            observeDecision({
+                source,
+                batchKey,
+                ctx,
+                ability,
+                subject,
+                decision,
+                durationMs: policyNow() - startedAt,
+            });
+            return decision;
+        }
+        catch (error) {
+            observeDecision({
+                source,
+                batchKey,
+                ctx,
+                ability,
+                subject,
+                error,
+                durationMs: policyNow() - startedAt,
+            });
+            throw error;
         }
-        const result = await resolver(ctx, subject);
-        return normalizeDecision(result);
     }
     async function authorize(ctx, ability, subject) {
-        const decision = await inspect(ctx, ability, subject);
+        const decision = await evaluate(ctx, ability, subject, "authorize");
         if (decision.allowed)
             return decision;
         const thrown = await options.onDeny?.(decision, { ctx, ability, subject });
         throw thrown ?? new GateAuthorizationError(decision);
     }
+    async function inspectMany(ctx, checks, source) {
+        const decisions = {};
+        for (const [batchKey, check] of Object.entries(checks)) {
+            const [ability, subject] = check;
+            decisions[batchKey] = await evaluate(ctx, ability, subject, source, batchKey);
+        }
+        return decisions;
+    }
     function bind(ctx) {
         return {
             can: async (ability, ...subject) => gate.can(ctx, ability, ...subject),
+            canMany: async (checks) => gate.canMany(ctx, checks),
             inspect: async (ability, ...subject) => gate.inspect(ctx, ability, ...subject),
+            inspectMany: async (checks) => gate.inspectMany(ctx, checks),
             authorize: async (ability, ...subject) => gate.authorize(ctx, ability, ...subject),
         };
     }
@@ -118,9 +164,19 @@ export function createGate(options) {
         bind,
         attach,
         async can(ctx, ability, ...subject) {
-            return (await inspect(ctx, ability, firstSubject(subject))).allowed;
+            return (await evaluate(ctx, ability, firstSubject(subject), "can"))
+                .allowed;
+        },
+        async canMany(ctx, checks) {
+            const decisions = await inspectMany(ctx, checks, "canMany");
+            const result = {};
+            for (const [key, decision] of Object.entries(decisions)) {
+                result[key] = decision.allowed;
+            }
+            return result;
         },
-        inspect: async (ctx, ability, ...subject) => inspect(ctx, ability, firstSubject(subject)),
+        inspect: async (ctx, ability, ...subject) => evaluate(ctx, ability, firstSubject(subject), "inspect"),
+        inspectMany: async (ctx, checks) => inspectMany(ctx, checks, "inspectMany"),
         authorize: async (ctx, ability, ...subject) => authorize(ctx, ability, firstSubject(subject)),
     };
     return gate;
@@ -134,4 +190,43 @@ function normalizeDecision(result) {
 function firstSubject(subject) {
     return subject[0];
 }
+function policyNow() {
+    return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+function contextStringField(ctx, field) {
+    if (!ctx || typeof ctx !== "object")
+        return undefined;
+    const value = ctx[field];
+    return typeof value === "string" ? value : undefined;
+}
+function enrichObservation(observation) {
+    return {
+        ...observation,
+        requestId: contextStringField(observation.ctx, "requestId"),
+        traceId: contextStringField(observation.ctx, "traceId"),
+        spanId: contextStringField(observation.ctx, "spanId"),
+        parentSpanId: contextStringField(observation.ctx, "parentSpanId"),
+        traceparent: contextStringField(observation.ctx, "traceparent"),
+    };
+}
+function isPromiseLike(value) {
+    return (value !== null &&
+        (typeof value === "object" || typeof value === "function") &&
+        typeof value.then === "function");
+}
+function createDecisionObserver(observer) {
+    return (observation) => {
+        if (!observer)
+            return;
+        try {
+            const result = observer(enrichObservation(observation));
+            if (isPromiseLike(result)) {
+                Promise.resolve(result).catch(() => undefined);
+            }
+        }
+        catch {
+            // Observers are diagnostic only and must not affect authorization.
+        }
+    };
+}
 //# sourceMappingURL=policy.js.map

package/dist/ports/policy.js.map

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

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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"}