storybooker 0.19.4 → 0.22.0-canary.0

package/dist/azure-functions.mjs

@@ -0,0 +1,147 @@
+import { SERVICE_NAME } from "./~internal/constants.mjs";
+import { generatePrefixFromBaseRoute, urlJoin } from "./utils/url-utils.mjs";
+import { createHonoRouter, createPurgeHandler } from "./index.mjs";
+
+//#region src/adapters/azure-functions.ts
+const DEFAULT_PURGE_SCHEDULE_CRON = "0 0 0 * * *";
+/**
+* Register the Storybooker router with the Azure Functions App.
+*
+* - It enabled streaming responses for HTTP functions.
+* - It registers the HTTP function with provided route and auth-level.
+* - It registers the Timer function for purge if `purgeScheduleCron` is not `null`.
+*
+* @param app Azure Functions App instance
+* @param options Options for registering the router
+*/
+function registerStoryBookerRouter(app, options) {
+	app.setup?.({ enableHttpStream: true });
+	const { auth, purgeScheduleCron, route, ...rest } = options;
+	const routerOptions = rest;
+	routerOptions.config ??= {};
+	routerOptions.config.errorParser ??= parseAzureRestError;
+	if (route) routerOptions.config.prefix = generatePrefixFromBaseRoute(route);
+	if (typeof auth === "object") routerOptions.auth = auth;
+	const router = createHonoRouter(routerOptions);
+	app.http(SERVICE_NAME, {
+		authLevel: typeof auth === "string" ? auth : "anonymous",
+		handler: async (httpRequest) => {
+			const request = newRequestFromAzureFunctions(httpRequest);
+			return newAzureFunctionsResponse(await router.fetch(request));
+		},
+		methods: [
+			"GET",
+			"POST",
+			"DELETE",
+			"HEAD",
+			"PATCH",
+			"PUT",
+			"OPTIONS",
+			"TRACE",
+			"CONNECT"
+		],
+		route: urlJoin(route ?? "", "{**path}")
+	});
+	if (purgeScheduleCron !== null && app.timer) {
+		const schedule = purgeScheduleCron ?? DEFAULT_PURGE_SCHEDULE_CRON;
+		const purgeHandler = createPurgeHandler({
+			database: routerOptions.database,
+			storage: routerOptions.storage
+		});
+		app.timer(`${SERVICE_NAME}-timer_purge`, {
+			handler: async (_timer, context) => purgeHandler({}, { logger: createAzureContextLogger(context) }),
+			runOnStartup: false,
+			schedule
+		});
+	}
+}
+const parseAzureRestError = (error) => {
+	if (error instanceof Error && error.name === "RestError") {
+		const restError = error;
+		const details = restError.details ?? {};
+		const message = details["errorMessage"] ?? restError.message;
+		return {
+			errorMessage: `${details["errorCode"] ?? restError.name} (${restError.code ?? restError.statusCode}): ${message}`,
+			errorStatus: restError.statusCode,
+			errorType: "AzureRest"
+		};
+	}
+};
+function createAzureContextLogger(context) {
+	return {
+		debug: context.debug.bind(context),
+		error: context.error.bind(context),
+		log: context.log.bind(context),
+		metadata: { name: "Azure Functions" }
+	};
+}
+/**
+* Utils (@refer https://github.com/Marplex/hono-azurefunc-adapter/)
+*/
+/** */
+function newRequestFromAzureFunctions(request) {
+	const hasBody = !["GET", "HEAD"].includes(request.method);
+	return new Request(request.url, {
+		headers: headersToObject(request.headers),
+		method: request.method,
+		...hasBody ? {
+			body: request.body,
+			duplex: "half"
+		} : {}
+	});
+}
+function newAzureFunctionsResponse(response) {
+	let headers = headersToObject(response.headers);
+	let cookies = cookiesFromHeaders(response.headers);
+	return {
+		body: streamToAsyncIterator(response.body),
+		cookies,
+		headers,
+		status: response.status
+	};
+}
+function headersToObject(input) {
+	const headers = {};
+	input.forEach((value, key) => headers[key] = value);
+	return headers;
+}
+function cookiesFromHeaders(headers) {
+	const cookies = headers.getSetCookie();
+	if (cookies.length === 0) return;
+	return cookies.map((cookie) => parseCookieString(cookie));
+}
+function parseCookieString(cookieString) {
+	const [first, ...attributesArray] = cookieString.split(";").map((item) => item.split("=")).map(([key, value]) => [key?.trim().toLowerCase(), value ?? "true"]);
+	const [name, encodedValue] = first ?? [];
+	const attrs = Object.fromEntries(attributesArray);
+	return {
+		domain: attrs["domain"],
+		expires: attrs["expires"] ? new Date(attrs["expires"]) : void 0,
+		httpOnly: attrs["httponly"] === "true",
+		maxAge: attrs["max-age"] ? Number.parseInt(attrs["max-age"], 10) : void 0,
+		name: name ?? "",
+		path: attrs["path"],
+		sameSite: attrs["samesite"],
+		secure: attrs["secure"] === "true",
+		value: encodedValue ? decodeURIComponent(encodedValue) : ""
+	};
+}
+function streamToAsyncIterator(readable) {
+	if (readable === null || !readable) return null;
+	const reader = readable.getReader();
+	return {
+		async next() {
+			return await reader.read();
+		},
+		return() {
+			reader.releaseLock();
+		},
+		[Symbol.asyncIterator]() {
+			return this;
+		}
+	};
+}
+
+//#endregion
+export { registerStoryBookerRouter };
+//# sourceMappingURL=azure-functions.mjs.map

