raffel 0.1.2

package/dist/adapters/s3db/adapter.js

@@ -0,0 +1,539 @@
+/**
+ * S3DB Resource Adapter
+ *
+ * Converts s3db.js resources into Raffel procedures with full RESTful support.
+ *
+ * Features:
+ * - RESTful CRUD operations (list, get, create, update, patch, delete)
+ * - ETag support for caching and optimistic concurrency
+ * - Flexible guards system for authorization (roles, scopes, custom functions)
+ * - Relations/populate for expanding related records
+ * - Event callbacks (onCreated, onUpdated, onDeleted)
+ * - Prefer header support (return=minimal)
+ * - HEAD endpoints for metadata
+ * - Enhanced OPTIONS with full resource metadata
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from 'raffel'
+ * import { createS3DBAdapter } from 'raffel/adapters/s3db'
+ * import { Database } from 's3db.js'
+ *
+ * const db = new Database({ bucket: 'my-bucket' })
+ * const users = db.createResource('users', { ... })
+ *
+ * const server = createServer({ port: 3000 })
+ *   .enableHttp()
+ *   .mount('api/v1', createS3DBAdapter(users, {
+ *     guards: {
+ *       read: true,  // Allow all reads
+ *       write: { role: 'admin' },  // Only admins can write
+ *     },
+ *     onCreated: (event) => console.log('Created:', event.id),
+ *   }))
+ * ```
+ */
+import { Errors } from '../../errors/index.js';
+import { createRouterModule } from '../../server/router-module.js';
+import { generateETag, validateIfMatch, validateIfNoneMatch, checkGuard, getOperationGuard, parsePopulate, resolvePopulate, hasRelations, getRelationNames, } from './utils/index.js';
+/**
+ * Filter protected fields from a record
+ */
+function filterProtectedFields(data, protectedFields) {
+    if (protectedFields.length === 0)
+        return data;
+    const filter = (record) => {
+        const filtered = {};
+        for (const [key, value] of Object.entries(record)) {
+            if (!protectedFields.includes(key)) {
+                filtered[key] = value;
+            }
+        }
+        return filtered;
+    };
+    if (Array.isArray(data)) {
+        return data.map(filter);
+    }
+    return filter(data);
+}
+/**
+ * Check authorization for an operation using guards
+ */
+async function checkAuthorization(operation, resourceName, ctx, options, record) {
+    if (options.guards) {
+        const guard = getOperationGuard(options.guards, operation);
+        const allowed = await checkGuard(guard, ctx, record);
+        if (!allowed) {
+            throw Errors.forbidden(`Not authorized to ${operation} ${resourceName}`);
+        }
+    }
+}
+/**
+ * Emit an event callback if configured
+ */
+async function emitEvent(type, options, resourceName, id, data, previous, user) {
+    const callback = type === 'created'
+        ? options.onCreated
+        : type === 'updated'
+            ? options.onUpdated
+            : options.onDeleted;
+    if (!callback)
+        return;
+    const event = {
+        resource: resourceName,
+        operation: type,
+        id,
+        data,
+        previous,
+        user,
+        timestamp: Date.now(),
+    };
+    try {
+        await callback(event);
+    }
+    catch {
+        // Event callbacks should not break the main flow
+        // In production, this would be logged
+    }
+}
+/**
+ * Create procedures for a single s3db resource
+ */
+function registerResourceProcedures(module, resource, options) {
+    const { methods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD'], contextToUser = (ctx) => ctx.auth, protectedFields = [], enableETag = true, enablePaginationHeaders = true, getResource, } = options;
+    const resourceName = resource.name;
+    // Merge protected fields from resource schema
+    const schemaProtected = resource.$schema?.api?.protected || [];
+    const allProtectedFields = [...new Set([...protectedFields, ...schemaProtected])];
+    // Create resource group
+    const group = module.group(resourceName);
+    // === LIST ===
+    if (methods.includes('GET')) {
+        group
+            .procedure('list')
+            .handler(async (rawInput, ctx) => {
+            const input = rawInput;
+            // Authorization check using guards
+            await checkAuthorization('list', resourceName, ctx, options);
+            const { limit = 100, offset = 0, filters, partition, partitionValues, populate } = input;
+            // Validate populate paths if provided
+            const populatePaths = parsePopulate(populate);
+            let _includeOptions;
+            if (populatePaths.length > 0) {
+                const populateResult = resolvePopulate(resource, populatePaths, getResource);
+                if (populateResult.errors?.length) {
+                    throw Errors.badRequest(populateResult.errors.join('; '));
+                }
+                // Convert to s3db include format (just relation names for now)
+                _includeOptions = { include: populatePaths };
+            }
+            let items;
+            let total;
+            if (partition && partitionValues) {
+                // Partition-based query
+                items = await resource.listPartition({
+                    partition,
+                    partitionValues,
+                    limit,
+                    offset,
+                });
+                total = items.length;
+            }
+            else if (filters && Object.keys(filters).length > 0) {
+                // Filtered query
+                items = await resource.query(filters, { limit, offset });
+                total = items.length;
+            }
+            else {
+                // Full list
+                items = await resource.list({ limit, offset });
+                total = items.length;
+            }
+            const filteredItems = filterProtectedFields(items, allProtectedFields);
+            return {
+                data: filteredItems,
+                pagination: {
+                    total,
+                    page: Math.floor(offset / limit) + 1,
+                    pageSize: limit,
+                    pageCount: Math.ceil(total / limit),
+                },
+            };
+        });
+        // === GET by ID ===
+        group
+            .procedure('get')
+            .handler(async (rawInput, ctx) => {
+            const input = rawInput;
+            // Authorization check using guards
+            await checkAuthorization('get', resourceName, ctx, options);
+            const { id, include, partition, partitionValues, populate, ifNoneMatch } = input;
+            // Build include options from populate or direct include
+            const populatePaths = parsePopulate(populate);
+            let includeOpts;
+            if (populatePaths.length > 0) {
+                const populateResult = resolvePopulate(resource, populatePaths, getResource);
+                if (populateResult.errors?.length) {
+                    throw Errors.badRequest(populateResult.errors.join('; '));
+                }
+                includeOpts = { include: populatePaths };
+            }
+            else if (include) {
+                includeOpts = { include };
+            }
+            let item;
+            if (partition && partitionValues) {
+                item = await resource.getFromPartition({
+                    id,
+                    partitionName: partition,
+                    partitionValues,
+                });
+            }
+            else {
+                item = await resource.get(id, includeOpts);
+            }
+            if (!item) {
+                throw Errors.notFound(resourceName, id);
+            }
+            const filteredItem = filterProtectedFields(item, allProtectedFields);
+            // Generate ETag if enabled
+            const etag = enableETag ? generateETag(filteredItem) : undefined;
+            // Check If-None-Match for cache validation (304 Not Modified)
+            if (enableETag && ifNoneMatch && etag) {
+                const needsFreshResponse = validateIfNoneMatch(ifNoneMatch, etag);
+                if (!needsFreshResponse) {
+                    // Return 304 - client's cache is still valid
+                    // In HTTP this would be a 304 response; in RPC we return minimal data
+                    return { data: {}, etag, preferenceApplied: 'return=minimal' };
+                }
+            }
+            return { data: filteredItem, etag };
+        });
+        // === COUNT ===
+        group
+            .procedure('count')
+            .handler(async (_input, ctx) => {
+            // Authorization check using guards (count uses 'count' operation)
+            await checkAuthorization('count', resourceName, ctx, options);
+            const count = await resource.count();
+            return { count };
+        });
+        // === HEAD (collection metadata) ===
+        if (methods.includes('HEAD')) {
+            group
+                .procedure('head')
+                .handler(async (rawInput, ctx) => {
+                const input = rawInput;
+                // Authorization check using guards
+                await checkAuthorization('head', resourceName, ctx, options);
+                const { limit = 100, offset = 0 } = input;
+                const total = await resource.count();
+                return {
+                    total,
+                    page: Math.floor(offset / limit) + 1,
+                    pageSize: limit,
+                    pageCount: Math.ceil(total / limit) || 1,
+                };
+            });
+            // === HEAD Item (single record metadata with ETag) ===
+            group
+                .procedure('headItem')
+                .handler(async (rawInput, ctx) => {
+                const input = rawInput;
+                // Authorization check using guards
+                await checkAuthorization('head', resourceName, ctx, options);
+                const { id, ifNoneMatch } = input;
+                const item = await resource.get(id);
+                if (!item) {
+                    return { exists: false };
+                }
+                const filteredItem = filterProtectedFields(item, allProtectedFields);
+                // Generate ETag if enabled
+                const etag = enableETag ? generateETag(filteredItem) : undefined;
+                // Check If-None-Match for cache validation
+                if (enableETag && ifNoneMatch && etag) {
+                    const needsFreshResponse = validateIfNoneMatch(ifNoneMatch, etag);
+                    if (!needsFreshResponse) {
+                        // Cache is still valid
+                        return { etag, exists: true };
+                    }
+                }
+                return { etag, exists: true };
+            });
+        }
+    }
+    // === OPTIONS ===
+    if (methods.includes('OPTIONS')) {
+        group
+            .procedure('options')
+            .handler(async (_input, ctx) => {
+            // Authorization check using guards
+            await checkAuthorization('options', resourceName, ctx, options);
+            // Determine which operations are available based on methods config
+            const availableMethods = [];
+            if (methods.includes('GET'))
+                availableMethods.push('GET');
+            if (methods.includes('POST'))
+                availableMethods.push('POST');
+            if (methods.includes('PUT'))
+                availableMethods.push('PUT');
+            if (methods.includes('PATCH'))
+                availableMethods.push('PATCH');
+            if (methods.includes('DELETE'))
+                availableMethods.push('DELETE');
+            if (methods.includes('HEAD'))
+                availableMethods.push('HEAD');
+            if (methods.includes('OPTIONS'))
+                availableMethods.push('OPTIONS');
+            // Get relation names if resource has relations
+            const relations = hasRelations(resource) ? getRelationNames(resource) : undefined;
+            // Build enhanced response
+            return {
+                resource: resourceName,
+                version: resource.version,
+                methods: availableMethods,
+                operations: {
+                    list: methods.includes('GET'),
+                    get: methods.includes('GET'),
+                    count: methods.includes('GET'),
+                    create: methods.includes('POST'),
+                    update: methods.includes('PUT'),
+                    patch: methods.includes('PATCH'),
+                    delete: methods.includes('DELETE'),
+                    head: methods.includes('HEAD'),
+                    options: methods.includes('OPTIONS'),
+                },
+                features: {
+                    etag: enableETag,
+                    pagination: enablePaginationHeaders,
+                    populate: hasRelations(resource),
+                    guards: !!options.guards,
+                    events: !!(options.onCreated || options.onUpdated || options.onDeleted),
+                },
+                relations,
+                schema: resource.schema?.attributes,
+            };
+        });
+    }
+    // === CREATE ===
+    if (methods.includes('POST')) {
+        group
+            .procedure('create')
+            .handler(async (rawInput, ctx) => {
+            const input = rawInput;
+            // Authorization check using guards
+            await checkAuthorization('create', resourceName, ctx, options);
+            const user = contextToUser(ctx);
+            const item = await resource.insert(input.data, { user });
+            const filteredItem = filterProtectedFields(item, allProtectedFields);
+            // Generate ETag if enabled
+            const etag = enableETag ? generateETag(filteredItem) : undefined;
+            // Emit created event
+            const itemId = String(item.id ?? item._id ?? '');
+            await emitEvent('created', options, resourceName, itemId, filteredItem, undefined, user);
+            // Handle Prefer: return=minimal
+            if (input.preferMinimal) {
+                return { data: { id: itemId }, etag, preferenceApplied: 'return=minimal' };
+            }
+            return { data: filteredItem, etag };
+        });
+    }
+    // === UPDATE (PUT - full replacement) ===
+    if (methods.includes('PUT')) {
+        group
+            .procedure('update')
+            .handler(async (rawInput, ctx) => {
+            const input = rawInput;
+            // Authorization check using guards
+            await checkAuthorization('update', resourceName, ctx, options);
+            const { id, data, ifMatch, preferMinimal } = input;
+            // Check existence
+            const existing = await resource.get(id);
+            if (!existing) {
+                throw Errors.notFound(resourceName, id);
+            }
+            const existingFiltered = filterProtectedFields(existing, allProtectedFields);
+            // Validate If-Match for optimistic concurrency
+            if (enableETag && ifMatch) {
+                const currentETag = generateETag(existingFiltered);
+                if (!validateIfMatch(ifMatch, currentETag)) {
+                    throw Errors.preconditionFailed(`ETag mismatch - record has been modified`);
+                }
+            }
+            const user = contextToUser(ctx);
+            const updated = await resource.update(id, data, { user });
+            const filteredItem = filterProtectedFields(updated, allProtectedFields);
+            // Generate new ETag
+            const etag = enableETag ? generateETag(filteredItem) : undefined;
+            // Emit updated event with previous state
+            await emitEvent('updated', options, resourceName, id, filteredItem, existingFiltered, user);
+            // Handle Prefer: return=minimal
+            if (preferMinimal) {
+                return { data: { id }, etag, preferenceApplied: 'return=minimal' };
+            }
+            return { data: filteredItem, etag };
+        });
+    }
+    // === PATCH (partial update) ===
+    if (methods.includes('PATCH')) {
+        group
+            .procedure('patch')
+            .handler(async (rawInput, ctx) => {
+            const input = rawInput;
+            // Authorization check using guards (patch has its own operation)
+            await checkAuthorization('patch', resourceName, ctx, options);
+            const { id, data, ifMatch, preferMinimal } = input;
+            // Check existence and merge
+            const existing = await resource.get(id);
+            if (!existing) {
+                throw Errors.notFound(resourceName, id);
+            }
+            const existingFiltered = filterProtectedFields(existing, allProtectedFields);
+            // Validate If-Match for optimistic concurrency
+            if (enableETag && ifMatch) {
+                const currentETag = generateETag(existingFiltered);
+                if (!validateIfMatch(ifMatch, currentETag)) {
+                    throw Errors.preconditionFailed(`ETag mismatch - record has been modified`);
+                }
+            }
+            const merged = { ...existing, ...data, id };
+            const user = contextToUser(ctx);
+            const updated = await resource.update(id, merged, { user });
+            const filteredItem = filterProtectedFields(updated, allProtectedFields);
+            // Generate new ETag
+            const etag = enableETag ? generateETag(filteredItem) : undefined;
+            // Emit updated event with previous state
+            await emitEvent('updated', options, resourceName, id, filteredItem, existingFiltered, user);
+            // Handle Prefer: return=minimal
+            if (preferMinimal) {
+                return { data: { id }, etag, preferenceApplied: 'return=minimal' };
+            }
+            return { data: filteredItem, etag };
+        });
+    }
+    // === DELETE ===
+    if (methods.includes('DELETE')) {
+        group
+            .procedure('delete')
+            .handler(async (rawInput, ctx) => {
+            const input = rawInput;
+            // Authorization check using guards
+            await checkAuthorization('delete', resourceName, ctx, options);
+            const { id, ifMatch } = input;
+            // Check existence
+            const existing = await resource.get(id);
+            if (!existing) {
+                throw Errors.notFound(resourceName, id);
+            }
+            const existingFiltered = filterProtectedFields(existing, allProtectedFields);
+            // Validate If-Match for optimistic concurrency
+            if (enableETag && ifMatch) {
+                const currentETag = generateETag(existingFiltered);
+                if (!validateIfMatch(ifMatch, currentETag)) {
+                    throw Errors.preconditionFailed(`ETag mismatch - record has been modified`);
+                }
+            }
+            const user = contextToUser(ctx);
+            await resource.delete(id);
+            // Emit deleted event with the deleted record
+            await emitEvent('deleted', options, resourceName, id, undefined, existingFiltered, user);
+            return { success: true };
+        });
+    }
+}
+/**
+ * Create a Raffel adapter for s3db.js resources.
+ *
+ * This generates RESTful procedures from s3db resources that can be mounted
+ * on a Raffel server.
+ *
+ * @example
+ * ```typescript
+ * // Single resource
+ * const userRoutes = createS3DBAdapter(usersResource, {
+ *   authorize: (op, resource, ctx) => ctx.auth?.authenticated
+ * })
+ *
+ * // Multiple resources
+ * const routes = createS3DBAdapter([users, posts, comments])
+ *
+ * // Use with server
+ * server.mount('api/v1', userRoutes)
+ * // Or inline
+ * const server = createServer({ port: 3000 })
+ *   .enableHttp()
+ *   .mount('api', createS3DBAdapter(users))
+ * ```
+ */
+export function createS3DBAdapter(resources, options = {}) {
+    const resourceArray = Array.isArray(resources) ? resources : [resources];
+    const module = createRouterModule();
+    for (const resource of resourceArray) {
+        registerResourceProcedures(module, resource, options);
+    }
+    return module;
+}
+/**
+ * Create an interceptor that adds s3db resources to the context.
+ *
+ * This allows handlers to access resources via `ctx.extensions.s3db`.
+ *
+ * @example
+ * ```typescript
+ * server.use(createS3DBContextInterceptor({ users, posts }))
+ *
+ * // In handler:
+ * const users = ctx.extensions.s3db.users
+ * const user = await users.get(input.userId)
+ * ```
+ */
+export function createS3DBContextInterceptor(resources) {
+    return async (envelope, _ctx, next) => {
+        // Add resources to context extensions
+        const ctx = envelope.context;
+        const extensions = ctx.extensions;
+        // Create a symbol key for s3db
+        const s3dbKey = Symbol.for('raffel.s3db');
+        extensions.set(s3dbKey, resources);
+        return next();
+    };
+}
+/**
+ * Helper to generate HTTP path mapping for s3db procedures.
+ *
+ * Maps procedure names to RESTful HTTP routes.
+ *
+ * @example
+ * ```typescript
+ * const paths = generateS3DBHttpPaths('users', '/api/v1')
+ * // Returns:
+ * // {
+ * //   '/api/v1/users.list': { method: 'GET', path: '/api/v1/users' },
+ * //   '/api/v1/users.get': { method: 'GET', path: '/api/v1/users/:id' },
+ * //   '/api/v1/users.create': { method: 'POST', path: '/api/v1/users' },
+ * //   '/api/v1/users.update': { method: 'PUT', path: '/api/v1/users/:id' },
+ * //   '/api/v1/users.patch': { method: 'PATCH', path: '/api/v1/users/:id' },
+ * //   '/api/v1/users.delete': { method: 'DELETE', path: '/api/v1/users/:id' },
+ * //   '/api/v1/users.options': { method: 'OPTIONS', path: '/api/v1/users' },
+ * //   '/api/v1/users.head': { method: 'HEAD', path: '/api/v1/users' },
+ * //   '/api/v1/users.headItem': { method: 'HEAD', path: '/api/v1/users/:id' },
+ * // }
+ * ```
+ */
+export function generateS3DBHttpPaths(resourceName, basePath = '') {
+    const prefix = basePath ? `${basePath}.${resourceName}` : resourceName;
+    const httpPath = basePath ? `${basePath}/${resourceName}` : `/${resourceName}`;
+    return {
+        [`${prefix}.list`]: { method: 'GET', path: httpPath },
+        [`${prefix}.get`]: { method: 'GET', path: `${httpPath}/:id` },
+        [`${prefix}.count`]: { method: 'GET', path: `${httpPath}/count` },
+        [`${prefix}.create`]: { method: 'POST', path: httpPath },
+        [`${prefix}.update`]: { method: 'PUT', path: `${httpPath}/:id` },
+        [`${prefix}.patch`]: { method: 'PATCH', path: `${httpPath}/:id` },
+        [`${prefix}.delete`]: { method: 'DELETE', path: `${httpPath}/:id` },
+        [`${prefix}.options`]: { method: 'OPTIONS', path: httpPath },
+        [`${prefix}.head`]: { method: 'HEAD', path: httpPath },
+        [`${prefix}.headItem`]: { method: 'HEAD', path: `${httpPath}/:id` },
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * S3DB Resource Adapter
+ *
+ * Provides integration between s3db.js resources and Raffel's RESTful system.
+ *
+ * Features:
+ * - RESTful CRUD operations (list, get, create, update, patch, delete)
+ * - ETag support for caching and optimistic concurrency
+ * - Flexible guards system for authorization (roles, scopes, custom functions)
+ * - Relations/populate for expanding related records
+ * - Event callbacks (onCreated, onUpdated, onDeleted)
+ * - Prefer header support (return=minimal)
+ * - HEAD endpoints for metadata
+ * - Enhanced OPTIONS with full resource metadata
+ */
+export { createS3DBAdapter, createS3DBContextInterceptor, generateS3DBHttpPaths, } from './adapter.js';
+export type { S3DBResourceLike, S3DBDatabaseLike, S3DBRelationDefinition, S3DBGuardsConfig, S3DBGuardDefinition, S3DBGuardsOptions, Guard, S3DBResourceEvent, S3DBEventCallback, S3DBAdapterOptions, S3DBListInput, S3DBGetInput, S3DBHeadItemInput, S3DBCreateInput, S3DBUpdateInput, S3DBDeleteInput, S3DBListResponse, S3DBSingleResponse, S3DBDeleteResponse, S3DBOptionsResponse, S3DBHeadResponse, } from './types.js';
+export { generateETag, validateIfMatch, validateIfNoneMatch, formatLastModified, hasScope, hasRole, hasAnyRole, checkGuard, getOperationGuard, parsePopulate, buildIncludesTree, resolvePopulate, hasRelations, getRelationNames, } from './utils/index.js';
+export type { GuardUser, GuardFunction, GuardObject, GuardsConfig, S3DBOperation, PopulateResult, IncludesTree, IncludesNode, } from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/s3db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAA;AAGrB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAEL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAElB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,UAAU,EACV,iBAAiB,EAEjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAA"}

package/dist/adapters/s3db/index.js

@@ -0,0 +1,25 @@
+/**
+ * S3DB Resource Adapter
+ *
+ * Provides integration between s3db.js resources and Raffel's RESTful system.
+ *
+ * Features:
+ * - RESTful CRUD operations (list, get, create, update, patch, delete)
+ * - ETag support for caching and optimistic concurrency
+ * - Flexible guards system for authorization (roles, scopes, custom functions)
+ * - Relations/populate for expanding related records
+ * - Event callbacks (onCreated, onUpdated, onDeleted)
+ * - Prefer header support (return=minimal)
+ * - HEAD endpoints for metadata
+ * - Enhanced OPTIONS with full resource metadata
+ */
+export { createS3DBAdapter, createS3DBContextInterceptor, generateS3DBHttpPaths, } from './adapter.js';
+// Utilities (for advanced usage)
+export { 
+// ETag utilities
+generateETag, validateIfMatch, validateIfNoneMatch, formatLastModified, 
+// Guards utilities
+hasScope, hasRole, hasAnyRole, checkGuard, getOperationGuard, 
+// Populate utilities
+parsePopulate, buildIncludesTree, resolvePopulate, hasRelations, getRelationNames, } from './utils/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/s3db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAA;AA2BrB,iCAAiC;AACjC,OAAO;AACL,iBAAiB;AACjB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB;AAClB,mBAAmB;AACnB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,UAAU,EACV,iBAAiB;AACjB,qBAAqB;AACrB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}

package/dist/adapters/s3db/s3db.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * S3DB Adapter Tests
+ */
+export {};
+//# sourceMappingURL=s3db.int.test.d.ts.map

package/dist/adapters/s3db/s3db.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3db.int.test.d.ts","sourceRoot":"","sources":["../../../src/adapters/s3db/s3db.int.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}