@syncular/server 0.1.2 → 0.2.0

package/dist/filesystem/index.js

@@ -1,164 +0,0 @@
-/**
- * Filesystem blob storage adapter.
- *
- * Stores blobs as files on disk with 2-level hash-based subdirectories.
- * Uploads/downloads go through the server's blob routes using signed tokens
- * (same pattern as the database adapter).
- */
-import { mkdir, open, readFile, rename, stat, unlink, writeFile, } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-function hasErrnoCode(error, code) {
-    if (typeof error !== 'object' || error === null)
-        return false;
-    return error.code === code;
-}
-/**
- * Resolve hash to a 2-level subdirectory path:
- * `{basePath}/{hex[0..2]}/{hex[2..4]}/{hex}`
- */
-function normalizePartitionId(partitionId) {
-    const raw = partitionId?.trim();
-    if (!raw)
-        return 'default';
-    return raw;
-}
-function hashToFilePath(basePath, hash, partitionId) {
-    const hex = hash.startsWith('sha256:') ? hash.slice(7) : hash;
-    const normalizedPartition = normalizePartitionId(partitionId);
-    if (!partitionId || normalizedPartition === 'default') {
-        return join(basePath, hex.slice(0, 2), hex.slice(2, 4), hex);
-    }
-    const partitionPath = encodeURIComponent(normalizedPartition);
-    return join(basePath, partitionPath, hex.slice(0, 2), hex.slice(2, 4), hex);
-}
-function tmpPath(filePath) {
-    return `${filePath}.${Date.now()}.tmp`;
-}
-/**
- * Create a filesystem blob storage adapter.
- *
- * @example
- * ```typescript
- * const adapter = createFilesystemBlobStorageAdapter({
- *   basePath: '/data/blobs',
- *   baseUrl: 'https://api.example.com/api/sync',
- *   tokenSigner: createHmacTokenSigner(process.env.BLOB_SECRET!),
- * });
- * ```
- */
-export function createFilesystemBlobStorageAdapter(options) {
-    const { basePath, tokenSigner } = options;
-    const normalizedBaseUrl = options.baseUrl.replace(/\/$/, '');
-    return {
-        name: 'filesystem',
-        async signUpload(opts) {
-            const partitionId = normalizePartitionId(opts.partitionId);
-            const expiresAt = Date.now() + opts.expiresIn * 1000;
-            const token = await tokenSigner.sign({
-                hash: opts.hash,
-                partitionId,
-                action: 'upload',
-                size: opts.size,
-                expiresAt,
-            }, opts.expiresIn);
-            const url = `${normalizedBaseUrl}/blobs/${encodeURIComponent(opts.hash)}/upload?token=${encodeURIComponent(token)}`;
-            return {
-                url,
-                method: 'PUT',
-                headers: {
-                    'Content-Type': opts.mimeType,
-                    'Content-Length': String(opts.size),
-                },
-            };
-        },
-        async signDownload(opts) {
-            const partitionId = normalizePartitionId(opts.partitionId);
-            const expiresAt = Date.now() + opts.expiresIn * 1000;
-            const token = await tokenSigner.sign({ hash: opts.hash, partitionId, action: 'download', expiresAt }, opts.expiresIn);
-            return `${normalizedBaseUrl}/blobs/${encodeURIComponent(opts.hash)}/download?token=${encodeURIComponent(token)}`;
-        },
-        async exists(hash, options) {
-            try {
-                await stat(hashToFilePath(basePath, hash, options?.partitionId));
-                return true;
-            }
-            catch {
-                return false;
-            }
-        },
-        async delete(hash, options) {
-            try {
-                await unlink(hashToFilePath(basePath, hash, options?.partitionId));
-            }
-            catch (err) {
-                if (!hasErrnoCode(err, 'ENOENT'))
-                    throw err;
-            }
-        },
-        async getMetadata(hash, options) {
-            try {
-                const fileStats = await stat(hashToFilePath(basePath, hash, options?.partitionId));
-                return { size: fileStats.size };
-            }
-            catch {
-                return null;
-            }
-        },
-        async put(hash, data, _metadata, options) {
-            const filePath = hashToFilePath(basePath, hash, options?.partitionId);
-            const tmp = tmpPath(filePath);
-            await mkdir(dirname(filePath), { recursive: true });
-            await writeFile(tmp, data);
-            await rename(tmp, filePath);
-        },
-        async putStream(hash, stream, _metadata, options) {
-            const filePath = hashToFilePath(basePath, hash, options?.partitionId);
-            const tmp = tmpPath(filePath);
-            await mkdir(dirname(filePath), { recursive: true });
-            const fh = await open(tmp, 'w');
-            try {
-                const reader = stream.getReader();
-                while (true) {
-                    const { done, value } = await reader.read();
-                    if (done)
-                        break;
-                    await fh.write(value);
-                }
-            }
-            finally {
-                await fh.close();
-            }
-            await rename(tmp, filePath);
-        },
-        async get(hash, options) {
-            try {
-                const data = await readFile(hashToFilePath(basePath, hash, options?.partitionId));
-                return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-            }
-            catch (err) {
-                if (hasErrnoCode(err, 'ENOENT'))
-                    return null;
-                throw err;
-            }
-        },
-        async getStream(hash, options) {
-            let data;
-            try {
-                data = await readFile(hashToFilePath(basePath, hash, options?.partitionId));
-            }
-            catch (err) {
-                if (hasErrnoCode(err, 'ENOENT'))
-                    return null;
-                throw err;
-            }
-            const bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-            return new ReadableStream({
-                start(controller) {
-                    controller.enqueue(bytes);
-                    controller.close();
-                },
-            });
-        },
-    };
-}
-//# sourceMappingURL=index.js.map