package/dist/azure-functions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-functions.mjs","names":["routerOptions: RouterOptions<User>","parseAzureRestError: ErrorParser","message: string","headers: Record<string, string>","attrs: Record<string, string>"],"sources":["../src/adapters/azure-functions.ts"],"sourcesContent":["// oxlint-disable max-lines-per-function\n\nimport type { RestError } from \"@azure/core-rest-pipeline\";\nimport type {\n  Cookie,\n  HttpFunctionOptions,\n  HttpRequest,\n  HttpResponseInit,\n  HttpTriggerOptions,\n  InvocationContext,\n  SetupOptions,\n  TimerFunctionOptions,\n} from \"@azure/functions\";\nimport { createHonoRouter, createPurgeHandler } from \"../index.ts\";\nimport type { ErrorParser, RouterOptions, StoryBookerUser } from \"../types.ts\";\nimport { generatePrefixFromBaseRoute, SERVICE_NAME, urlJoin } from \"../utils/index.ts\";\nimport type { AuthAdapter } from \"./_internal/auth.ts\";\nimport type { LoggerAdapter } from \"./_internal/logger.ts\";\n\nconst DEFAULT_PURGE_SCHEDULE_CRON = \"0 0 0 * * *\";\n\nexport type * from \"storybooker/types\";\n\n/**\n * Minimal representation of Azure Functions App namespace\n * to register HTTP and Timer functions.\n */\ninterface FunctionsApp {\n  http(name: string, options: HttpFunctionOptions): void;\n  setup?(options: SetupOptions): void;\n  timer?(name: string, options: TimerFunctionOptions): void;\n}\n\n/**\n * Options to register the storybooker router\n */\nexport interface RegisterStorybookerRouterOptions<User extends StoryBookerUser> extends Omit<\n  RouterOptions<User>,\n  \"auth\"\n> {\n  /**\n   * For authenticating routes, either use an AuthAdapter or Functions auth-level property.\n   *\n   * - AuthAdapter allows full customization of authentication logic. This will set the function to \"anonymous\" auth-level.\n   * - Auth-level is a simpler way to set predefined authentication levels (\"function\", \"admin\").\n   *   This is a good option to set if the service is used in\n   *   Headless mode and requires single token authentication for all the requests.\n   *\n   * @see https://learn.microsoft.com/en-us/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=python-v2%2Cisolated-process%2Cnodejs-v4%2Cfunctionsv2&pivots=programming-language-javascript#http-auth (AuthLevels)\n   */\n  auth?: AuthAdapter<User> | Exclude<HttpTriggerOptions[\"authLevel\"], \"anonymous\">;\n\n  /**\n   * Define the route on which all router is placed.\n   * Can be a sub-path of the main API route.\n   *\n   * @default ''\n   */\n  route?: string;\n\n  /**\n   * Modify the cron-schedule of timer function\n   * which purge outdated storybooks.\n   *\n   * Pass `null` to disable auto-purge functionality.\n   *\n   * @default \"0 0 0 * * *\" // Every midnight\n   */\n  purgeScheduleCron?: string | null;\n}\n\n/**\n * Register the Storybooker router with the Azure Functions App.\n *\n * - It enabled streaming responses for HTTP functions.\n * - It registers the HTTP function with provided route and auth-level.\n * - It registers the Timer function for purge if `purgeScheduleCron` is not `null`.\n *\n * @param app Azure Functions App instance\n * @param options Options for registering the router\n */\nexport function registerStoryBookerRouter<User extends StoryBookerUser>(\n  app: FunctionsApp,\n  options: RegisterStorybookerRouterOptions<User>,\n): void {\n  app.setup?.({ enableHttpStream: true });\n  const { auth, purgeScheduleCron, route, ...rest } = options;\n\n  const routerOptions: RouterOptions<User> = rest;\n  routerOptions.config ??= {};\n  routerOptions.config.errorParser ??= parseAzureRestError;\n\n  if (route) {\n    routerOptions.config.prefix = generatePrefixFromBaseRoute(route);\n  }\n  if (typeof auth === \"object\") {\n    routerOptions.auth = auth;\n  }\n\n  const router = createHonoRouter(routerOptions);\n\n  app.http(SERVICE_NAME, {\n    authLevel: typeof auth === \"string\" ? auth : \"anonymous\",\n    handler: async (httpRequest) => {\n      const request = newRequestFromAzureFunctions(httpRequest);\n      const response = await router.fetch(request);\n      return newAzureFunctionsResponse(response);\n    },\n    methods: [\"GET\", \"POST\", \"DELETE\", \"HEAD\", \"PATCH\", \"PUT\", \"OPTIONS\", \"TRACE\", \"CONNECT\"],\n    route: urlJoin(route ?? \"\", \"{**path}\"),\n  });\n\n  if (purgeScheduleCron !== null && app.timer) {\n    const schedule = purgeScheduleCron ?? DEFAULT_PURGE_SCHEDULE_CRON;\n    const purgeHandler = createPurgeHandler({\n      database: routerOptions.database,\n      storage: routerOptions.storage,\n    });\n\n    app.timer(`${SERVICE_NAME}-timer_purge`, {\n      // oxlint-disable-next-line require-await\n      handler: async (_timer, context) =>\n        purgeHandler({}, { logger: createAzureContextLogger(context) }),\n      runOnStartup: false,\n      schedule,\n    });\n  }\n}\n\nconst parseAzureRestError: ErrorParser = (error) => {\n  if (error instanceof Error && error.name === \"RestError\") {\n    const restError = error as RestError;\n    const details = (restError.details ?? {}) as Record<string, string>;\n    const message: string = details[\"errorMessage\"] ?? restError.message;\n\n    return {\n      errorMessage: `${details[\"errorCode\"] ?? restError.name} (${\n        restError.code ?? restError.statusCode\n      }): ${message}`,\n      errorStatus: restError.statusCode,\n      errorType: \"AzureRest\",\n    };\n  }\n\n  // oxlint-disable-next-line no-useless-return\n  return;\n};\n\nfunction createAzureContextLogger(context: InvocationContext): LoggerAdapter {\n  return {\n    debug: context.debug.bind(context),\n    error: context.error.bind(context),\n    log: context.log.bind(context),\n    metadata: { name: \"Azure Functions\" },\n  };\n}\n\n/**\n * Utils (@refer https://github.com/Marplex/hono-azurefunc-adapter/)\n */\n\n/** */\nfunction newRequestFromAzureFunctions(request: HttpRequest): Request {\n  const hasBody = ![\"GET\", \"HEAD\"].includes(request.method);\n\n  return new Request(request.url, {\n    headers: headersToObject(request.headers),\n    method: request.method,\n    ...(hasBody ? { body: request.body as ReadableStream, duplex: \"half\" } : {}),\n  });\n}\n\nfunction newAzureFunctionsResponse(response: Response): HttpResponseInit {\n  let headers = headersToObject(response.headers);\n  let cookies = cookiesFromHeaders(response.headers);\n\n  return {\n    body: streamToAsyncIterator(response.body),\n    cookies,\n    headers,\n    status: response.status,\n  };\n}\n\nfunction headersToObject(input: HttpRequest[\"headers\"]): Record<string, string> {\n  const headers: Record<string, string> = {};\n  // oxlint-disable-next-line no-array-for-each\n  input.forEach((value, key) => (headers[key] = value));\n  return headers;\n}\n\nfunction cookiesFromHeaders(headers: Headers): Cookie[] | undefined {\n  const cookies = headers.getSetCookie();\n  if (cookies.length === 0) {\n    return undefined;\n  }\n\n  return cookies.map((cookie) => parseCookieString(cookie));\n}\n\nfunction parseCookieString(cookieString: string): Cookie {\n  const [first, ...attributesArray] = cookieString\n    .split(\";\")\n    .map((item) => item.split(\"=\"))\n    .map(([key, value]) => [key?.trim().toLowerCase(), value ?? \"true\"]);\n\n  const [name, encodedValue] = first ?? [];\n  const attrs: Record<string, string> = Object.fromEntries(attributesArray);\n\n  return {\n    domain: attrs[\"domain\"],\n    expires: attrs[\"expires\"] ? new Date(attrs[\"expires\"]) : undefined,\n    httpOnly: attrs[\"httponly\"] === \"true\",\n    maxAge: attrs[\"max-age\"] ? Number.parseInt(attrs[\"max-age\"], 10) : undefined,\n    name: name ?? \"\",\n    path: attrs[\"path\"],\n    sameSite: attrs[\"samesite\"] as \"Strict\" | \"Lax\" | \"None\" | undefined,\n    secure: attrs[\"secure\"] === \"true\",\n    value: encodedValue ? decodeURIComponent(encodedValue) : \"\",\n  };\n}\n\nfunction streamToAsyncIterator(\n  readable: Response[\"body\"],\n): AsyncIterableIterator<Uint8Array> | null {\n  if (readable === null || !readable) {\n    return null;\n  }\n\n  const reader = readable.getReader();\n  return {\n    async next() {\n      return await reader.read();\n    },\n    return() {\n      reader.releaseLock();\n    },\n    [Symbol.asyncIterator]() {\n      return this;\n    },\n  } as AsyncIterableIterator<Uint8Array>;\n}\n"],"mappings":"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"}

