raffel 0.1.2

package/dist/adapters/s3db/types.d.ts

@@ -0,0 +1,277 @@
+/**
+ * S3DB Resource Adapter Types
+ *
+ * Types for integrating s3db.js resources with Raffel.
+ */
+import type { Context } from '../../types/index.js';
+/**
+ * Minimal interface matching s3db.js ResourceLike
+ * (we don't import directly to avoid coupling)
+ */
+export interface S3DBResourceLike {
+    /** Resource name (e.g., 'users', 'posts') */
+    name: string;
+    /** Resource version */
+    version?: string;
+    /** Resource configuration */
+    config?: {
+        currentVersion?: string;
+        attributes?: Record<string, unknown>;
+        partitions?: Record<string, unknown>;
+        api?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    /** Schema definition */
+    schema?: {
+        attributes?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    /** API schema with guards and protected fields */
+    $schema?: {
+        api?: {
+            guard?: S3DBGuardsConfig;
+            protected?: string[];
+            description?: unknown;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    /** Relation definitions */
+    _relations?: Record<string, S3DBRelationDefinition>;
+    /** Reference to parent database */
+    database?: S3DBDatabaseLike;
+    /** List records with pagination */
+    list(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    /** List from a specific partition */
+    listPartition(options: {
+        partition: string;
+        partitionValues: unknown;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    /** Query with filters */
+    query(filters: Record<string, unknown>, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>[]>;
+    /** Get single record by ID */
+    get(id: string, options?: {
+        include?: string[];
+    }): Promise<Record<string, unknown> | null>;
+    /** Get from specific partition */
+    getFromPartition(options: {
+        id: string;
+        partitionName: string;
+        partitionValues: unknown;
+    }): Promise<Record<string, unknown> | null>;
+    /** Insert new record */
+    insert(data: Record<string, unknown>, options?: {
+        user?: unknown;
+        request?: unknown;
+    }): Promise<Record<string, unknown>>;
+    /** Update existing record */
+    update(id: string, data: Record<string, unknown>, options?: {
+        user?: unknown;
+        request?: unknown;
+    }): Promise<Record<string, unknown>>;
+    /** Delete record by ID */
+    delete(id: string): Promise<void>;
+    /** Count total records */
+    count(): Promise<number>;
+}
+export interface S3DBDatabaseLike {
+    resources?: Record<string, S3DBResourceLike>;
+    logger?: unknown;
+}
+export interface S3DBRelationDefinition {
+    type: 'hasOne' | 'hasMany' | 'belongsTo' | 'belongsToMany';
+    resource: string;
+    foreignKey?: string;
+    [key: string]: unknown;
+}
+export interface S3DBGuardsConfig {
+    list?: S3DBGuardDefinition;
+    get?: S3DBGuardDefinition;
+    create?: S3DBGuardDefinition;
+    update?: S3DBGuardDefinition;
+    delete?: S3DBGuardDefinition;
+    [key: string]: S3DBGuardDefinition | undefined;
+}
+export interface S3DBGuardDefinition {
+    roles?: string[];
+    permissions?: string[];
+    custom?: (ctx: unknown) => boolean | Promise<boolean>;
+    [key: string]: unknown;
+}
+/**
+ * Guard types for flexible authorization
+ */
+import type { Guard, GuardsConfig as BaseGuardsConfig } from './utils/guards.js';
+export { Guard };
+export type S3DBGuardsOptions = BaseGuardsConfig;
+/**
+ * Resource event data
+ */
+export interface S3DBResourceEvent {
+    /** Resource name */
+    resource: string;
+    /** Operation type */
+    operation: 'created' | 'updated' | 'deleted';
+    /** Record ID */
+    id: string;
+    /** Current/new record data */
+    data?: Record<string, unknown>;
+    /** Previous record data (for update/delete) */
+    previous?: Record<string, unknown>;
+    /** User who performed the action */
+    user?: unknown;
+    /** Event timestamp */
+    timestamp: number;
+}
+/**
+ * Event callback type
+ */
+export type S3DBEventCallback = (event: S3DBResourceEvent) => void | Promise<void>;
+/**
+ * Options for creating S3DB resource routes
+ */
+export interface S3DBAdapterOptions {
+    /** Base path prefix (e.g., '/api/v1') */
+    basePath?: string;
+    /** HTTP methods to enable */
+    methods?: Array<'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD'>;
+    /** Transform request context to s3db user object */
+    contextToUser?: (ctx: Context) => unknown;
+    /**
+     * Flexible guards system for authorization.
+     * Supports roles, scopes with wildcards, and custom functions.
+     *
+     * @example
+     * ```ts
+     * guards: {
+     *   read: true,  // Allow all reads
+     *   write: { role: 'admin' },  // Only admins can write
+     *   delete: (ctx) => ctx.auth?.role === 'superadmin',  // Custom check
+     * }
+     * ```
+     */
+    guards?: S3DBGuardsOptions;
+    /** Protected fields to filter from responses */
+    protectedFields?: string[];
+    /** Enable ETag support for caching and concurrency (default: true) */
+    enableETag?: boolean;
+    /** Enable pagination headers (default: true) */
+    enablePaginationHeaders?: boolean;
+    /**
+     * Event callback when a record is created.
+     */
+    onCreated?: S3DBEventCallback;
+    /**
+     * Event callback when a record is updated.
+     * Includes previous state.
+     */
+    onUpdated?: S3DBEventCallback;
+    /**
+     * Event callback when a record is deleted.
+     * Includes the deleted record.
+     */
+    onDeleted?: S3DBEventCallback;
+    /**
+     * Function to get related resources by name.
+     * Required for populate validation in nested relations.
+     */
+    getResource?: (name: string) => S3DBResourceLike | undefined;
+}
+/**
+ * Input types for generated procedures
+ */
+export interface S3DBListInput {
+    limit?: number;
+    offset?: number;
+    filters?: Record<string, unknown>;
+    partition?: string;
+    partitionValues?: unknown;
+    /** Relations to populate (e.g., ['author', 'comments.user']) */
+    populate?: string | string[];
+}
+export interface S3DBGetInput {
+    id: string;
+    include?: string[];
+    partition?: string;
+    partitionValues?: unknown;
+    /** Relations to populate (e.g., ['author', 'comments.user']) */
+    populate?: string | string[];
+    /** If-None-Match header value for cache validation */
+    ifNoneMatch?: string;
+}
+export interface S3DBHeadItemInput {
+    id: string;
+    /** If-None-Match header value for cache validation */
+    ifNoneMatch?: string;
+}
+export interface S3DBUpdateInput {
+    id: string;
+    data: Record<string, unknown>;
+    partial?: boolean;
+    /** If-Match header value for optimistic concurrency */
+    ifMatch?: string;
+    /** Prefer: return=minimal */
+    preferMinimal?: boolean;
+}
+export interface S3DBCreateInput {
+    data: Record<string, unknown>;
+    /** Prefer: return=minimal */
+    preferMinimal?: boolean;
+}
+export interface S3DBDeleteInput {
+    id: string;
+    /** If-Match header value for optimistic concurrency */
+    ifMatch?: string;
+}
+/**
+ * Response types
+ */
+export interface S3DBListResponse {
+    data: Record<string, unknown>[];
+    pagination: {
+        total: number;
+        page: number;
+        pageSize: number;
+        pageCount: number;
+    };
+}
+export interface S3DBSingleResponse {
+    data: Record<string, unknown>;
+    /** ETag for the record */
+    etag?: string;
+    /** Whether minimal response was applied */
+    preferenceApplied?: 'return=minimal';
+}
+export interface S3DBDeleteResponse {
+    success: boolean;
+}
+export interface S3DBOptionsResponse {
+    resource: string;
+    methods: string[];
+    operations: {
+        list: boolean;
+        get: boolean;
+        count: boolean;
+        create: boolean;
+        update: boolean;
+        patch: boolean;
+        delete: boolean;
+        head: boolean;
+        options: boolean;
+    };
+}
+export interface S3DBHeadResponse {
+    total: number;
+    page: number;
+    pageSize: number;
+    pageCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/s3db/types.d.ts.map

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

package/dist/adapters/s3db/types.js

@@ -0,0 +1,7 @@
+/**
+ * S3DB Resource Adapter Types
+ *
+ * Types for integrating s3db.js resources with Raffel.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/s3db/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/s3db/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/adapters/s3db/utils/etag.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ETag Utilities for S3DB Adapter
+ *
+ * Provides ETag generation and validation for HTTP caching
+ * and optimistic concurrency control.
+ */
+/**
+ * Generate a weak ETag for a record based on its content.
+ *
+ * Uses MD5 hash of JSON-stringified content, truncated to 16 chars.
+ * Weak ETags (W/"...") indicate semantic equivalence, not byte-for-byte.
+ *
+ * @example
+ * ```ts
+ * const etag = generateETag({ id: '123', name: 'John' })
+ * // => 'W/"a1b2c3d4e5f6g7h8"'
+ * ```
+ */
+export declare function generateETag(record: Record<string, unknown>): string;
+/**
+ * Validate If-Match header against current ETag.
+ *
+ * Used for PUT/PATCH/DELETE to prevent lost updates.
+ * Returns true if the ETag matches (operation should proceed).
+ *
+ * Supports:
+ * - Single ETag: `"abc123"`
+ * - Multiple ETags: `"abc123", "def456"`
+ * - Wildcard: `*`
+ * - Weak ETags: `W/"abc123"`
+ *
+ * @example
+ * ```ts
+ * validateIfMatch('"abc123"', 'W/"abc123"') // true
+ * validateIfMatch('*', 'W/"anything"')       // true
+ * validateIfMatch('"old"', 'W/"new"')        // false
+ * ```
+ */
+export declare function validateIfMatch(ifMatch: string, currentETag: string): boolean;
+/**
+ * Validate If-None-Match header against current ETag.
+ *
+ * Used for GET/HEAD to enable cache validation (304 Not Modified).
+ * Returns true if the ETag does NOT match (fresh response needed).
+ * Returns false if ETag matches (304 should be returned).
+ *
+ * @example
+ * ```ts
+ * validateIfNoneMatch('"abc123"', 'W/"abc123"') // false (return 304)
+ * validateIfNoneMatch('"old"', 'W/"new"')        // true (return fresh)
+ * validateIfNoneMatch('*', 'W/"anything"')       // false (return 304)
+ * ```
+ */
+export declare function validateIfNoneMatch(ifNoneMatch: string, currentETag: string): boolean;
+/**
+ * Format a Date as HTTP Last-Modified header value.
+ *
+ * @example
+ * ```ts
+ * formatLastModified(new Date('2025-01-01'))
+ * // => 'Wed, 01 Jan 2025 00:00:00 GMT'
+ * ```
+ */
+export declare function formatLastModified(date: Date | string): string;
+//# sourceMappingURL=etag.d.ts.map

package/dist/adapters/s3db/utils/etag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../../../src/adapters/s3db/utils/etag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAIpE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAe7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAiBrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAG9D"}

package/dist/adapters/s3db/utils/etag.js

@@ -0,0 +1,99 @@
+/**
+ * ETag Utilities for S3DB Adapter
+ *
+ * Provides ETag generation and validation for HTTP caching
+ * and optimistic concurrency control.
+ */
+import { createHash } from 'crypto';
+/**
+ * Generate a weak ETag for a record based on its content.
+ *
+ * Uses MD5 hash of JSON-stringified content, truncated to 16 chars.
+ * Weak ETags (W/"...") indicate semantic equivalence, not byte-for-byte.
+ *
+ * @example
+ * ```ts
+ * const etag = generateETag({ id: '123', name: 'John' })
+ * // => 'W/"a1b2c3d4e5f6g7h8"'
+ * ```
+ */
+export function generateETag(record) {
+    const content = JSON.stringify(record);
+    const hash = createHash('md5').update(content).digest('hex').slice(0, 16);
+    return `W/"${hash}"`;
+}
+/**
+ * Validate If-Match header against current ETag.
+ *
+ * Used for PUT/PATCH/DELETE to prevent lost updates.
+ * Returns true if the ETag matches (operation should proceed).
+ *
+ * Supports:
+ * - Single ETag: `"abc123"`
+ * - Multiple ETags: `"abc123", "def456"`
+ * - Wildcard: `*`
+ * - Weak ETags: `W/"abc123"`
+ *
+ * @example
+ * ```ts
+ * validateIfMatch('"abc123"', 'W/"abc123"') // true
+ * validateIfMatch('*', 'W/"anything"')       // true
+ * validateIfMatch('"old"', 'W/"new"')        // false
+ * ```
+ */
+export function validateIfMatch(ifMatch, currentETag) {
+    // Wildcard matches everything
+    if (ifMatch.trim() === '*') {
+        return true;
+    }
+    // Normalize current ETag (remove W/ prefix for comparison)
+    const normalizedCurrent = currentETag.replace(/^W\//, '').replace(/"/g, '');
+    // Parse multiple ETags
+    const etags = ifMatch.split(',').map((e) => {
+        return e.trim().replace(/^W\//, '').replace(/"/g, '');
+    });
+    return etags.some((e) => e === normalizedCurrent);
+}
+/**
+ * Validate If-None-Match header against current ETag.
+ *
+ * Used for GET/HEAD to enable cache validation (304 Not Modified).
+ * Returns true if the ETag does NOT match (fresh response needed).
+ * Returns false if ETag matches (304 should be returned).
+ *
+ * @example
+ * ```ts
+ * validateIfNoneMatch('"abc123"', 'W/"abc123"') // false (return 304)
+ * validateIfNoneMatch('"old"', 'W/"new"')        // true (return fresh)
+ * validateIfNoneMatch('*', 'W/"anything"')       // false (return 304)
+ * ```
+ */
+export function validateIfNoneMatch(ifNoneMatch, currentETag) {
+    // Wildcard means "return 304 if resource exists"
+    if (ifNoneMatch.trim() === '*') {
+        return false;
+    }
+    // Normalize current ETag
+    const normalizedCurrent = currentETag.replace(/^W\//, '').replace(/"/g, '');
+    // Parse multiple ETags
+    const etags = ifNoneMatch.split(',').map((e) => {
+        return e.trim().replace(/^W\//, '').replace(/"/g, '');
+    });
+    // Return true if NONE match (fresh response needed)
+    // Return false if ANY match (304 should be returned)
+    return !etags.some((e) => e === normalizedCurrent);
+}
+/**
+ * Format a Date as HTTP Last-Modified header value.
+ *
+ * @example
+ * ```ts
+ * formatLastModified(new Date('2025-01-01'))
+ * // => 'Wed, 01 Jan 2025 00:00:00 GMT'
+ * ```
+ */
+export function formatLastModified(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return d.toUTCString();
+}
+//# sourceMappingURL=etag.js.map

package/dist/adapters/s3db/utils/etag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.js","sourceRoot":"","sources":["../../../../src/adapters/s3db/utils/etag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACzE,OAAO,MAAM,IAAI,GAAG,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,WAAmB;IAClE,8BAA8B;IAC9B,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,2DAA2D;IAC3D,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAE3E,uBAAuB;IACvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAA;AACnD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,WAAmB;IAC1E,iDAAiD;IACjD,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,yBAAyB;IACzB,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAE3E,uBAAuB;IACvB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7C,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,oDAAoD;IACpD,qDAAqD;IACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAA;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1D,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;AACxB,CAAC"}

package/dist/adapters/s3db/utils/guards.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Guards System for S3DB Adapter
+ *
+ * Provides flexible authorization guards supporting:
+ * - Boolean (allow/deny)
+ * - Scope strings with wildcards
+ * - Role-based access
+ * - Custom functions
+ */
+import type { Context } from '../../../types/index.js';
+/**
+ * User information expected in auth context.
+ */
+export interface GuardUser {
+    id?: string;
+    role?: string;
+    roles?: string[];
+    scopes?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Guard function signature.
+ * Can optionally receive the record being accessed for record-level guards.
+ */
+export type GuardFunction = (ctx: Context, record?: Record<string, unknown> | null) => boolean | Promise<boolean>;
+/**
+ * Guard object with role, scopes, and/or custom check.
+ */
+export interface GuardObject {
+    /** Required role(s). User must have at least one. */
+    role?: string | string[];
+    /** Required scopes. User must have ALL specified scopes. */
+    scopes?: string | string[];
+    /** Custom check function. */
+    check?: GuardFunction;
+}
+/**
+ * Guard can be:
+ * - boolean: true = allow, false = deny
+ * - string: scope check (e.g., "users:read")
+ * - string[]: any scope matches (OR)
+ * - GuardFunction: custom function
+ * - GuardObject: role + scopes + check
+ * - null/undefined: no guard (allow)
+ */
+export type Guard = boolean | string | string[] | GuardFunction | GuardObject | null | undefined;
+/**
+ * Guards configuration per operation.
+ */
+export interface GuardsConfig {
+    /** Guard for list operation */
+    list?: Guard;
+    /** Guard for get operation */
+    get?: Guard;
+    /** Guard for count operation */
+    count?: Guard;
+    /** Guard for create operation */
+    create?: Guard;
+    /** Guard for update operation (PUT) */
+    update?: Guard;
+    /** Guard for patch operation (PATCH) - falls back to update */
+    patch?: Guard;
+    /** Guard for delete operation */
+    delete?: Guard;
+    /** Guard for head operation */
+    head?: Guard;
+    /** Guard for options operation */
+    options?: Guard;
+    /** Alias for read operations (list, get, count, head) */
+    read?: Guard;
+    /** Alias for write operations (create, update, patch, delete) */
+    write?: Guard;
+    /** Fallback guard for all operations */
+    all?: Guard;
+}
+/**
+ * S3DB operation names.
+ */
+export type S3DBOperation = 'list' | 'get' | 'count' | 'create' | 'update' | 'patch' | 'delete' | 'head' | 'options';
+/**
+ * Check if a user has a specific scope, supporting wildcards.
+ *
+ * Wildcards:
+ * - `users:*` matches `users:read`, `users:write`, etc.
+ * - `*` matches everything
+ *
+ * @example
+ * ```ts
+ * hasScope({ scopes: ['users:*'] }, 'users:read')  // true
+ * hasScope({ scopes: ['admin'] }, 'users:read')   // false
+ * hasScope({ scopes: ['*'] }, 'anything')         // true
+ * ```
+ */
+export declare function hasScope(user: GuardUser | null | undefined, scope: string): boolean;
+/**
+ * Check if a user has a specific role.
+ *
+ * Checks both `role` (string) and `roles` (array) properties.
+ */
+export declare function hasRole(user: GuardUser | null | undefined, role: string): boolean;
+/**
+ * Check if a user has any of the specified roles.
+ */
+export declare function hasAnyRole(user: GuardUser | null | undefined, roles: string[]): boolean;
+/**
+ * Check a guard against the context and optional record.
+ *
+ * @returns true if allowed, false if denied
+ */
+export declare function checkGuard(guard: Guard, ctx: Context, record?: Record<string, unknown> | null): Promise<boolean>;
+/**
+ * Get the guard for a specific operation, with fallback resolution.
+ *
+ * Resolution order:
+ * 1. Exact operation match (e.g., `guards.list`)
+ * 2. Alias match (e.g., `guards.read` for list/get)
+ * 3. All fallback (e.g., `guards.all`)
+ * 4. No guard (allow)
+ */
+export declare function getOperationGuard(guards: GuardsConfig | null | undefined, operation: S3DBOperation): Guard;
+//# sourceMappingURL=guards.d.ts.map

package/dist/adapters/s3db/utils/guards.d.ts.map

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