package/dist/filesystem/index.js.map

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

package/dist/handlers/collection.d.ts

@@ -1,20 +0,0 @@
-import { type BinarySnapshotColumn, type BinarySnapshotRowsEncoder } from '@syncular/core';
-import type { SyncCoreDb } from '../schema';
-import type { ServerTableHandler, SyncServerAuth } from './types';
-export interface ServerHandlerCollection<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth> {
-    handlers: ServerTableHandler<DB, Auth>[];
-    byTable: ReadonlyMap<string, ServerTableHandler<DB, Auth>>;
-}
-export interface ServerSnapshotBinaryMetadata {
-    columns: Readonly<Record<string, readonly BinarySnapshotColumn[] | undefined>>;
-    encoders?: Readonly<Record<string, BinarySnapshotRowsEncoder | undefined>>;
-    columnsForVersion?: (table: string, schemaVersion: number) => readonly BinarySnapshotColumn[] | null | undefined;
-    encoderForVersion?: (table: string, schemaVersion: number) => BinarySnapshotRowsEncoder | null | undefined;
-}
-export interface ServerHandlerCollectionOptions {
-    snapshotBinary?: ServerSnapshotBinaryMetadata;
-}
-export declare function createServerHandlerCollection<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth>(handlers: ServerTableHandler<DB, Auth>[], options?: ServerHandlerCollectionOptions): ServerHandlerCollection<DB, Auth>;
-export declare function getServerBootstrapOrder<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth>(collection: ServerHandlerCollection<DB, Auth>): ServerTableHandler<DB, Auth>[];
-export declare function getServerBootstrapOrderFor<DB extends SyncCoreDb = SyncCoreDb, Auth extends SyncServerAuth = SyncServerAuth>(collection: ServerHandlerCollection<DB, Auth>, table: string): ServerTableHandler<DB, Auth>[];
-//# sourceMappingURL=collection.d.ts.map