package/dist/fs.d.mts

@@ -0,0 +1,37 @@
+import { DatabaseAdapter } from "./~internal/adapter/database.mjs";
+import { StorageAdapter } from "./~internal/adapter/storage.mjs";
+import "./~internal/adapter.mjs";
+
+//#region src/adapters/fs.d.ts
+
+/**
+ * Database adapter for StoryBooker while uses a file (json) in
+ * the local filesystem to read from and write entries to.
+ * It uses NodeJS FS API to read/write to filesystem.
+ *
+ * It is useful for testing and playground
+ * but not recommended for heavy traffic.
+ *
+ * Usage:
+ * ```ts
+ * const database = createLocalFileDatabaseAdapter("./db.json");
+ * ```
+ */
+declare function createLocalFileDatabaseAdapter(filename?: string): DatabaseAdapter;
+/**
+ * Storage adapter for StoryBooker while uses
+ * the local filesystem to read from and write files to.
+ * It uses NodeJS FS API to read/write to filesystem.
+ *
+ * It is useful for testing and playground
+ * but not recommended for heavy traffic.
+ *
+ * Usage:
+ * ```ts
+ * const storage = createLocalFileStorageAdapter("./store/");
+ * ```
+ */
+declare function createLocalFileStorageAdapter(pathPrefix?: string): StorageAdapter;
+//#endregion
+export { createLocalFileDatabaseAdapter, createLocalFileStorageAdapter };
+//# sourceMappingURL=fs.d.mts.map

package/dist/fs.mjs

