storybooker 0.19.4 → 0.22.0-canary.0

package/dist/azure-blob-storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-blob-storage.mjs","names":["#client","containers: string[]","blobClientsToDelete: BlobClient[]","promises: Promise<Result>[]","errors: unknown[]"],"sources":["../src/adapters/azure-blob-storage.ts"],"sourcesContent":["import type { BlobClient, BlobServiceClient, BlockBlobClient } from \"@azure/storage-blob\";\nimport { Readable } from \"node:stream\";\nimport type streamWeb from \"node:stream/web\";\nimport { StorageAdapterErrors, type StorageAdapter } from \"./_internal/storage.ts\";\n\nexport class AzureBlobStorageService implements StorageAdapter {\n  #client: BlobServiceClient;\n\n  constructor(client: BlobServiceClient) {\n    this.#client = client;\n  }\n\n  metadata: StorageAdapter[\"metadata\"] = { name: \"Azure Blob Storage\" };\n\n  createContainer: StorageAdapter[\"createContainer\"] = async (containerId, options) => {\n    try {\n      const containerName = genContainerNameFromContainerId(containerId);\n      await this.#client.createContainer(containerName, {\n        abortSignal: options.abortSignal,\n      });\n    } catch (error) {\n      throw new StorageAdapterErrors.ContainerAlreadyExistsError(containerId, error);\n    }\n  };\n\n  deleteContainer: StorageAdapter[\"deleteContainer\"] = async (containerId, options) => {\n    try {\n      const containerName = genContainerNameFromContainerId(containerId);\n      await this.#client.getContainerClient(containerName).deleteIfExists({\n        abortSignal: options.abortSignal,\n      });\n    } catch (error) {\n      throw new StorageAdapterErrors.ContainerDoesNotExistError(containerId, error);\n    }\n  };\n\n  hasContainer: StorageAdapter[\"hasContainer\"] = async (containerId, options) => {\n    const containerName = genContainerNameFromContainerId(containerId);\n    return await this.#client.getContainerClient(containerName).exists({\n      abortSignal: options.abortSignal,\n    });\n  };\n\n  listContainers: StorageAdapter[\"listContainers\"] = async (options) => {\n    const containers: string[] = [];\n    for await (const item of this.#client.listContainers({\n      abortSignal: options.abortSignal,\n    })) {\n      containers.push(item.name);\n    }\n\n    return containers;\n  };\n\n  deleteFiles: StorageAdapter[\"deleteFiles\"] = async (containerId, filePathsOrPrefix, options) => {\n    const containerName = genContainerNameFromContainerId(containerId);\n    const containerClient = this.#client.getContainerClient(containerName);\n    const blobClientsToDelete: BlobClient[] = [];\n\n    if (typeof filePathsOrPrefix === \"string\") {\n      for await (const blob of containerClient.listBlobsFlat({\n        abortSignal: options.abortSignal,\n        prefix: filePathsOrPrefix,\n      })) {\n        blobClientsToDelete.push(containerClient.getBlobClient(blob.name));\n      }\n    } else {\n      for (const filepath of filePathsOrPrefix) {\n        blobClientsToDelete.push(containerClient.getBlobClient(filepath));\n      }\n    }\n\n    if (blobClientsToDelete.length === 0) {\n      return;\n    }\n\n    const response = await containerClient.getBlobBatchClient().deleteBlobs(blobClientsToDelete, {\n      abortSignal: options.abortSignal,\n    });\n\n    if (response.errorCode) {\n      throw new StorageAdapterErrors.CustomError(\n        undefined,\n        `Failed to delete ${response.subResponsesFailedCount} blobs in container ${containerId}: ${response.errorCode}`,\n      );\n    }\n  };\n\n  uploadFiles: StorageAdapter[\"uploadFiles\"] = async (containerId, files, options) => {\n    const containerName = genContainerNameFromContainerId(containerId);\n    const containerClient = this.#client.getContainerClient(containerName);\n\n    const { errors } = await promisePool(\n      files.map(({ content, path, mimeType }) => async (): Promise<void> => {\n        await uploadFileToBlobStorage(\n          containerClient.getBlockBlobClient(path),\n          content,\n          mimeType,\n          options.abortSignal,\n        );\n      }),\n      20,\n    );\n\n    if (errors.length > 0) {\n      options.logger.error(`Failed to upload ${errors.length} files. Errors:`, errors);\n    }\n  };\n\n  hasFile: StorageAdapter[\"hasFile\"] = async (containerId, filepath, options) => {\n    const containerName = genContainerNameFromContainerId(containerId);\n    const containerClient = this.#client.getContainerClient(containerName);\n    const blockBlobClient = containerClient.getBlockBlobClient(filepath);\n    return await blockBlobClient.exists({ abortSignal: options.abortSignal });\n  };\n\n  downloadFile: StorageAdapter[\"downloadFile\"] = async (containerId, filepath, options) => {\n    const containerName = genContainerNameFromContainerId(containerId);\n    const containerClient = this.#client.getContainerClient(containerName);\n    const blockBlobClient = containerClient.getBlockBlobClient(filepath);\n\n    if (!(await blockBlobClient.exists())) {\n      throw new StorageAdapterErrors.FileDoesNotExistError(containerId, filepath);\n    }\n\n    const downloadResponse = await blockBlobClient.download(0, undefined, {\n      abortSignal: options.abortSignal,\n    });\n\n    if (!downloadResponse.readableStreamBody) {\n      throw new StorageAdapterErrors.FileMalformedError(\n        containerId,\n        filepath,\n        \"No readable stream body found.\",\n      );\n    }\n\n    return {\n      content: downloadResponse.readableStreamBody as unknown as ReadableStream,\n      mimeType: downloadResponse.contentType,\n      path: filepath,\n    };\n  };\n}\n\nfunction genContainerNameFromContainerId(containerId: string): string {\n  return containerId\n    .replaceAll(/[^\\w-]+/g, \"-\")\n    .slice(0, 255)\n    .toLowerCase();\n}\n\n// oxlint-disable-next-line max-params\nasync function uploadFileToBlobStorage(\n  client: BlockBlobClient,\n  data: Blob | string | ReadableStream,\n  mimeType: string,\n  abortSignal?: AbortSignal,\n): Promise<void> {\n  if (typeof data === \"string\") {\n    const blob = new Blob([data], { type: mimeType });\n    await client.uploadData(blob, {\n      abortSignal,\n      blobHTTPHeaders: { blobContentType: mimeType },\n    });\n    return;\n  }\n\n  if (data instanceof Blob) {\n    await client.uploadData(data, {\n      abortSignal,\n      blobHTTPHeaders: { blobContentType: mimeType },\n    });\n    return;\n  }\n\n  if (data instanceof ReadableStream) {\n    const stream = data as unknown as streamWeb.ReadableStream;\n    await client.uploadStream(Readable.fromWeb(stream), undefined, undefined, {\n      abortSignal,\n      blobHTTPHeaders: { blobContentType: mimeType },\n    });\n    return;\n  }\n\n  throw new Error(`Unknown file type`);\n}\n\nasync function promisePool<Result>(\n  tasks: (() => Promise<Result>)[],\n  concurrencyLimit: number,\n): Promise<{ errors: unknown[]; results: Result[] }> {\n  const promises: Promise<Result>[] = [];\n  const errors: unknown[] = [];\n  const executing = new Set();\n\n  for (const task of tasks) {\n    // Start the taskPromise\n    const promise = Promise.resolve().then(task);\n    promises.push(promise);\n\n    // Add to executing set\n    executing.add(promise);\n\n    // When the promise settles, remove it from executing\n    const cleanup = (): boolean => executing.delete(promise);\n    promise.then(cleanup).catch((error: unknown) => {\n      errors.push(error);\n      cleanup();\n    });\n\n    // If the number of running promises hit concurrencyLimit, wait for one to finish\n    if (executing.size >= concurrencyLimit) {\n      // oxlint-disable-next-line no-await-in-loop\n      await Promise.race(executing);\n    }\n  }\n\n  // Wait for all remaining tasks to finish\n  const results = await Promise.all(promises);\n\n  return { errors, results };\n}\n"],"mappings":"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"}