package/dist/handlers/collection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/handlers/collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAG/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAElE,MAAM,WAAW,uBAAuB,CACtC,EAAE,SAAS,UAAU,GAAG,UAAU,EAClC,IAAI,SAAS,cAAc,GAAG,cAAc;IAE5C,QAAQ,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;IACzC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,QAAQ,CACf,MAAM,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,SAAS,CAAC,CAC5D,CAAC;IACF,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,KAClB,SAAS,oBAAoB,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IACxD,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,KAClB,yBAAyB,GAAG,IAAI,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,8BAA8B;IAC7C,cAAc,CAAC,EAAE,4BAA4B,CAAC;CAC/C;AAyCD,wBAAgB,6BAA6B,CAC3C,EAAE,SAAS,UAAU,GAAG,UAAU,EAClC,IAAI,SAAS,cAAc,GAAG,cAAc,EAE5C,QAAQ,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EACxC,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAAC,EAAE,EAAE,IAAI,CAAC,CAmBnC;AAED,wBAAgB,uBAAuB,CACrC,EAAE,SAAS,UAAU,GAAG,UAAU,EAClC,IAAI,SAAS,cAAc,GAAG,cAAc,EAE5C,UAAU,EAAE,uBAAuB,CAAC,EAAE,EAAE,IAAI,CAAC,GAC5C,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAEhC;AAED,wBAAgB,0BAA0B,CACxC,EAAE,SAAS,UAAU,GAAG,UAAU,EAClC,IAAI,SAAS,cAAc,GAAG,cAAc,EAE5C,UAAU,EAAE,uBAAuB,CAAC,EAAE,EAAE,IAAI,CAAC,EAC7C,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAEhC"}

package/dist/handlers/collection.js

@@ -1,42 +0,0 @@
-import { assertKnownTableDependencies, createTableLookup, topologicallySortTablesByDependencies, } from '@syncular/core';
-function attachSnapshotBinaryMetadata(handler, metadata) {
-    const generatedColumns = metadata.columns[handler.table];
-    const generatedEncoder = metadata.encoders?.[handler.table];
-    const generatedColumnsForVersion = metadata.columnsForVersion;
-    const generatedEncoderForVersion = metadata.encoderForVersion;
-    if (!generatedColumns &&
-        !generatedEncoder &&
-        !generatedColumnsForVersion &&
-        !generatedEncoderForVersion) {
-        return handler;
-    }
-    return {
-        ...handler,
-        snapshotBinaryColumns: handler.snapshotBinaryColumns ?? generatedColumns,
-        snapshotBinaryEncoder: handler.snapshotBinaryEncoder ?? generatedEncoder,
-        snapshotBinaryColumnsForVersion: handler.snapshotBinaryColumnsForVersion ??
-            (generatedColumnsForVersion
-                ? (schemaVersion) => generatedColumnsForVersion(handler.table, schemaVersion)
-                : undefined),
-        snapshotBinaryEncoderForVersion: handler.snapshotBinaryEncoderForVersion ??
-            (generatedEncoderForVersion
-                ? (schemaVersion) => generatedEncoderForVersion(handler.table, schemaVersion)
-                : undefined),
-    };
-}
-export function createServerHandlerCollection(handlers, options = {}) {
-    const snapshotBinary = options.snapshotBinary;
-    const resolvedHandlers = snapshotBinary
-        ? handlers.map((handler) => attachSnapshotBinaryMetadata(handler, snapshotBinary))
-        : handlers;
-    const byTable = createTableLookup(resolvedHandlers, (table) => `Table "${table}" is already registered`);
-    assertKnownTableDependencies(resolvedHandlers, byTable, (table, dependency) => `Table "${table}" depends on unknown table "${dependency}"`);
-    return { handlers: resolvedHandlers, byTable };
-}
-export function getServerBootstrapOrder(collection) {
-    return topologicallySortTablesByDependencies(collection.byTable);
-}
-export function getServerBootstrapOrderFor(collection, table) {
-    return topologicallySortTablesByDependencies(collection.byTable, table);
-}
-//# sourceMappingURL=collection.js.map