@@ -0,0 +1,240 @@
+import { DatabaseAdapterErrors } from "./~internal/adapter/database.mjs";
+import { StorageAdapterErrors } from "./~internal/adapter/storage.mjs";
+import * as fs$1 from "node:fs";
+import * as fsp$1 from "node:fs/promises";
+import * as path$1 from "node:path";
+import { Readable } from "node:stream";
+
+//#region src/adapters/fs.ts
+/**
+* Database adapter for StoryBooker while uses a file (json) in
+* the local filesystem to read from and write entries to.
+* It uses NodeJS FS API to read/write to filesystem.
+*
+* It is useful for testing and playground
+* but not recommended for heavy traffic.
+*
+* Usage:
+* ```ts
+* const database = createLocalFileDatabaseAdapter("./db.json");
+* ```
+*/
+function createLocalFileDatabaseAdapter(filename = "db.json") {
+	const filepath = path$1.resolve(filename);
+	let db = void 0;
+	const readFromFile = async (options) => {
+		try {
+			const newDB = await fsp$1.readFile(filepath, {
+				encoding: "utf8",
+				signal: options.abortSignal
+			});
+			db = newDB ? JSON.parse(newDB) : {};
+		} catch {
+			db = {};
+		}
+	};
+	const saveToFile = async (options) => {
+		if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+		await fsp$1.writeFile(filepath, JSON.stringify(db, null, 2), {
+			encoding: "utf8",
+			signal: options.abortSignal
+		});
+	};
+	return {
+		metadata: {
+			name: "Local File",
+			description: "A file based database stored in a single JSON file."
+		},
+		async init(options) {
+			if (fs$1.existsSync(filepath)) if ((await fsp$1.stat(filepath)).isFile()) await readFromFile(options);
+			else throw new DatabaseAdapterErrors.DatabaseNotInitializedError(`Path "${filepath}" is not a file`);
+			else {
+				db = {};
+				const basedir = path$1.dirname(filepath);
+				await fsp$1.mkdir(basedir, { recursive: true }).catch(() => {});
+				await saveToFile(options);
+			}
+		},
+		async createCollection(collectionId, options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			if (Object.hasOwn(db, collectionId)) throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId);
+			db[collectionId] ??= {};
+			await saveToFile(options);
+		},
+		async listCollections() {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			return Object.keys(db);
+		},
+		async deleteCollection(collectionId, options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			if (!Object.hasOwn(db, collectionId)) throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);
+			delete db[collectionId];
+			await saveToFile(options);
+		},
+		async hasCollection(collectionId, _options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			return Object.hasOwn(db, collectionId);
+		},
+		async listDocuments(collectionId, listOptions, _options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			if (!Object.hasOwn(db, collectionId)) throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);
+			const { limit = Number.POSITIVE_INFINITY, sort, filter } = listOptions || {};
+			const collection = db[collectionId];
+			const items = Object.values(collection);
+			if (sort) {
+				if (typeof sort === "function") items.sort(sort);
+				else if (sort === "latest") items.sort((itemA, itemB) => {
+					return new Date(itemB.updatedAt).getTime() - new Date(itemA.updatedAt).getTime();
+				});
+			}
+			if (filter && typeof filter === "function") return items.filter((item) => filter(item)).slice(0, limit);
+			return items.slice(0, limit);
+		},
+		async getDocument(collectionId, documentId, _options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			if (!Object.hasOwn(db, collectionId)) throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);
+			const item = db[collectionId]?.[documentId];
+			if (!item) throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);
+			return item;
+		},
+		async hasDocument(collectionId, documentId, options) {
+			return Boolean(await this.getDocument(collectionId, documentId, options));
+		},
+		async createDocument(collectionId, documentData, options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			if (!Object.hasOwn(db, collectionId)) throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);
+			const collection = db[collectionId];
+			if (collection[documentData.id]) throw new DatabaseAdapterErrors.DocumentAlreadyExistsError(collectionId, documentData.id);
+			collection[documentData.id] = documentData;
+			await saveToFile(options);
+		},
+		async deleteDocument(collectionId, documentId, options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			if (!Object.hasOwn(db, collectionId)) throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);
+			if (!await this.hasDocument(collectionId, documentId, options)) throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);
+			const collection = db[collectionId];
+			delete collection[documentId];
+			await saveToFile(options);
+		},
+		async updateDocument(collectionId, documentId, documentData, options) {
+			if (!db) throw new DatabaseAdapterErrors.DatabaseNotInitializedError();
+			if (!Object.hasOwn(db, collectionId)) throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);
+			const prevItem = await this.getDocument(collectionId, documentId, options);
+			if (!prevItem) throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);
+			const collection = db[collectionId];
+			collection[documentId] = {
+				...prevItem,
+				...documentData,
+				id: documentId
+			};
+			await saveToFile(options);
+		}
+	};
+}
+/**
+* Storage adapter for StoryBooker while uses
+* the local filesystem to read from and write files to.
+* It uses NodeJS FS API to read/write to filesystem.
+*
+* It is useful for testing and playground
+* but not recommended for heavy traffic.
+*
+* Usage:
+* ```ts
+* const storage = createLocalFileStorageAdapter("./store/");
+* ```
+*/
+function createLocalFileStorageAdapter(pathPrefix = ".") {
+	const basePath = path$1.resolve(pathPrefix);
+	function genPath(...pathParts) {
+		return path$1.join(basePath, ...pathParts.filter((part) => part !== void 0));
+	}
+	return {
+		metadata: {
+			name: "Local File System",
+			description: "A storage adapter that uses the local file system to store files."
+		},
+		init: async (_options) => {
+			try {
+				await fsp$1.mkdir(basePath, { recursive: true });
+			} catch (error) {
+				throw new StorageAdapterErrors.StorageNotInitializedError({ cause: error });
+			}
+		},
+		async createContainer(containerId, options) {
+			if (await this.hasContainer(containerId, options)) throw new StorageAdapterErrors.ContainerAlreadyExistsError(containerId);
+			await fsp$1.mkdir(genPath(containerId), { recursive: true });
+		},
+		async deleteContainer(containerId, options) {
+			if (!await this.hasContainer(containerId, options)) throw new StorageAdapterErrors.ContainerDoesNotExistError(containerId);
+			await fsp$1.rm(genPath(containerId), {
+				force: true,
+				recursive: true
+			});
+		},
+		async hasContainer(containerId) {
+			return fs$1.existsSync(genPath(containerId));
+		},
+		async listContainers() {
+			const dirPath = genPath();
+			if (!fs$1.existsSync(dirPath)) throw new StorageAdapterErrors.StorageNotInitializedError(`Dir "${dirPath}" does not exist`);
+			const containers = [];
+			const entries = await fsp$1.readdir(dirPath, { withFileTypes: true });
+			for (const entry of entries) if (entry.isDirectory()) containers.push(entry.name);
+			return containers;
+		},
+		async deleteFiles(containerId, filePathsOrPrefix) {
+			if (typeof filePathsOrPrefix === "string") await fsp$1.rm(genPath(containerId, filePathsOrPrefix), {
+				force: true,
+				recursive: true
+			});
+			else for (const filepath of filePathsOrPrefix) await fsp$1.rm(filepath, {
+				force: true,
+				recursive: true
+			});
+		},
+		async hasFile(containerId, filepath) {
+			const path$2 = genPath(containerId, filepath);
+			return fs$1.existsSync(path$2);
+		},
+		async downloadFile(containerId, filepath, options) {
+			if (!await this.hasFile(containerId, filepath, options)) throw new StorageAdapterErrors.FileDoesNotExistError(containerId, filepath);
+			const path$2 = genPath(containerId, filepath);
+			const buffer = await fsp$1.readFile(path$2);
+			return {
+				content: new Blob([buffer]),
+				path: path$2
+			};
+		},
+		async uploadFiles(containerId, files, options) {
+			for (const file of files) {
+				const filepath = genPath(containerId, file.path);
+				const dirpath = path$1.dirname(filepath);
+				await fsp$1.mkdir(dirpath, { recursive: true });
+				if (file.content instanceof ReadableStream) await writeWebStreamToFile(file.content, filepath);
+				else {
+					const data = typeof file.content === "string" ? file.content : await file.content.text();
+					await fsp$1.writeFile(filepath, data, {
+						encoding: "utf8",
+						signal: options.abortSignal
+					});
+				}
+			}
+		}
+	};
+}
+function writeWebStreamToFile(webReadableStream, outputPath) {
+	const nodeReadableStream = Readable.fromWeb(webReadableStream);
+	const fileWritableStream = fs$1.createWriteStream(outputPath);
+	nodeReadableStream.pipe(fileWritableStream);
+	return new Promise((resolve, reject) => {
+		fileWritableStream.on("finish", () => {
+			resolve(null);
+		});
+		fileWritableStream.on("error", reject);
+	});
+}
+
+//#endregion
+export { createLocalFileDatabaseAdapter, createLocalFileStorageAdapter };
+//# sourceMappingURL=fs.mjs.map