package/dist/azure-cosmos-db.d.mts

@@ -0,0 +1,23 @@
+import { DatabaseAdapter } from "./~internal/adapter/database.mjs";
+import { CosmosClient } from "@azure/cosmos";
+
+//#region src/adapters/azure-cosmos-db.d.ts
+declare class AzureCosmosDatabaseService implements DatabaseAdapter {
+  #private;
+  constructor(client: CosmosClient, dbName?: 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 { AzureCosmosDatabaseService };
+//# sourceMappingURL=azure-cosmos-db.d.mts.map

package/dist/azure-cosmos-db.mjs

@@ -0,0 +1,87 @@
+import { DatabaseAdapterErrors } from "./~internal/adapter/database.mjs";
+
+//#region src/adapters/azure-cosmos-db.ts
+var AzureCosmosDatabaseService = class {
+	#db;
+	constructor(client, dbName = "StoryBooker") {
+		this.#db = client.database(dbName);
+	}
+	metadata = { name: "Azure Cosmos DB" };
+	init = async (options) => {
+		await this.#db.client.databases.createIfNotExists({ id: this.#db.id }, { abortSignal: options.abortSignal });
+	};
+	listCollections = async (options) => {
+		try {
+			return (await this.#db.containers.readAll({ abortSignal: options.abortSignal }).fetchAll()).resources.map((resource) => resource.id);
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DatabaseNotInitializedError(error);
+		}
+	};
+	createCollection = async (collectionId, options) => {
+		try {
+			await this.#db.containers.create({ id: collectionId }, { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId, error);
+		}
+	};
+	hasCollection = async (collectionId, options) => {
+		try {
+			const response = await this.#db.container(collectionId).read({ abortSignal: options.abortSignal });
+			return Boolean(response.resource);
+		} catch {
+			return false;
+		}
+	};
+	deleteCollection = async (collectionId, options) => {
+		try {
+			await this.#db.container(collectionId).delete({ abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId, error);
+		}
+	};
+	listDocuments = async (collectionId, _listOptions, options) => {
+		return (await this.#db.container(collectionId).items.readAll({ abortSignal: options.abortSignal }).fetchAll()).resources;
+	};
+	getDocument = async (collectionId, documentId, options) => {
+		try {
+			const document = (await this.#db.container(collectionId).item(documentId).read({ abortSignal: options.abortSignal })).resource;
+			document.id = documentId;
+			return document;
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+	createDocument = async (collectionId, documentData, options) => {
+		try {
+			await this.#db.container(collectionId).items.create(documentData, { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentAlreadyExistsError(collectionId, documentData.id, error);
+		}
+	};
+	hasDocument = async (collectionId, documentId, options) => {
+		const response = await this.#db.container(collectionId).item(documentId).read({ abortSignal: options.abortSignal });
+		return Boolean(response.resource);
+	};
+	deleteDocument = async (collectionId, documentId, options) => {
+		try {
+			await this.#db.container(collectionId).item(documentId).delete({ abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+	updateDocument = async (collectionId, documentId, documentData, options) => {
+		try {
+			await this.#db.container(collectionId).item(documentId).patch({ operations: Object.entries(documentData).map(([key, value]) => ({
+				op: "replace",
+				path: `/${key}`,
+				value
+			})) }, { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+};
+
+//#endregion
+export { AzureCosmosDatabaseService };
+//# sourceMappingURL=azure-cosmos-db.mjs.map

package/dist/azure-cosmos-db.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-cosmos-db.mjs","names":["#db","document: Document"],"sources":["../src/adapters/azure-cosmos-db.ts"],"sourcesContent":["import type { CosmosClient, Database } from \"@azure/cosmos\";\nimport {\n  DatabaseAdapterErrors,\n  type DatabaseAdapter,\n  type DatabaseAdapterOptions,\n  type DatabaseDocumentListOptions,\n  type StoryBookerDatabaseDocument,\n} from \"./_internal/database.ts\";\n\nexport class AzureCosmosDatabaseService implements DatabaseAdapter {\n  #db: Database;\n\n  constructor(client: CosmosClient, dbName = \"StoryBooker\") {\n    this.#db = client.database(dbName);\n  }\n\n  metadata: DatabaseAdapter[\"metadata\"] = { name: \"Azure Cosmos DB\" };\n\n  init: DatabaseAdapter[\"init\"] = async (options) => {\n    await this.#db.client.databases.createIfNotExists(\n      { id: this.#db.id },\n      { abortSignal: options.abortSignal },\n    );\n  };\n\n  listCollections: DatabaseAdapter[\"listCollections\"] = async (options) => {\n    try {\n      const response = await this.#db.containers\n        .readAll({ abortSignal: options.abortSignal })\n        .fetchAll();\n      const collections: string[] = response.resources.map((resource) => resource.id);\n\n      return collections;\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DatabaseNotInitializedError(error);\n    }\n  };\n\n  createCollection: DatabaseAdapter[\"createCollection\"] = async (collectionId, options) => {\n    try {\n      await this.#db.containers.create({ id: collectionId }, { abortSignal: options.abortSignal });\n    } catch (error) {\n      throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId, error);\n    }\n  };\n\n  hasCollection: DatabaseAdapter[\"hasCollection\"] = async (collectionId, options) => {\n    try {\n      const response = await this.#db\n        .container(collectionId)\n        .read({ abortSignal: options.abortSignal });\n      return Boolean(response.resource);\n    } catch {\n      return false;\n    }\n  };\n\n  deleteCollection: DatabaseAdapter[\"deleteCollection\"] = async (collectionId, options) => {\n    try {\n      await this.#db.container(collectionId).delete({ abortSignal: options.abortSignal });\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    const items = await this.#db\n      .container(collectionId)\n      .items.readAll({ abortSignal: options.abortSignal })\n      .fetchAll();\n    return items.resources as Document[];\n  };\n\n  getDocument: DatabaseAdapter[\"getDocument\"] = async <\n    Document extends StoryBookerDatabaseDocument,\n  >(\n    collectionId: string,\n    documentId: string,\n    options: DatabaseAdapterOptions,\n  ) => {\n    try {\n      const item = this.#db.container(collectionId).item(documentId);\n      const response = await item.read({ abortSignal: options.abortSignal });\n      const document: Document = response.resource;\n      document.id = documentId;\n      return document;\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n\n  createDocument: DatabaseAdapter[\"createDocument\"] = async (\n    collectionId,\n    documentData,\n    options,\n  ) => {\n    try {\n      await this.#db\n        .container(collectionId)\n        .items.create(documentData, { abortSignal: options.abortSignal });\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 item = this.#db.container(collectionId).item(documentId);\n    const response = await item.read({ abortSignal: options.abortSignal });\n    return Boolean(response.resource);\n  };\n\n  deleteDocument: DatabaseAdapter[\"deleteDocument\"] = async (collectionId, documentId, options) => {\n    try {\n      await this.#db\n        .container(collectionId)\n        .item(documentId)\n        .delete({ abortSignal: options.abortSignal });\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n\n  // oxlint-disable-next-line max-params\n  updateDocument: DatabaseAdapter[\"updateDocument\"] = async (\n    collectionId,\n    documentId,\n    documentData,\n    options,\n  ) => {\n    try {\n      await this.#db\n        .container(collectionId)\n        .item(documentId)\n        .patch<Document>(\n          {\n            operations: Object.entries(documentData).map(([key, value]) => ({\n              op: \"replace\",\n              path: `/${key}`,\n              value,\n            })),\n          },\n          { abortSignal: options.abortSignal },\n        );\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/azure-data-tables.d.mts

@@ -0,0 +1,23 @@
+import { DatabaseAdapter } from "./~internal/adapter/database.mjs";
+import { TableClient, TableServiceClient } from "@azure/data-tables";
+
+//#region src/adapters/azure-data-tables.d.ts
+type TableClientGenerator = (tableName: string) => TableClient;
+declare class AzureDataTablesDatabaseService implements DatabaseAdapter {
+  #private;
+  constructor(serviceClient: TableServiceClient, tableClientGenerator: TableClientGenerator);
+  metadata: DatabaseAdapter["metadata"];
+  listCollections: DatabaseAdapter["listCollections"];
+  createCollection: DatabaseAdapter["createCollection"];
+  hasCollection: DatabaseAdapter["hasCollection"];
+  deleteCollection: DatabaseAdapter["deleteCollection"];
+  listDocuments: DatabaseAdapter["listDocuments"];
+  getDocument: DatabaseAdapter["getDocument"];
+  hasDocument: DatabaseAdapter["hasDocument"];
+  createDocument: DatabaseAdapter["createDocument"];
+  deleteDocument: DatabaseAdapter["deleteDocument"];
+  updateDocument: DatabaseAdapter["updateDocument"];
+}
+//#endregion
+export { AzureDataTablesDatabaseService, TableClientGenerator };
+//# sourceMappingURL=azure-data-tables.d.mts.map

package/dist/azure-data-tables.mjs

@@ -0,0 +1,127 @@
+import { DatabaseAdapterErrors } from "./~internal/adapter/database.mjs";
+
+//#region src/adapters/azure-data-tables.ts
+var AzureDataTablesDatabaseService = class {
+	#serviceClient;
+	#tableClientGenerator;
+	constructor(serviceClient, tableClientGenerator) {
+		this.#serviceClient = serviceClient;
+		this.#tableClientGenerator = tableClientGenerator;
+	}
+	metadata = { name: "Azure Tables" };
+	listCollections = async (options) => {
+		const collections = [];
+		for await (const table of this.#serviceClient.listTables({ abortSignal: options.abortSignal })) if (table.name) collections.push(table.name);
+		return collections;
+	};
+	createCollection = async (collectionId, options) => {
+		try {
+			const tableName = genTableNameFromCollectionId(collectionId);
+			await this.#serviceClient.createTable(tableName, { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId, error);
+		}
+	};
+	hasCollection = async (collectionId, options) => {
+		try {
+			const tableName = genTableNameFromCollectionId(collectionId);
+			const iterator = this.#serviceClient.listTables({
+				abortSignal: options.abortSignal,
+				queryOptions: { filter: `TableName eq '${tableName}'` }
+			});
+			for await (const table of iterator) if (table.name === collectionId) return true;
+			return false;
+		} catch {
+			return false;
+		}
+	};
+	deleteCollection = async (collectionId, options) => {
+		try {
+			const tableName = genTableNameFromCollectionId(collectionId);
+			await this.#serviceClient.deleteTable(tableName, { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.CollectionDoesNotExistError(collectionId, error);
+		}
+	};
+	listDocuments = async (collectionId, listOptions, options) => {
+		const { filter, limit, select, sort } = listOptions ?? {};
+		const tableName = genTableNameFromCollectionId(collectionId);
+		const pageIterator = this.#tableClientGenerator(tableName).listEntities({
+			abortSignal: options.abortSignal,
+			queryOptions: {
+				filter: typeof filter === "string" ? filter : void 0,
+				select
+			}
+		}).byPage({ maxPageSize: limit });
+		const items = [];
+		for await (const page of pageIterator) for (const entity of page) {
+			const item = entityToItem(entity);
+			if (filter && typeof filter === "function") if (filter(item)) items.push(item);
+			else continue;
+			else items.push(item);
+		}
+		if (sort && typeof sort === "function") items.sort(sort);
+		return items;
+	};
+	getDocument = async (collectionId, documentId, options) => {
+		try {
+			const tableName = genTableNameFromCollectionId(collectionId);
+			return entityToItem(await this.#tableClientGenerator(tableName).getEntity(collectionId, documentId, { abortSignal: options.abortSignal }));
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+	hasDocument = async (collectionId, documentId, options) => {
+		try {
+			return Boolean(await this.getDocument(collectionId, documentId, options));
+		} catch {
+			return false;
+		}
+	};
+	createDocument = async (collectionId, documentData, options) => {
+		try {
+			const tableName = genTableNameFromCollectionId(collectionId);
+			await this.#tableClientGenerator(tableName).createEntity({
+				...documentData,
+				partitionKey: collectionId,
+				rowKey: documentData.id
+			}, { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentAlreadyExistsError(collectionId, documentData.id, error);
+		}
+	};
+	deleteDocument = async (collectionId, documentId, options) => {
+		try {
+			const tableName = genTableNameFromCollectionId(collectionId);
+			await this.#tableClientGenerator(tableName).deleteEntity(collectionId, documentId, { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+	updateDocument = async (collectionId, documentId, documentData, options) => {
+		try {
+			const tableName = genTableNameFromCollectionId(collectionId);
+			await this.#tableClientGenerator(tableName).updateEntity({
+				...documentData,
+				partitionKey: collectionId,
+				rowKey: documentId
+			}, "Merge", { abortSignal: options.abortSignal });
+		} catch (error) {
+			throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);
+		}
+	};
+};
+function genTableNameFromCollectionId(collectionId) {
+	if (/^[A-Za-z][A-Za-z0-9]{2,62}$/.test(collectionId)) return collectionId;
+	return collectionId.replaceAll(/\W/g, "").slice(0, 63).padEnd(3, "X");
+}
+function entityToItem(entity) {
+	return {
+		...entity,
+		id: entity.rowKey ?? entity.partitionKey ?? entity.etag
+	};
+}
+
+//#endregion
+export { AzureDataTablesDatabaseService };
+//# sourceMappingURL=azure-data-tables.mjs.map

package/dist/azure-data-tables.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-data-tables.mjs","names":["#serviceClient","#tableClientGenerator","collections: string[]","items: Document[]"],"sources":["../src/adapters/azure-data-tables.ts"],"sourcesContent":["import type { TableClient, TableEntityResult, TableServiceClient } from \"@azure/data-tables\";\nimport {\n  DatabaseAdapterErrors,\n  type DatabaseAdapter,\n  type DatabaseAdapterOptions,\n  type DatabaseDocumentListOptions,\n  type StoryBookerDatabaseDocument,\n} from \"./_internal/database.ts\";\n\nexport type TableClientGenerator = (tableName: string) => TableClient;\n\nexport class AzureDataTablesDatabaseService implements DatabaseAdapter {\n  #serviceClient: TableServiceClient;\n  #tableClientGenerator: TableClientGenerator;\n\n  constructor(serviceClient: TableServiceClient, tableClientGenerator: TableClientGenerator) {\n    this.#serviceClient = serviceClient;\n    this.#tableClientGenerator = tableClientGenerator;\n  }\n\n  metadata: DatabaseAdapter[\"metadata\"] = { name: \"Azure Tables\" };\n\n  listCollections: DatabaseAdapter[\"listCollections\"] = async (options) => {\n    const collections: string[] = [];\n    for await (const table of this.#serviceClient.listTables({\n      abortSignal: options.abortSignal,\n    })) {\n      if (table.name) {\n        collections.push(table.name);\n      }\n    }\n\n    return collections;\n  };\n\n  createCollection: DatabaseAdapter[\"createCollection\"] = async (collectionId, options) => {\n    try {\n      const tableName = genTableNameFromCollectionId(collectionId);\n      await this.#serviceClient.createTable(tableName, {\n        abortSignal: options.abortSignal,\n      });\n    } catch (error) {\n      throw new DatabaseAdapterErrors.CollectionAlreadyExistsError(collectionId, error);\n    }\n  };\n\n  hasCollection: DatabaseAdapter[\"hasCollection\"] = async (collectionId, options) => {\n    try {\n      const tableName = genTableNameFromCollectionId(collectionId);\n      const iterator = this.#serviceClient.listTables({\n        abortSignal: options.abortSignal,\n        queryOptions: { filter: `TableName eq '${tableName}'` },\n      });\n      for await (const table of iterator) {\n        if (table.name === collectionId) {\n          return true;\n        }\n      }\n\n      return false;\n    } catch {\n      return false;\n    }\n  };\n\n  deleteCollection: DatabaseAdapter[\"deleteCollection\"] = async (collectionId, options) => {\n    try {\n      const tableName = genTableNameFromCollectionId(collectionId);\n      await this.#serviceClient.deleteTable(tableName, {\n        abortSignal: options.abortSignal,\n      });\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  ): Promise<Document[]> => {\n    const { filter, limit, select, sort } = listOptions ?? {};\n\n    const tableName = genTableNameFromCollectionId(collectionId);\n    const tableClient = this.#tableClientGenerator(tableName);\n\n    const pageIterator = tableClient\n      .listEntities({\n        abortSignal: options.abortSignal,\n        queryOptions: {\n          filter: typeof filter === \"string\" ? filter : undefined,\n          select,\n        },\n      })\n      .byPage({ maxPageSize: limit });\n\n    const items: Document[] = [];\n    for await (const page of pageIterator) {\n      for (const entity of page) {\n        const item = entityToItem<Document>(entity);\n        if (filter && typeof filter === \"function\") {\n          if (filter(item)) {\n            items.push(item);\n          } else {\n            continue;\n          }\n        } else {\n          items.push(item);\n        }\n      }\n    }\n\n    if (sort && typeof sort === \"function\") {\n      items.sort(sort);\n    }\n\n    return items;\n  };\n\n  getDocument: DatabaseAdapter[\"getDocument\"] = async <\n    Document extends StoryBookerDatabaseDocument,\n  >(\n    collectionId: string,\n    documentId: string,\n    options: DatabaseAdapterOptions,\n  ): Promise<Document> => {\n    try {\n      const tableName = genTableNameFromCollectionId(collectionId);\n      const tableClient = this.#tableClientGenerator(tableName);\n      const entity = await tableClient.getEntity(collectionId, documentId, {\n        abortSignal: options.abortSignal,\n      });\n\n      return entityToItem<Document>(entity);\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n\n  hasDocument: DatabaseAdapter[\"hasDocument\"] = async (collectionId, documentId, options) => {\n    try {\n      return Boolean(await this.getDocument(collectionId, documentId, options));\n    } catch {\n      return false;\n    }\n  };\n\n  createDocument: DatabaseAdapter[\"createDocument\"] = async (\n    collectionId,\n    documentData,\n    options,\n  ) => {\n    try {\n      const tableName = genTableNameFromCollectionId(collectionId);\n      const tableClient = this.#tableClientGenerator(tableName);\n      await tableClient.createEntity(\n        {\n          ...documentData,\n          partitionKey: collectionId,\n          rowKey: documentData.id,\n        },\n        { abortSignal: options.abortSignal },\n      );\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentAlreadyExistsError(\n        collectionId,\n        documentData.id,\n        error,\n      );\n    }\n  };\n\n  deleteDocument: DatabaseAdapter[\"deleteDocument\"] = async (collectionId, documentId, options) => {\n    try {\n      const tableName = genTableNameFromCollectionId(collectionId);\n      const tableClient = this.#tableClientGenerator(tableName);\n      await tableClient.deleteEntity(collectionId, documentId, {\n        abortSignal: options.abortSignal,\n      });\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n\n  // oxlint-disable-next-line max-params\n  updateDocument: DatabaseAdapter[\"updateDocument\"] = async (\n    collectionId,\n    documentId,\n    documentData,\n    options,\n  ) => {\n    try {\n      const tableName = genTableNameFromCollectionId(collectionId);\n      const tableClient = this.#tableClientGenerator(tableName);\n      await tableClient.updateEntity(\n        { ...documentData, partitionKey: collectionId, rowKey: documentId },\n        \"Merge\",\n        { abortSignal: options.abortSignal },\n      );\n    } catch (error) {\n      throw new DatabaseAdapterErrors.DocumentDoesNotExistError(collectionId, documentId, error);\n    }\n  };\n}\n\nfunction genTableNameFromCollectionId(collectionId: string): string {\n  if (/^[A-Za-z][A-Za-z0-9]{2,62}$/.test(collectionId)) {\n    return collectionId;\n  }\n\n  return collectionId.replaceAll(/\\W/g, \"\").slice(0, 63).padEnd(3, \"X\");\n}\n\nfunction entityToItem<Item extends { id: string }>(\n  entity: TableEntityResult<Record<string, unknown>>,\n): Item {\n  return {\n    ...entity,\n    id: entity.rowKey ?? entity.partitionKey ?? entity.etag,\n  } as unknown as Item;\n}\n"],"mappings":"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"}

package/dist/azure-easy-auth.d.mts

@@ -0,0 +1,50 @@
+import { AuthAdapter, AuthAdapterOptions, StoryBookerPermission, StoryBookerPermissionAction, StoryBookerPermissionKey, StoryBookerPermissionResource, StoryBookerPermissionWithKey, StoryBookerUser } from "./~internal/adapter/auth.mjs";
+
+//#region src/adapters/azure-easy-auth.d.ts
+interface AzureEasyAuthClientPrincipal {
+  claims: {
+    typ: string;
+    val: string;
+  }[];
+  auth_typ: string;
+  name_typ: string;
+  role_typ: string;
+}
+interface AzureEasyAuthUser extends StoryBookerUser {
+  roles: string[] | null;
+  type: "application" | "user";
+  clientPrincipal?: AzureEasyAuthClientPrincipal;
+}
+type AuthAdapterAuthorise<AuthUser extends StoryBookerUser = StoryBookerUser> = (permission: StoryBookerPermissionWithKey, user: Omit<AuthUser, "permissions">) => boolean;
+/**
+ * Modify the final user details object created from EasyAuth Client Principal.
+ */
+type ModifyUserDetails = <User extends Omit<AzureEasyAuthUser, "permissions">>(user: User, options: AuthAdapterOptions) => User | Promise<User>;
+/**
+ * StoryBooker Auth adapter for Azure EasyAuth.
+ *
+ * @example
+ * ```ts
+ * const auth = new AzureEasyAuthService();
+ * ```
+ */
+declare class AzureEasyAuthService implements AuthAdapter<AzureEasyAuthUser> {
+  #private;
+  metadata: AuthAdapter["metadata"];
+  constructor(options?: {
+    /**
+     * Custom function to authorise permission for user
+     */
+    authorise?: AuthAdapterAuthorise<AzureEasyAuthUser>;
+    /**
+     * Modify the final user details object created from EasyAuth Client Principal.
+     */
+    modifyUserDetails?: ModifyUserDetails;
+  });
+  getUserDetails: AuthAdapter<AzureEasyAuthUser>["getUserDetails"];
+  login: AuthAdapter<AzureEasyAuthUser>["login"];
+  logout: AuthAdapter<AzureEasyAuthUser>["logout"];
+}
+//#endregion
+export { AuthAdapterAuthorise, AzureEasyAuthClientPrincipal, AzureEasyAuthService, AzureEasyAuthUser, ModifyUserDetails, type StoryBookerPermission, type StoryBookerPermissionAction, type StoryBookerPermissionKey, type StoryBookerPermissionResource, type StoryBookerPermissionWithKey };
+//# sourceMappingURL=azure-easy-auth.d.mts.map

package/dist/azure-easy-auth.mjs

@@ -0,0 +1,88 @@
+import { StoryBookerPermissionsAllEnabled, StoryBookerPermissionsList } from "./~internal/adapter/auth.mjs";
+import { Buffer } from "node:buffer";
+
+//#region src/adapters/azure-easy-auth.ts
+const DEFAULT_AUTHORISE = (permission, user) => {
+	if (!user) return false;
+	if (permission.action === "read") return true;
+	return Boolean(user.roles && user.roles.length > 0);
+};
+const DEFAULT_MODIFY_USER = (user) => user;
+/**
+* StoryBooker Auth adapter for Azure EasyAuth.
+*
+* @example
+* ```ts
+* const auth = new AzureEasyAuthService();
+* ```
+*/
+var AzureEasyAuthService = class {
+	#authorise;
+	#modifyUserDetails;
+	metadata = { name: "Azure Easy Auth" };
+	constructor(options) {
+		this.#authorise = options?.authorise ?? DEFAULT_AUTHORISE;
+		this.#modifyUserDetails = options?.modifyUserDetails ?? DEFAULT_MODIFY_USER;
+	}
+	getUserDetails = async (options) => {
+		const principalHeader = options.request.headers.get("x-ms-client-principal");
+		if (!principalHeader) throw new Response(`Unauthorized access. Please provide a valid EasyAuth principal header.`, { status: 401 });
+		const decodedPrincipal = Buffer.from(principalHeader, "base64").toString("utf8");
+		const clientPrincipal = JSON.parse(decodedPrincipal);
+		const claims = clientPrincipal?.claims ?? [];
+		const azpToken = claims.find((claim) => claim.typ === "azp")?.val;
+		if (azpToken) return {
+			clientPrincipal,
+			displayName: "App",
+			id: azpToken,
+			permissions: StoryBookerPermissionsAllEnabled,
+			roles: null,
+			type: "application"
+		};
+		const name = claims.find((claim) => claim.typ === "name")?.val;
+		const email = claims.find((claim) => claim.typ === clientPrincipal.name_typ)?.val;
+		const roles = claims.filter((claim) => claim.typ === clientPrincipal.role_typ || claim.typ === "roles").map((claim) => claim.val);
+		const userWithoutPermissions = {
+			clientPrincipal,
+			displayName: name ?? "",
+			id: email ?? "",
+			roles,
+			title: roles.join(", "),
+			type: "user"
+		};
+		return {
+			...await this.#modifyUserDetails(userWithoutPermissions, options),
+			permissions: authoriseUserPermissions(this.#authorise, userWithoutPermissions)
+		};
+	};
+	login = ({ request }) => {
+		const url = new URL("/.auth/login", request.url);
+		return new Response(null, {
+			headers: { Location: url.toString() },
+			status: 302
+		});
+	};
+	logout = (_user, { request }) => {
+		const url = new URL("/.auth/logout", request.url);
+		return new Response(null, {
+			headers: { Location: url.toString() },
+			status: 302
+		});
+	};
+};
+function authoriseUserPermissions(authorise, user) {
+	const permissions = {};
+	for (const key of StoryBookerPermissionsList) {
+		const [resource, action] = key.split(":");
+		permissions[key] = authorise({
+			action,
+			key,
+			resource
+		}, user);
+	}
+	return permissions;
+}
+
+//#endregion
+export { AzureEasyAuthService };
+//# sourceMappingURL=azure-easy-auth.mjs.map

package/dist/azure-easy-auth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-easy-auth.mjs","names":["DEFAULT_AUTHORISE: AuthAdapterAuthorise<AzureEasyAuthUser>","DEFAULT_MODIFY_USER: ModifyUserDetails","#authorise","#modifyUserDetails","clientPrincipal: AzureEasyAuthClientPrincipal","userWithoutPermissions: Omit<AzureEasyAuthUser, \"permissions\">","permissions: AzureEasyAuthUser[\"permissions\"]"],"sources":["../src/adapters/azure-easy-auth.ts"],"sourcesContent":["// oxlint-disable class-methods-use-this\n\nimport { Buffer } from \"node:buffer\";\nimport {\n  StoryBookerPermissionsList,\n  StoryBookerPermissionsAllEnabled,\n  type AuthAdapter,\n  type AuthAdapterOptions,\n  type StoryBookerPermissionAction,\n  type StoryBookerPermissionResource,\n  type StoryBookerPermissionWithKey,\n  type StoryBookerUser,\n} from \"./_internal/auth.ts\";\n\nexport type {\n  StoryBookerPermission,\n  StoryBookerPermissionAction,\n  StoryBookerPermissionKey,\n  StoryBookerPermissionResource,\n  StoryBookerPermissionWithKey,\n} from \"./_internal/auth.ts\";\n\nexport interface AzureEasyAuthClientPrincipal {\n  claims: { typ: string; val: string }[];\n  auth_typ: string;\n  name_typ: string;\n  role_typ: string;\n}\n\nexport interface AzureEasyAuthUser extends StoryBookerUser {\n  roles: string[] | null;\n  type: \"application\" | \"user\";\n  clientPrincipal?: AzureEasyAuthClientPrincipal;\n}\n\nexport type AuthAdapterAuthorise<AuthUser extends StoryBookerUser = StoryBookerUser> = (\n  permission: StoryBookerPermissionWithKey,\n  user: Omit<AuthUser, \"permissions\">,\n) => boolean;\n\n/**\n * Modify the final user details object created from EasyAuth Client Principal.\n */\nexport type ModifyUserDetails = <User extends Omit<AzureEasyAuthUser, \"permissions\">>(\n  user: User,\n  options: AuthAdapterOptions,\n) => User | Promise<User>;\n\nconst DEFAULT_AUTHORISE: AuthAdapterAuthorise<AzureEasyAuthUser> = (permission, user) => {\n  if (!user) {\n    return false;\n  }\n\n  if (permission.action === \"read\") {\n    return true;\n  }\n\n  return Boolean(user.roles && user.roles.length > 0);\n};\n\nconst DEFAULT_MODIFY_USER: ModifyUserDetails = (user) => user;\n\n/**\n * StoryBooker Auth adapter for Azure EasyAuth.\n *\n * @example\n * ```ts\n * const auth = new AzureEasyAuthService();\n * ```\n */\nexport class AzureEasyAuthService implements AuthAdapter<AzureEasyAuthUser> {\n  #authorise: AuthAdapterAuthorise<AzureEasyAuthUser>;\n  #modifyUserDetails: ModifyUserDetails;\n\n  metadata: AuthAdapter[\"metadata\"] = { name: \"Azure Easy Auth\" };\n\n  constructor(options?: {\n    /**\n     * Custom function to authorise permission for user\n     */\n    authorise?: AuthAdapterAuthorise<AzureEasyAuthUser>;\n    /**\n     * Modify the final user details object created from EasyAuth Client Principal.\n     */\n    modifyUserDetails?: ModifyUserDetails;\n  }) {\n    this.#authorise = options?.authorise ?? DEFAULT_AUTHORISE;\n    this.#modifyUserDetails = options?.modifyUserDetails ?? DEFAULT_MODIFY_USER;\n  }\n\n  getUserDetails: AuthAdapter<AzureEasyAuthUser>[\"getUserDetails\"] = async (options) => {\n    const principalHeader = options.request.headers.get(\"x-ms-client-principal\");\n    if (!principalHeader) {\n      throw new Response(`Unauthorized access. Please provide a valid EasyAuth principal header.`, {\n        status: 401,\n      });\n    }\n\n    // Decode and parse the claims\n    const decodedPrincipal = Buffer.from(principalHeader, \"base64\").toString(\"utf8\");\n\n    const clientPrincipal: AzureEasyAuthClientPrincipal = JSON.parse(decodedPrincipal);\n    const claims = clientPrincipal?.claims ?? [];\n\n    const azpToken = claims.find((claim) => claim.typ === \"azp\")?.val;\n    if (azpToken) {\n      const user: AzureEasyAuthUser = {\n        clientPrincipal,\n        displayName: \"App\",\n        id: azpToken,\n        permissions: StoryBookerPermissionsAllEnabled,\n        roles: null,\n        type: \"application\",\n      };\n      return user;\n    }\n\n    const name = claims.find((claim) => claim.typ === \"name\")?.val;\n    const email = claims.find((claim) => claim.typ === clientPrincipal.name_typ)?.val;\n    const roles = claims\n      .filter((claim) => claim.typ === clientPrincipal.role_typ || claim.typ === \"roles\")\n      .map((claim) => claim.val);\n\n    const userWithoutPermissions: Omit<AzureEasyAuthUser, \"permissions\"> = {\n      clientPrincipal,\n      displayName: name ?? \"\",\n      id: email ?? \"\",\n      roles,\n      title: roles.join(\", \"),\n      type: \"user\",\n    };\n\n    return {\n      ...(await this.#modifyUserDetails(userWithoutPermissions, options)),\n      permissions: authoriseUserPermissions(this.#authorise, userWithoutPermissions),\n    };\n  };\n\n  login: AuthAdapter<AzureEasyAuthUser>[\"login\"] = ({ request }) => {\n    const url = new URL(\"/.auth/login\", request.url);\n\n    return new Response(null, {\n      headers: { Location: url.toString() },\n      status: 302,\n    });\n  };\n\n  logout: AuthAdapter<AzureEasyAuthUser>[\"logout\"] = (_user, { request }) => {\n    const url = new URL(\"/.auth/logout\", request.url);\n\n    return new Response(null, {\n      headers: { Location: url.toString() },\n      status: 302,\n    });\n  };\n}\n\nfunction authoriseUserPermissions(\n  authorise: AuthAdapterAuthorise<AzureEasyAuthUser>,\n  user: Omit<AzureEasyAuthUser, \"permissions\">,\n): AzureEasyAuthUser[\"permissions\"] {\n  const permissions: AzureEasyAuthUser[\"permissions\"] = {};\n\n  for (const key of StoryBookerPermissionsList) {\n    const [resource, action] = key.split(\":\") as [\n      StoryBookerPermissionResource,\n      StoryBookerPermissionAction,\n    ];\n    const permission: StoryBookerPermissionWithKey = { action, key, resource };\n    permissions[key] = authorise(permission, user);\n  }\n\n  return permissions;\n}\n"],"mappings":";;;;AAgDA,MAAMA,qBAA8D,YAAY,SAAS;AACvF,KAAI,CAAC,KACH,QAAO;AAGT,KAAI,WAAW,WAAW,OACxB,QAAO;AAGT,QAAO,QAAQ,KAAK,SAAS,KAAK,MAAM,SAAS,EAAE;;AAGrD,MAAMC,uBAA0C,SAAS;;;;;;;;;AAUzD,IAAa,uBAAb,MAA4E;CAC1E;CACA;CAEA,WAAoC,EAAE,MAAM,mBAAmB;CAE/D,YAAY,SAST;AACD,QAAKC,YAAa,SAAS,aAAa;AACxC,QAAKC,oBAAqB,SAAS,qBAAqB;;CAG1D,iBAAmE,OAAO,YAAY;EACpF,MAAM,kBAAkB,QAAQ,QAAQ,QAAQ,IAAI,wBAAwB;AAC5E,MAAI,CAAC,gBACH,OAAM,IAAI,SAAS,0EAA0E,EAC3F,QAAQ,KACT,CAAC;EAIJ,MAAM,mBAAmB,OAAO,KAAK,iBAAiB,SAAS,CAAC,SAAS,OAAO;EAEhF,MAAMC,kBAAgD,KAAK,MAAM,iBAAiB;EAClF,MAAM,SAAS,iBAAiB,UAAU,EAAE;EAE5C,MAAM,WAAW,OAAO,MAAM,UAAU,MAAM,QAAQ,MAAM,EAAE;AAC9D,MAAI,SASF,QARgC;GAC9B;GACA,aAAa;GACb,IAAI;GACJ,aAAa;GACb,OAAO;GACP,MAAM;GACP;EAIH,MAAM,OAAO,OAAO,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;EAC3D,MAAM,QAAQ,OAAO,MAAM,UAAU,MAAM,QAAQ,gBAAgB,SAAS,EAAE;EAC9E,MAAM,QAAQ,OACX,QAAQ,UAAU,MAAM,QAAQ,gBAAgB,YAAY,MAAM,QAAQ,QAAQ,CAClF,KAAK,UAAU,MAAM,IAAI;EAE5B,MAAMC,yBAAiE;GACrE;GACA,aAAa,QAAQ;GACrB,IAAI,SAAS;GACb;GACA,OAAO,MAAM,KAAK,KAAK;GACvB,MAAM;GACP;AAED,SAAO;GACL,GAAI,MAAM,MAAKF,kBAAmB,wBAAwB,QAAQ;GAClE,aAAa,yBAAyB,MAAKD,WAAY,uBAAuB;GAC/E;;CAGH,SAAkD,EAAE,cAAc;EAChE,MAAM,MAAM,IAAI,IAAI,gBAAgB,QAAQ,IAAI;AAEhD,SAAO,IAAI,SAAS,MAAM;GACxB,SAAS,EAAE,UAAU,IAAI,UAAU,EAAE;GACrC,QAAQ;GACT,CAAC;;CAGJ,UAAoD,OAAO,EAAE,cAAc;EACzE,MAAM,MAAM,IAAI,IAAI,iBAAiB,QAAQ,IAAI;AAEjD,SAAO,IAAI,SAAS,MAAM;GACxB,SAAS,EAAE,UAAU,IAAI,UAAU,EAAE;GACrC,QAAQ;GACT,CAAC;;;AAIN,SAAS,yBACP,WACA,MACkC;CAClC,MAAMI,cAAgD,EAAE;AAExD,MAAK,MAAM,OAAO,4BAA4B;EAC5C,MAAM,CAAC,UAAU,UAAU,IAAI,MAAM,IAAI;AAKzC,cAAY,OAAO,UAD8B;GAAE;GAAQ;GAAK;GAAU,EACjC,KAAK;;AAGhD,QAAO"}

package/dist/azure-functions.d.mts

@@ -0,0 +1,62 @@
+import { AuthAdapter, StoryBookerUser } from "./~internal/adapter/auth.mjs";
+import { RouterOptions } from "./~internal/types.mjs";
+import { HttpFunctionOptions, HttpTriggerOptions, SetupOptions, TimerFunctionOptions } from "@azure/functions";
+export * from "storybooker/types";
+
+//#region src/adapters/azure-functions.d.ts
+
+/**
+ * Minimal representation of Azure Functions App namespace
+ * to register HTTP and Timer functions.
+ */
+interface FunctionsApp {
+  http(name: string, options: HttpFunctionOptions): void;
+  setup?(options: SetupOptions): void;
+  timer?(name: string, options: TimerFunctionOptions): void;
+}
+/**
+ * Options to register the storybooker router
+ */
+interface RegisterStorybookerRouterOptions<User extends StoryBookerUser> extends Omit<RouterOptions<User>, "auth"> {
+  /**
+   * For authenticating routes, either use an AuthAdapter or Functions auth-level property.
+   *
+   * - AuthAdapter allows full customization of authentication logic. This will set the function to "anonymous" auth-level.
+   * - Auth-level is a simpler way to set predefined authentication levels ("function", "admin").
+   *   This is a good option to set if the service is used in
+   *   Headless mode and requires single token authentication for all the requests.
+   *
+   * @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)
+   */
+  auth?: AuthAdapter<User> | Exclude<HttpTriggerOptions["authLevel"], "anonymous">;
+  /**
+   * Define the route on which all router is placed.
+   * Can be a sub-path of the main API route.
+   *
+   * @default ''
+   */
+  route?: string;
+  /**
+   * Modify the cron-schedule of timer function
+   * which purge outdated storybooks.
+   *
+   * Pass `null` to disable auto-purge functionality.
+   *
+   * @default "0 0 0 * * *" // Every midnight
+   */
+  purgeScheduleCron?: string | null;
+}
+/**
+ * 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
+ */
+declare function registerStoryBookerRouter<User extends StoryBookerUser>(app: FunctionsApp, options: RegisterStorybookerRouterOptions<User>): void;
+//#endregion
+export { RegisterStorybookerRouterOptions, registerStoryBookerRouter };
+//# sourceMappingURL=azure-functions.d.mts.map