package/dist/handlers/collection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/handlers/collection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAG5B,iBAAiB,EACjB,qCAAqC,GACtC,MAAM,gBAAgB,CAAC;AA+BxB,SAAS,4BAA4B,CAInC,OAAqC,EACrC,QAAsC;IAEtC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,0BAA0B,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IAC9D,MAAM,0BAA0B,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IAC9D,IACE,CAAC,gBAAgB;QACjB,CAAC,gBAAgB;QACjB,CAAC,0BAA0B;QAC3B,CAAC,0BAA0B,EAC3B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,gBAAgB;QACxE,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,gBAAgB;QACxE,+BAA+B,EAC7B,OAAO,CAAC,+BAA+B;YACvC,CAAC,0BAA0B;gBACzB,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,CAChB,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC;gBAC5D,CAAC,CAAC,SAAS,CAAC;QAChB,+BAA+B,EAC7B,OAAO,CAAC,+BAA+B;YACvC,CAAC,0BAA0B;gBACzB,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,CAChB,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC;gBAC5D,CAAC,CAAC,SAAS,CAAC;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAI3C,QAAwC,EACxC,OAAO,GAAmC,EAAE;IAE5C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC9C,MAAM,gBAAgB,GAAG,cAAc;QACrC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,4BAA4B,CAAC,OAAO,EAAE,cAAc,CAAC,CACtD;QACH,CAAC,CAAC,QAAQ,CAAC;IACb,MAAM,OAAO,GAAG,iBAAiB,CAC/B,gBAAgB,EAChB,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,KAAK,yBAAyB,CACpD,CAAC;IACF,4BAA4B,CAC1B,gBAAgB,EAChB,OAAO,EACP,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CACpB,UAAU,KAAK,+BAA+B,UAAU,GAAG,CAC9D,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAIrC,UAA6C;IAE7C,OAAO,qCAAqC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAIxC,UAA6C,EAC7C,KAAa;IAEb,OAAO,qCAAqC,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/handlers/create-handler.d.ts