package/dist/fs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.mjs","names":["path","db: Record<string, Record<string, StoryBookerDatabaseDocument>> | undefined","fsp","fs","containers: string[]","data: string | Stream"],"sources":["../src/adapters/fs.ts"],"sourcesContent":["// oxlint-disable no-await-in-loop\n// oxlint-disable max-params\n// oxlint-disable require-await\n// oxlint-disable no-unsafe-assignment\n\nimport type { Buffer } from \"node:buffer\";\nimport * as fs from \"node:fs\";\nimport * as fsp from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { Readable, type Stream } from \"node:stream\";\nimport type { ReadableStream as WebReadableStream } from \"node:stream/web\";\nimport {\n  DatabaseAdapterErrors,\n  StorageAdapterErrors,\n  type DatabaseAdapter,\n  type DatabaseAdapterOptions,\n  type StorageAdapter,\n  type StoryBookerDatabaseDocument,\n} from \"./_internal/index.ts\";\n\n/**\n * Database adapter for StoryBooker while uses a file (json) in\n * the local filesystem to read from and write entries to.\n * It uses NodeJS FS API to read/write to filesystem.\n *\n * It is useful for testing and playground\n * but not recommended for heavy traffic.\n *\n * Usage:\n * ```ts\n * const database = createLocalFileDatabaseAdapter(\"./db.json\");\n * ```\n */\nexport function createLocalFileDatabaseAdapter(filename = \"db.json\"): DatabaseAdapter {\n  const filepath = path.resolve(filename);\n  let db: Record<string, Record<string, StoryBookerDatabaseDocument>> | undefined = undefined;\n\n  const readFromFile = async (options: DatabaseAdapterOptions): Promise<void> => {\n    try {\n      const newDB = await fsp.readFile(filepath, {\n        encoding: \"utf8\",\n        signal: options.abortSignal,\n      });\n      db = newDB ? JSON.parse(newDB) : {};\n    } catch {\n      db = {};\n    }\n  };\n\n  const saveToFile = async (options: DatabaseAdapterOptions): Promise<void> => {\n    if (!db) {\n      throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n    }\n\n    await fsp.writeFile(filepath, JSON.stringify(db, null, 2), {\n      encoding: \"utf8\",\n      signal: options.abortSignal,\n    });\n  };\n\n  return {\n    metadata: {\n      name: \"Local File\",\n      description: \"A file based database stored in a single JSON file.\",\n    },\n\n    async init(options) {\n      if (fs.existsSync(filepath)) {\n        const stat = await fsp.stat(filepath);\n        if (stat.isFile()) {\n          await readFromFile(options);\n        } else {\n          throw new DatabaseAdapterErrors.DatabaseNotInitializedError(\n            `Path \"${filepath}\" is not a file`,\n          );\n        }\n      } else {\n        db = {}; // Initialize empty DB\n        const basedir = path.dirname(filepath);\n        await fsp.mkdir(basedir, { recursive: true }).catch(() => {\n          // ignore error\n        });\n        await saveToFile(options);\n      }\n    },\n\n    // Collections\n\n    async createCollection(collectionId, options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      if (Object.hasOwn(db, collectionId)) {\n        throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId);\n      }\n\n      db[collectionId] ??= {};\n      await saveToFile(options);\n    },\n\n    async listCollections() {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      return Object.keys(db);\n    },\n\n    async deleteCollection(collectionId, options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      if (!Object.hasOwn(db, collectionId)) {\n        throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);\n      }\n\n      // oxlint-disable-next-line no-dynamic-delete\n      delete db[collectionId];\n      await saveToFile(options);\n    },\n\n    async hasCollection(collectionId, _options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      return Object.hasOwn(db, collectionId);\n    },\n\n    // Documents\n\n    async listDocuments(collectionId, listOptions, _options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      if (!Object.hasOwn(db, collectionId)) {\n        throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);\n      }\n\n      const { limit = Number.POSITIVE_INFINITY, sort, filter } = listOptions || {};\n\n      // oxlint-disable-next-line no-non-null-assertion\n      const collection = db[collectionId]!;\n      const items = Object.values(collection);\n      if (sort) {\n        if (typeof sort === \"function\") {\n          items.sort(sort);\n        } else if (sort === \"latest\") {\n          items.sort((itemA, itemB) => {\n            return new Date(itemB.updatedAt).getTime() - new Date(itemA.updatedAt).getTime();\n          });\n        }\n      }\n\n      if (filter && typeof filter === \"function\") {\n        return items.filter((item) => filter(item)).slice(0, limit);\n      }\n\n      return items.slice(0, limit);\n    },\n\n    async getDocument(collectionId, documentId, _options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      if (!Object.hasOwn(db, collectionId)) {\n        throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);\n      }\n\n      const item = db[collectionId]?.[documentId];\n      if (!item) {\n        throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);\n      }\n\n      return item;\n    },\n\n    async hasDocument(collectionId, documentId, options) {\n      return Boolean(await this.getDocument(collectionId, documentId, options));\n    },\n\n    async createDocument(collectionId, documentData, options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      if (!Object.hasOwn(db, collectionId)) {\n        throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);\n      }\n\n      // oxlint-disable-next-line no-non-null-assertion\n      const collection = db[collectionId]!;\n      if (collection[documentData.id]) {\n        throw new DatabaseAdapterErrors.DocumentAlreadyExistsError(collectionId, documentData.id);\n      }\n\n      collection[documentData.id] = documentData;\n      await saveToFile(options);\n    },\n\n    async deleteDocument(collectionId, documentId, options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      if (!Object.hasOwn(db, collectionId)) {\n        throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);\n      }\n\n      if (!(await this.hasDocument(collectionId, documentId, options))) {\n        throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);\n      }\n\n      // oxlint-disable-next-line no-non-null-assertion\n      const collection = db[collectionId]!;\n      // oxlint-disable-next-line no-dynamic-delete\n      delete collection[documentId];\n      await saveToFile(options);\n    },\n\n    async updateDocument(collectionId, documentId, documentData, options) {\n      if (!db) {\n        throw new DatabaseAdapterErrors.DatabaseNotInitializedError();\n      }\n\n      if (!Object.hasOwn(db, collectionId)) {\n        throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId);\n      }\n\n      const prevItem = await this.getDocument(collectionId, documentId, options);\n      if (!prevItem) {\n        throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);\n      }\n\n      // oxlint-disable-next-line no-non-null-assertion\n      const collection = db[collectionId]!;\n      collection[documentId] = { ...prevItem, ...documentData, id: documentId };\n      await saveToFile(options);\n    },\n  };\n}\n\n/**\n * Storage adapter for StoryBooker while uses\n * the local filesystem to read from and write files to.\n * It uses NodeJS FS API to read/write to filesystem.\n *\n * It is useful for testing and playground\n * but not recommended for heavy traffic.\n *\n * Usage:\n * ```ts\n * const storage = createLocalFileStorageAdapter(\"./store/\");\n * ```\n */\nexport function createLocalFileStorageAdapter(pathPrefix = \".\"): StorageAdapter {\n  const basePath = path.resolve(pathPrefix);\n\n  function genPath(...pathParts: (string | undefined)[]): string {\n    return path.join(basePath, ...pathParts.filter((part) => part !== undefined));\n  }\n\n  // Containers\n\n  return {\n    metadata: {\n      name: \"Local File System\",\n      description: \"A storage adapter that uses the local file system to store files.\",\n    },\n\n    init: async (_options) => {\n      try {\n        await fsp.mkdir(basePath, { recursive: true });\n      } catch (error) {\n        throw new StorageAdapterErrors.StorageNotInitializedError({ cause: error });\n      }\n    },\n\n    async createContainer(containerId, options) {\n      if (await this.hasContainer(containerId, options)) {\n        throw new StorageAdapterErrors.ContainerAlreadyExistsError(containerId);\n      }\n\n      await fsp.mkdir(genPath(containerId), { recursive: true });\n    },\n\n    async deleteContainer(containerId, options) {\n      if (!(await this.hasContainer(containerId, options))) {\n        throw new StorageAdapterErrors.ContainerDoesNotExistError(containerId);\n      }\n\n      await fsp.rm(genPath(containerId), { force: true, recursive: true });\n    },\n\n    async hasContainer(containerId) {\n      return fs.existsSync(genPath(containerId));\n    },\n\n    async listContainers() {\n      const dirPath = genPath();\n      if (!fs.existsSync(dirPath)) {\n        throw new StorageAdapterErrors.StorageNotInitializedError(\n          `Dir \"${dirPath}\" does not exist`,\n        );\n      }\n\n      const containers: string[] = [];\n      const entries = await fsp.readdir(dirPath, {\n        withFileTypes: true,\n      });\n      for (const entry of entries) {\n        if (entry.isDirectory()) {\n          containers.push(entry.name);\n        }\n      }\n      return containers;\n    },\n\n    // Files\n\n    async deleteFiles(containerId, filePathsOrPrefix) {\n      if (typeof filePathsOrPrefix === \"string\") {\n        await fsp.rm(genPath(containerId, filePathsOrPrefix), {\n          force: true,\n          recursive: true,\n        });\n      } else {\n        for (const filepath of filePathsOrPrefix) {\n          // oxlint-disable-next-line no-await-in-loop\n          await fsp.rm(filepath, { force: true, recursive: true });\n        }\n      }\n    },\n\n    async hasFile(containerId, filepath) {\n      const path = genPath(containerId, filepath);\n      return fs.existsSync(path);\n    },\n\n    async downloadFile(containerId, filepath, options) {\n      if (!(await this.hasFile(containerId, filepath, options))) {\n        throw new StorageAdapterErrors.FileDoesNotExistError(containerId, filepath);\n      }\n\n      const path = genPath(containerId, filepath);\n      const buffer = await fsp.readFile(path);\n      const content = new Blob([buffer as Buffer<ArrayBuffer>]);\n      return { content, path };\n    },\n\n    async uploadFiles(containerId, files, options) {\n      for (const file of files) {\n        const filepath = genPath(containerId, file.path);\n        const dirpath = path.dirname(filepath);\n\n        await fsp.mkdir(dirpath, { recursive: true });\n        if (file.content instanceof ReadableStream) {\n          await writeWebStreamToFile(file.content, filepath);\n        } else {\n          const data: string | Stream =\n            // oxlint-disable-next-line no-nested-ternary\n            typeof file.content === \"string\" ? file.content : await file.content.text();\n\n          await fsp.writeFile(filepath, data, {\n            encoding: \"utf8\",\n            signal: options.abortSignal,\n          });\n        }\n      }\n    },\n  };\n}\n\nfunction writeWebStreamToFile(\n  webReadableStream: ReadableStream,\n  outputPath: string,\n): Promise<null> {\n  // Convert WebReadableStream to Node.js Readable stream\n  const nodeReadableStream = Readable.fromWeb(webReadableStream as WebReadableStream);\n\n  // Create a writable file stream\n  const fileWritableStream = fs.createWriteStream(outputPath);\n\n  // Pipe the Node.js readable stream to the writable file stream\n  nodeReadableStream.pipe(fileWritableStream);\n\n  // Return a promise that resolves when writing is finished\n  return new Promise((resolve, reject) => {\n    fileWritableStream.on(\"finish\", () => {\n      resolve(null);\n    });\n    fileWritableStream.on(\"error\", reject);\n  });\n}\n"],"mappings":"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"}