@@ -1,156 +0,0 @@
-/**
- * @syncular/server - Declarative server handler helper
- */
-import type { BinarySnapshotColumn, BinarySnapshotRowsEncoder, ScopeValuesFromPatterns, ScopeDefinition as SimpleScopeDefinition, StoredScopes, SyncOperation } from '@syncular/core';
-import { type ColumnCodecDialect, type ColumnCodecSource, type SyncularErrorCode } from '@syncular/core';
-import type { Selectable, Updateable } from 'kysely';
-import type { SyncCoreDb } from '../schema';
-import type { ServerApplyOperationContext, ServerContext, ServerTableHandler, SyncServerAuth } from './types';
-/**
- * Authorization result from authorize callback.
- */
-type AuthorizeResult = true | {
-    error: string;
-    code: SyncularErrorCode;
-    retriable?: boolean;
-};
-/**
- * Options for creating a declarative server handler.
- */
-export interface CreateServerHandlerOptions<ServerDB extends SyncCoreDb, ClientDB, TableName extends keyof ServerDB & keyof ClientDB & string, Auth extends SyncServerAuth = SyncServerAuth, ScopeDefs extends readonly SimpleScopeDefinition[] = readonly SimpleScopeDefinition[]> {
-    /** Table name in the database */
-    table: TableName;
-    /**
-     * Scope definitions for this table.
-     * Can be simple strings (column auto-derived) or objects with explicit mapping.
-     *
-     * @example
-     * ```typescript
-     * // Simple: column auto-derived from placeholder
-     * scopes: ['user:{user_id}', 'org:{org_id}']
-     *
-     * // Explicit: when column differs from pattern variable
-     * scopes: [
-     *   { pattern: 'user:{user_id}', column: 'owner_id' }
-     * ]
-     * ```
-     */
-    scopes: ScopeDefs;
-    /** Primary key column name (default: 'id') */
-    primaryKey?: string;
-    /** Version column name (default: 'server_version') */
-    versionColumn?: string;
-    /** Tables this handler depends on (for bootstrap ordering) */
-    dependsOn?: string[];
-    /** TTL for cached snapshot chunks in ms */
-    snapshotChunkTtlMs?: number;
-    /**
-     * Stable binary snapshot column metadata used by binary bootstrap chunks.
-     */
-    snapshotBinaryColumns?: readonly BinarySnapshotColumn[];
-    /**
-     * Version-aware binary snapshot column metadata. Returning null intentionally
-     * disables fallback to current metadata.
-     */
-    snapshotBinaryColumnsForVersion?: (schemaVersion: number) => readonly BinarySnapshotColumn[] | null | undefined;
-    /**
-     * Optional generated binary snapshot encoder used by binary bootstrap chunks.
-     */
-    snapshotBinaryEncoder?: BinarySnapshotRowsEncoder<Selectable<ClientDB[TableName]>>;
-    /**
-     * Version-aware generated binary snapshot encoder. Returning null
-     * intentionally disables fallback to the current encoder.
-     */
-    snapshotBinaryEncoderForVersion?: (schemaVersion: number) => BinarySnapshotRowsEncoder<Selectable<ClientDB[TableName]>> | null | undefined;
-    /**
-     * Resolve allowed scope values for the current actor.
-     * Called per request to determine what the actor can access.
-     *
-     * @example
-     * resolveScopes: async (ctx) => ({
-     *   user_id: [ctx.actorId],
-     *   project_id: await getProjectsForUser(ctx.db, ctx.actorId),
-     * })
-     */
-    resolveScopes: (ctx: ServerContext<ServerDB, Auth>) => Promise<ScopeValuesFromPatterns<ScopeDefs>>;
-    /**
-     * Transform inbound row from client to server format.
-     * Use ctx.schemaVersion to handle older client versions.
-     */
-    transformInbound?: (row: Selectable<ClientDB[TableName]>, ctx: {
-        schemaVersion?: number;
-    }) => Updateable<ServerDB[TableName]>;
-    /**
-     * Transform outbound row from server to client format.
-     */
-    transformOutbound?: (row: Selectable<ServerDB[TableName]>) => Selectable<ClientDB[TableName]>;
-    /**
-     * Optional column codec resolver.
-     * Receives `{ table, column, sqlType?, dialect? }` and returns a codec.
-     * Only used by default snapshot/apply paths when the corresponding
-     * transform hook is not provided.
-     */
-    codecs?: ColumnCodecSource;
-    /**
-     * Dialect used for codec dialect overrides.
-     * Default: 'sqlite'
-     */
-    codecDialect?: ColumnCodecDialect;
-    /**
-     * Authorize an operation before applying.
-     * Return true to allow, or an error object to reject.
-     */
-    authorize?: (ctx: ServerApplyOperationContext<ServerDB, Auth>, op: SyncOperation) => Promise<AuthorizeResult>;
-    /**
-     * Override: Build snapshot query.
-     */
-    snapshot?: ServerTableHandler<ServerDB, Auth>['snapshot'];
-    /**
-     * Override: Apply operation.
-     */
-    applyOperation?: ServerTableHandler<ServerDB, Auth>['applyOperation'];
-    /**
-     * Hint for savepoint optimization on single-op commits.
-     *
-     * `true` means a rejected single operation never leaves durable writes
-     * before returning the rejection result.
-     *
-     * Defaults to `true` for the built-in applyOperation implementation and
-     * `false` when a custom applyOperation is provided.
-     */
-    canRejectSingleOperationWithoutSavepoint?: boolean;
-    /**
-     * Custom scope extraction from row (for complex scope logic).
-     */
-    extractScopes?: (row: Record<string, unknown>) => StoredScopes;
-}
-/**
- * Create a declarative server table handler with sensible defaults.
- *
- * @example
- * ```typescript
- * import { createServerHandler } from '@syncular/server';
- * import type { ServerDb } from '../db';
- * import type { ClientDb } from '../../shared/client-db.generated';
- *
- * export const tasksHandler = createServerHandler<ServerDb, ClientDb, 'tasks'>({
- *   table: 'tasks',
- *   scopes: ['user:{user_id}'],  // column auto-derived from placeholder
- *   resolveScopes: async (ctx) => ({
- *     user_id: [ctx.actorId],
- *   }),
- * });
- *
- * // With custom column mapping:
- * export const tasksHandler = createServerHandler<ServerDb, ClientDb, 'tasks'>({
- *   table: 'tasks',
- *   scopes: [{ pattern: 'user:{user_id}', column: 'owner_id' }],
- *   resolveScopes: async (ctx) => ({
- *     user_id: [ctx.actorId],
- *   }),
- * });
- * ```
- */
-export declare function createServerHandler<ServerDB extends SyncCoreDb, ClientDB, TableName extends keyof ServerDB & keyof ClientDB & string, Auth extends SyncServerAuth = SyncServerAuth, ScopeDefs extends readonly SimpleScopeDefinition[] = readonly SimpleScopeDefinition[]>(options: CreateServerHandlerOptions<ServerDB, ClientDB, TableName, Auth, ScopeDefs>): ServerTableHandler<ServerDB, Auth>;
-export {};
-//# sourceMappingURL=create-handler.d.ts.map

package/dist/handlers/create-handler.d.ts.map

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