package/dist/gcp-big-table.d.mts

@@ -0,0 +1,23 @@
+import { DatabaseAdapter } from "./~internal/adapter/database.mjs";
+import { Bigtable } from "@google-cloud/bigtable";
+
+//#region src/adapters/gcp-big-table.d.ts
+declare class GcpBigtableDatabaseAdapter implements DatabaseAdapter {
+  #private;
+  constructor(client: Bigtable, instanceName?: string);
+  metadata: DatabaseAdapter["metadata"];
+  init: DatabaseAdapter["init"];
+  listCollections: DatabaseAdapter["listCollections"];
+  createCollection: DatabaseAdapter["createCollection"];
+  hasCollection: DatabaseAdapter["hasCollection"];
+  deleteCollection: DatabaseAdapter["deleteCollection"];
+  listDocuments: DatabaseAdapter["listDocuments"];
+  getDocument: DatabaseAdapter["getDocument"];
+  createDocument: DatabaseAdapter["createDocument"];
+  hasDocument: DatabaseAdapter["hasDocument"];
+  deleteDocument: DatabaseAdapter["deleteDocument"];
+  updateDocument: DatabaseAdapter["updateDocument"];
+}
+//#endregion
+export { GcpBigtableDatabaseAdapter };
+//# sourceMappingURL=gcp-big-table.d.mts.map

package/dist/gcp-big-table.mjs

@@ -0,0 +1,92 @@
+import { DatabaseAdapterErrors } from "./~internal/adapter/database.mjs";
+
+//#region src/adapters/gcp-big-table.ts
+const COLUMN_FAMILY = "cf1";
+var GcpBigtableDatabaseAdapter = class {
+	#instance;
+	constructor(client, instanceName = "StoryBooker") {
+		this.#instance = client.instance(instanceName);
+	}
+	metadata = { name: "Google Cloud Bigtable" };
+	init = async (_options) => {
+		const [exists] = await this.#instance.exists();
+		if (!exists) throw new DatabaseAdapterErrors.DatabaseNotInitializedError(`Bigtable instance '${this.#instance.id}' does not exist.`);
+	};
+	listCollections = async (_options) => {
+		const [tables] = await this.#instance.getTables();
+		return tables.map((table) => table.id);
+	};
+	createCollection = async (collectionId, _options) => {
+		try {
+			await this.#instance.createTable(collectionId, { families: [COLUMN_FAMILY] });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId, error);
+		}
+	};
+	hasCollection = async (collectionId, _options) => {
+		const [exists] = await this.#instance.table(collectionId).exists();
+		return exists;
+	};
+	deleteCollection = async (collectionId, _options) => {
+		try {
+			await this.#instance.table(collectionId).delete();
+		} catch (error) {
+			throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId, error);
+		}
+	};
+	listDocuments = async (collectionId, _listOptions, _options) => {
+		try {
+			const [rows] = await this.#instance.table(collectionId).getRows();
+			const list = [];
+			for (const row of rows) {
+				const document = {
+					...row.data[COLUMN_FAMILY],
+					id: row.id
+				};
+				list.push(document);
+			}
+			return list;
+		} catch (error) {
+			throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId, error);
+		}
+	};
+	getDocument = async (collectionId, documentId, _options) => {
+		const row = this.#instance.table(collectionId).row(documentId);
+		const [exists] = await row.exists();
+		if (!exists) throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);
+		const [rowData] = await row.get([COLUMN_FAMILY]);
+		return {
+			...rowData,
+			id: documentId
+		};
+	};
+	createDocument = async (collectionId, documentData, _options) => {
+		try {
+			await this.#instance.table(collectionId).row(documentData.id).create({ entry: { [COLUMN_FAMILY]: documentData } });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentAlreadyExistsError(collectionId, documentData.id, error);
+		}
+	};
+	hasDocument = async (collectionId, documentId, _options) => {
+		const [exists] = await this.#instance.table(collectionId).row(documentId).exists();
+		return exists;
+	};
+	deleteDocument = async (collectionId, documentId, _options) => {
+		try {
+			await this.#instance.table(collectionId).row(documentId).delete();
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+	updateDocument = async (collectionId, documentId, documentData) => {
+		try {
+			await this.#instance.table(collectionId).row(documentId).save({ [COLUMN_FAMILY]: documentData });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+};
+
+//#endregion
+export { GcpBigtableDatabaseAdapter };
+//# sourceMappingURL=gcp-big-table.mjs.map

package/dist/gcp-big-table.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcp-big-table.mjs","names":["COLUMN_FAMILY: ColumnFamily","#instance","list: Document[]","document: Document"],"sources":["../src/adapters/gcp-big-table.ts"],"sourcesContent":["import type { Bigtable, Instance } from \"@google-cloud/bigtable\";\nimport {\n  DatabaseAdapterErrors,\n  type DatabaseAdapter,\n  type DatabaseAdapterOptions,\n  type DatabaseDocumentListOptions,\n  type StoryBookerDatabaseDocument,\n} from \"./_internal/database.ts\";\n\ntype ColumnFamily = \"cf1\";\nconst COLUMN_FAMILY: ColumnFamily = \"cf1\";\n\nexport class GcpBigtableDatabaseAdapter implements DatabaseAdapter {\n  #instance: Instance;\n\n  constructor(client: Bigtable, instanceName = \"StoryBooker\") {\n    this.#instance = client.instance(instanceName);\n  }\n\n  metadata: DatabaseAdapter[\"metadata\"] = { name: \"Google Cloud Bigtable\" };\n\n  init: DatabaseAdapter[\"init\"] = async (_options) => {\n    // Bigtable instances are typically created outside of app code (via console/IaC)\n    // Optionally, check if instance exists\n    const [exists] = await this.#instance.exists();\n    if (!exists) {\n      throw new DatabaseAdapterErrors.DatabaseNotInitializedError(\n        `Bigtable instance '${this.#instance.id}' does not exist.`,\n      );\n    }\n  };\n\n  listCollections: DatabaseAdapter[\"listCollections\"] = async (_options) => {\n    const [tables] = await this.#instance.getTables();\n    return tables.map((table) => table.id);\n  };\n\n  createCollection: DatabaseAdapter[\"createCollection\"] = async (collectionId, _options) => {\n    try {\n      await this.#instance.createTable(collectionId, {\n        families: [COLUMN_FAMILY],\n      });\n    } catch (error) {\n      throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId, error);\n    }\n  };\n\n  hasCollection: DatabaseAdapter[\"hasCollection\"] = async (collectionId, _options) => {\n    const table = this.#instance.table(collectionId);\n    const [exists] = await table.exists();\n    return exists;\n  };\n\n  deleteCollection: DatabaseAdapter[\"deleteCollection\"] = async (collectionId, _options) => {\n    try {\n      const table = this.#instance.table(collectionId);\n      await table.delete();\n    } catch (error) {\n      throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId, error);\n    }\n  };\n\n  listDocuments: DatabaseAdapter[\"listDocuments\"] = async <\n    Document extends StoryBookerDatabaseDocument,\n  >(\n    collectionId: string,\n    _listOptions: DatabaseDocumentListOptions<Document>,\n    _options: DatabaseAdapterOptions,\n  ) => {\n    try {\n      const table = this.#instance.table(collectionId);\n      const [rows] = await table.getRows();\n      const list: Document[] = [];\n      for (const row of rows) {\n        const data = (row.data as Record<ColumnFamily, Document>)[COLUMN_FAMILY];\n        const document: Document = { ...data, id: row.id };\n        list.push(document);\n      }\n\n      return list;\n    } catch (error) {\n      throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId, error);\n    }\n  };\n\n  getDocument: DatabaseAdapter[\"getDocument\"] = async <\n    Document extends StoryBookerDatabaseDocument,\n  >(\n    collectionId: string,\n    documentId: string,\n    _options: DatabaseAdapterOptions,\n  ) => {\n    const table = this.#instance.table(collectionId);\n    const row = table.row(documentId);\n    const [exists] = await row.exists();\n    if (!exists) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId);\n    }\n\n    const [rowData] = await row.get<Document>([COLUMN_FAMILY]);\n\n    return { ...rowData, id: documentId };\n  };\n\n  createDocument: DatabaseAdapter[\"createDocument\"] = async (\n    collectionId,\n    documentData,\n    _options,\n  ) => {\n    try {\n      const table = this.#instance.table(collectionId);\n      const row = table.row(documentData.id);\n      await row.create({ entry: { [COLUMN_FAMILY]: documentData } });\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentAlreadyExistsError(\n        collectionId,\n        documentData.id,\n        error,\n      );\n    }\n  };\n\n  hasDocument: DatabaseAdapter[\"hasDocument\"] = async (collectionId, documentId, _options) => {\n    const table = this.#instance.table(collectionId);\n    const row = table.row(documentId);\n    const [exists] = await row.exists();\n    return exists;\n  };\n\n  deleteDocument: DatabaseAdapter[\"deleteDocument\"] = async (\n    collectionId,\n    documentId,\n    _options,\n  ) => {\n    try {\n      const table = this.#instance.table(collectionId);\n      const row = table.row(documentId);\n      await row.delete();\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n\n  updateDocument: DatabaseAdapter[\"updateDocument\"] = async (\n    collectionId,\n    documentId,\n    documentData,\n  ) => {\n    try {\n      const table = this.#instance.table(collectionId);\n      const row = table.row(documentId);\n      await row.save({ [COLUMN_FAMILY]: documentData });\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n}\n"],"mappings":";;;AAUA,MAAMA,gBAA8B;AAEpC,IAAa,6BAAb,MAAmE;CACjE;CAEA,YAAY,QAAkB,eAAe,eAAe;AAC1D,QAAKC,WAAY,OAAO,SAAS,aAAa;;CAGhD,WAAwC,EAAE,MAAM,yBAAyB;CAEzE,OAAgC,OAAO,aAAa;EAGlD,MAAM,CAAC,UAAU,MAAM,MAAKA,SAAU,QAAQ;AAC9C,MAAI,CAAC,OACH,OAAM,IAAI,sBAAsB,4BAC9B,sBAAsB,MAAKA,SAAU,GAAG,mBACzC;;CAIL,kBAAsD,OAAO,aAAa;EACxE,MAAM,CAAC,UAAU,MAAM,MAAKA,SAAU,WAAW;AACjD,SAAO,OAAO,KAAK,UAAU,MAAM,GAAG;;CAGxC,mBAAwD,OAAO,cAAc,aAAa;AACxF,MAAI;AACF,SAAM,MAAKA,SAAU,YAAY,cAAc,EAC7C,UAAU,CAAC,cAAc,EAC1B,CAAC;WACK,OAAO;AACd,SAAM,IAAI,sBAAsB,6BAA6B,cAAc,MAAM;;;CAIrF,gBAAkD,OAAO,cAAc,aAAa;EAElF,MAAM,CAAC,UAAU,MADH,MAAKA,SAAU,MAAM,aAAa,CACnB,QAAQ;AACrC,SAAO;;CAGT,mBAAwD,OAAO,cAAc,aAAa;AACxF,MAAI;AAEF,SADc,MAAKA,SAAU,MAAM,aAAa,CACpC,QAAQ;WACb,OAAO;AACd,SAAM,IAAI,sBAAsB,4BAA4B,cAAc,MAAM;;;CAIpF,gBAAkD,OAGhD,cACA,cACA,aACG;AACH,MAAI;GAEF,MAAM,CAAC,QAAQ,MADD,MAAKA,SAAU,MAAM,aAAa,CACrB,SAAS;GACpC,MAAMC,OAAmB,EAAE;AAC3B,QAAK,MAAM,OAAO,MAAM;IAEtB,MAAMC,WAAqB;KAAE,GADf,IAAI,KAAwC;KACpB,IAAI,IAAI;KAAI;AAClD,SAAK,KAAK,SAAS;;AAGrB,UAAO;WACA,OAAO;AACd,SAAM,IAAI,sBAAsB,4BAA4B,cAAc,MAAM;;;CAIpF,cAA8C,OAG5C,cACA,YACA,aACG;EAEH,MAAM,MADQ,MAAKF,SAAU,MAAM,aAAa,CAC9B,IAAI,WAAW;EACjC,MAAM,CAAC,UAAU,MAAM,IAAI,QAAQ;AACnC,MAAI,CAAC,OACH,OAAM,IAAI,sBAAsB,0BAA0B,cAAc,WAAW;EAGrF,MAAM,CAAC,WAAW,MAAM,IAAI,IAAc,CAAC,cAAc,CAAC;AAE1D,SAAO;GAAE,GAAG;GAAS,IAAI;GAAY;;CAGvC,iBAAoD,OAClD,cACA,cACA,aACG;AACH,MAAI;AAGF,SAFc,MAAKA,SAAU,MAAM,aAAa,CAC9B,IAAI,aAAa,GAAG,CAC5B,OAAO,EAAE,OAAO,GAAG,gBAAgB,cAAc,EAAE,CAAC;WACvD,OAAO;AACd,SAAM,IAAI,sBAAsB,2BAC9B,cACA,aAAa,IACb,MACD;;;CAIL,cAA8C,OAAO,cAAc,YAAY,aAAa;EAG1F,MAAM,CAAC,UAAU,MAFH,MAAKA,SAAU,MAAM,aAAa,CAC9B,IAAI,WAAW,CACN,QAAQ;AACnC,SAAO;;CAGT,iBAAoD,OAClD,cACA,YACA,aACG;AACH,MAAI;AAGF,SAFc,MAAKA,SAAU,MAAM,aAAa,CAC9B,IAAI,WAAW,CACvB,QAAQ;WACX,OAAO;AACd,SAAM,IAAI,sBAAsB,0BAA0B,cAAc,YAAY,MAAM;;;CAI9F,iBAAoD,OAClD,cACA,YACA,iBACG;AACH,MAAI;AAGF,SAFc,MAAKA,SAAU,MAAM,aAAa,CAC9B,IAAI,WAAW,CACvB,KAAK,GAAG,gBAAgB,cAAc,CAAC;WAC1C,OAAO;AACd,SAAM,IAAI,sBAAsB,0BAA0B,cAAc,YAAY,MAAM"}

package/dist/gcp-firestore.d.mts

@@ -0,0 +1,22 @@
+import { DatabaseAdapter } from "./~internal/adapter/database.mjs";
+import { Firestore } from "@google-cloud/firestore";
+
+//#region src/adapters/gcp-firestore.d.ts
+declare class GcpFirestoreDatabaseAdapter implements DatabaseAdapter {
+  #private;
+  constructor(instance: Firestore);
+  metadata: DatabaseAdapter["metadata"];
+  listCollections: DatabaseAdapter["listCollections"];
+  createCollection: DatabaseAdapter["createCollection"];
+  hasCollection: DatabaseAdapter["hasCollection"];
+  deleteCollection: DatabaseAdapter["deleteCollection"];
+  listDocuments: DatabaseAdapter["listDocuments"];
+  getDocument: DatabaseAdapter["getDocument"];
+  createDocument: DatabaseAdapter["createDocument"];
+  hasDocument: DatabaseAdapter["hasDocument"];
+  deleteDocument: DatabaseAdapter["deleteDocument"];
+  updateDocument: DatabaseAdapter["updateDocument"];
+}
+//#endregion
+export { GcpFirestoreDatabaseAdapter };
+//# sourceMappingURL=gcp-firestore.d.mts.map