@adcp/sdk 16.0.0-beta.3 → 16.0.0-beta.5

package/dist/lib/reporting/azure/index.js

@@ -1,266 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var azure_exports = {};
-__export(azure_exports, {
-  createAzureBlobReportingRowObjectProviderV1: () => createAzureBlobReportingRowObjectProviderV1
-});
-module.exports = __toCommonJS(azure_exports);
-var import_node_crypto = require("node:crypto");
-var import_row_storage_errors = require('../ledger/row-storage-errors.js');
-var import_row_storage_provider_io = require('../ledger/row-storage-provider-io.js');
-const ACCOUNT = /^[a-z0-9]{3,24}$/;
-const CONTAINER = /^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){2,62}$/;
-const VERSION_ID = /^[0-9A-Za-z:.+-]{1,64}$/;
-function statusOf(error) {
-  const status = Number(error?.statusCode);
-  return Number.isInteger(status) ? status : void 0;
-}
-function codeOf(error) {
-  const value = error?.code ?? error?.details?.errorCode;
-  return typeof value === "string" ? value : "";
-}
-const isConflict = (error) => statusOf(error) === 409 || statusOf(error) === 412 || codeOf(error) === "BlobAlreadyExists";
-const isMissing = (error) => statusOf(error) === 404 || statusOf(error) === 412;
-const isForbidden = (error) => statusOf(error) === 401 || statusOf(error) === 403;
-function versionOf(response) {
-  const id = response.versionId;
-  if (typeof id !== "string" || !VERSION_ID.test(id)) {
-    throw new import_row_storage_errors.ReportingRowStoreError(
-      "UNSAFE_BINDING",
-      "store returned no blob versionId; blob versioning must be enabled on the storage account so deletes are fenced to one write"
-    );
-  }
-  return id;
-}
-function servedVersion(response, versionId) {
-  return response.versionId === versionId;
-}
-function metadataOf(metadata) {
-  const result = {};
-  for (const [name, value] of Object.entries(metadata)) {
-    const identifier = name.replace(/[^A-Za-z0-9_]/g, "_");
-    result[/^[A-Za-z_]/.test(identifier) ? identifier : `_${identifier}`] = value;
-  }
-  return result;
-}
-function createAzureBlobReportingRowObjectProviderV1(options) {
-  if (!options || typeof options !== "object") {
-    throw new import_row_storage_errors.ReportingRowStoreError("INVALID_INPUT", "Azure Blob row provider options are required");
-  }
-  const clients = (0, import_row_storage_provider_io.reportingRowClientMap)(options.clients);
-  const isClient = (value) => !!value && typeof value === "object" && typeof value.getContainerClient === "function" && typeof value.accountName === "string";
-  if (options.client !== void 0 && !isClient(options.client) || [...clients.values()].some((client) => !isClient(client)) || options.client === void 0 && clients.size === 0) {
-    throw new import_row_storage_errors.ReportingRowStoreError("INVALID_INPUT", "inject an official BlobServiceClient as client or clients");
-  }
-  const validateLocation = (location) => {
-    (0, import_row_storage_provider_io.assertReportingRowLocationKeys)(location, ["account", "container"]);
-    if (!ACCOUNT.test(location.account)) {
-      throw new import_row_storage_errors.ReportingRowStoreError("INVALID_INPUT", "Azure storage account name is invalid");
-    }
-    if (!CONTAINER.test(location.container)) {
-      throw new import_row_storage_errors.ReportingRowStoreError("INVALID_INPUT", "Azure container name is invalid");
-    }
-  };
-  const containerFor = (input) => {
-    validateLocation(input.location);
-    const client = (0, import_row_storage_provider_io.selectReportingRowClient)(options.client, clients, input.credentialRef);
-    if (client.accountName !== input.location.account) {
-      throw new import_row_storage_errors.ReportingRowStoreError("UNSAFE_BINDING", "client does not belong to the binding account");
-    }
-    return client.getContainerClient(input.location.container);
-  };
-  const blobFor = (input) => {
-    if (typeof input.objectRef !== "string" || input.objectRef.length === 0 || input.objectRef.length > 1024) {
-      throw new import_row_storage_errors.ReportingRowStoreError("INVALID_INPUT", "object key is invalid");
-    }
-    return containerFor(input).getBlockBlobClient(input.objectRef);
-  };
-  const pinned = (blob, nativeVersionRef) => typeof nativeVersionRef === "string" && VERSION_ID.test(nativeVersionRef) ? { blob: blob.withVersion(nativeVersionRef), versionId: nativeVersionRef } : null;
-  async function assertCreateOnlyEnforced(container, prefix, signal) {
-    const blob = container.getBlockBlobClient(`${prefix}/.adcp-probe/${(0, import_node_crypto.randomUUID)()}`);
-    const versionIds = [];
-    let written = false;
-    const upload = async (body) => {
-      const bytes = Buffer.from(body);
-      const response = await blob.upload(bytes, bytes.byteLength, {
-        conditions: { ifNoneMatch: "*" },
-        blobHTTPHeaders: { blobContentType: "application/x-ndjson", blobCacheControl: "no-store" },
-        abortSignal: signal
-      });
-      written = true;
-      if (response.versionId) versionIds.push(response.versionId);
-      versionOf(response);
-    };
-    try {
-      await upload('{"probe":1}\n');
-      try {
-        await upload('{"probe":2}\n');
-      } catch (error) {
-        if (isConflict(error)) return;
-        throw error;
-      }
-      throw new import_row_storage_errors.ReportingRowStoreError("UNSAFE_BINDING", "store ignores If-None-Match and replaces blobs");
-    } finally {
-      if (written && !signal.aborted) {
-        await blob.delete({ abortSignal: signal }).catch(() => void 0);
-        for (const versionId of versionIds) {
-          if (signal.aborted) break;
-          await blob.withVersion(versionId).delete({ abortSignal: signal }).catch(() => void 0);
-        }
-      }
-    }
-  }
-  return {
-    name: "azure_blob",
-    rangedReads: true,
-    validateLocation,
-    probe(input, context) {
-      return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
-        const container = containerFor(input);
-        let properties;
-        try {
-          properties = await container.getProperties({ abortSignal: context.signal });
-        } catch (error) {
-          if (statusOf(error) === 404) throw new import_row_storage_errors.ReportingRowStoreError("UNSAFE_BINDING", "container does not exist");
-          if (isForbidden(error)) throw new import_row_storage_errors.ReportingRowStoreError("UNSAFE_BINDING", "container is not accessible");
-          throw error;
-        }
-        if (properties.blobPublicAccess) {
-          throw new import_row_storage_errors.ReportingRowStoreError("UNSAFE_BINDING", "container allows anonymous read access");
-        }
-        await assertCreateOnlyEnforced(container, input.prefix, context.signal);
-      });
-    },
-    putIfAbsent(input, context) {
-      return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
-        const blob = blobFor(input);
-        const bytes = Buffer.from(input.bytes);
-        try {
-          const response = await blob.upload(bytes, bytes.byteLength, {
-            conditions: { ifNoneMatch: "*" },
-            blobHTTPHeaders: { blobContentType: input.contentType, blobCacheControl: "no-store" },
-            metadata: metadataOf(input.metadata),
-            abortSignal: context.signal
-          });
-          return { created: true, nativeVersionRef: versionOf(response) };
-        } catch (error) {
-          if (!isConflict(error)) throw error;
-        }
-        const existing = await blob.getProperties({ abortSignal: context.signal });
-        return { created: false, nativeVersionRef: versionOf(existing) };
-      });
-    },
-    get(input, context) {
-      return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
-        const blob = blobFor(input);
-        (0, import_row_storage_provider_io.assertReportingRowReadBounds)(input);
-        const target = pinned(blob, input.nativeVersionRef);
-        if (target === null) return null;
-        try {
-          if (input.range?.length === 0) {
-            const properties = await target.blob.getProperties({ abortSignal: context.signal });
-            if (!servedVersion(properties, target.versionId)) return null;
-            if (input.range.offset > Number(properties.contentLength ?? 0)) {
-              throw new import_row_storage_errors.ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "requested range exceeds the stored object");
-            }
-            return Buffer.alloc(0);
-          }
-          const response = await target.blob.download(input.range?.offset ?? 0, input.range?.length, {
-            abortSignal: context.signal
-          });
-          const body = response.readableStreamBody;
-          if (!body || typeof body[Symbol.asyncIterator] !== "function") {
-            throw new import_row_storage_errors.ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob body is not a stream");
-          }
-          if (!servedVersion(response, target.versionId)) {
-            body.destroy?.();
-            return null;
-          }
-          if (typeof response.contentLength === "number" && response.contentLength > input.maxBytes) {
-            body.destroy?.();
-            throw new import_row_storage_errors.ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "stored object exceeds its recorded size");
-          }
-          return await (0, import_row_storage_provider_io.readReportingRowStream)(body, input.maxBytes, context.signal);
-        } catch (error) {
-          if (isMissing(error)) return null;
-          if (statusOf(error) === 400) return null;
-          if (statusOf(error) === 416 || codeOf(error) === "InvalidRange") {
-            throw new import_row_storage_errors.ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "requested range exceeds the stored object");
-          }
-          throw error;
-        }
-      });
-    },
-    stat(input, context) {
-      return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
-        const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersionRef);
-        if (target === null) return null;
-        try {
-          const properties = await target.blob.getProperties({ abortSignal: context.signal });
-          if (!servedVersion(properties, target.versionId)) return null;
-          const size = properties.contentLength;
-          if (typeof size !== "number" || !Number.isSafeInteger(size) || size < 0) {
-            throw new import_row_storage_errors.ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob metadata is malformed");
-          }
-          return { nativeVersionRef: target.versionId, sizeBytes: size };
-        } catch (error) {
-          if (isMissing(error) || statusOf(error) === 400) return null;
-          throw error;
-        }
-      });
-    },
-    delete(input, context) {
-      return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
-        const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersionRef);
-        if (target === null) return "absent";
-        const signal = context.signal;
-        try {
-          const recorded = await target.blob.getProperties({ abortSignal: signal });
-          if (recorded.versionId !== target.versionId) return "absent";
-        } catch (error) {
-          if (isMissing(error) || statusOf(error) === 400) return "absent";
-          throw error;
-        }
-        let deletedCurrent = false;
-        try {
-          const current = await blob.getProperties({ abortSignal: signal });
-          if (current.versionId === target.versionId && current.etag) {
-            await blob.delete({ conditions: { ifMatch: current.etag }, abortSignal: signal });
-            deletedCurrent = true;
-          }
-        } catch (error) {
-          if (!isMissing(error)) throw error;
-        }
-        try {
-          await target.blob.delete({ abortSignal: signal });
-          return "deleted";
-        } catch (error) {
-          if (isMissing(error) || statusOf(error) === 400) return deletedCurrent ? "deleted" : "absent";
-          throw error;
-        }
-      });
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createAzureBlobReportingRowObjectProviderV1
-});

package/dist/lib/reporting/azure/index.mjs

@@ -1,249 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { ReportingRowStoreError } from "../ledger/row-storage-errors.mjs";
-import {
-  assertReportingRowLocationKeys,
-  assertReportingRowReadBounds,
-  readReportingRowStream,
-  reportingRowClientMap,
-  runReportingRowProviderOperation,
-  selectReportingRowClient
-} from "../ledger/row-storage-provider-io.mjs";
-const ACCOUNT = /^[a-z0-9]{3,24}$/;
-const CONTAINER = /^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){2,62}$/;
-const VERSION_ID = /^[0-9A-Za-z:.+-]{1,64}$/;
-function statusOf(error) {
-  const status = Number(error?.statusCode);
-  return Number.isInteger(status) ? status : void 0;
-}
-function codeOf(error) {
-  const value = error?.code ?? error?.details?.errorCode;
-  return typeof value === "string" ? value : "";
-}
-const isConflict = (error) => statusOf(error) === 409 || statusOf(error) === 412 || codeOf(error) === "BlobAlreadyExists";
-const isMissing = (error) => statusOf(error) === 404 || statusOf(error) === 412;
-const isForbidden = (error) => statusOf(error) === 401 || statusOf(error) === 403;
-function versionOf(response) {
-  const id = response.versionId;
-  if (typeof id !== "string" || !VERSION_ID.test(id)) {
-    throw new ReportingRowStoreError(
-      "UNSAFE_BINDING",
-      "store returned no blob versionId; blob versioning must be enabled on the storage account so deletes are fenced to one write"
-    );
-  }
-  return id;
-}
-function servedVersion(response, versionId) {
-  return response.versionId === versionId;
-}
-function metadataOf(metadata) {
-  const result = {};
-  for (const [name, value] of Object.entries(metadata)) {
-    const identifier = name.replace(/[^A-Za-z0-9_]/g, "_");
-    result[/^[A-Za-z_]/.test(identifier) ? identifier : `_${identifier}`] = value;
-  }
-  return result;
-}
-function createAzureBlobReportingRowObjectProviderV1(options) {
-  if (!options || typeof options !== "object") {
-    throw new ReportingRowStoreError("INVALID_INPUT", "Azure Blob row provider options are required");
-  }
-  const clients = reportingRowClientMap(options.clients);
-  const isClient = (value) => !!value && typeof value === "object" && typeof value.getContainerClient === "function" && typeof value.accountName === "string";
-  if (options.client !== void 0 && !isClient(options.client) || [...clients.values()].some((client) => !isClient(client)) || options.client === void 0 && clients.size === 0) {
-    throw new ReportingRowStoreError("INVALID_INPUT", "inject an official BlobServiceClient as client or clients");
-  }
-  const validateLocation = (location) => {
-    assertReportingRowLocationKeys(location, ["account", "container"]);
-    if (!ACCOUNT.test(location.account)) {
-      throw new ReportingRowStoreError("INVALID_INPUT", "Azure storage account name is invalid");
-    }
-    if (!CONTAINER.test(location.container)) {
-      throw new ReportingRowStoreError("INVALID_INPUT", "Azure container name is invalid");
-    }
-  };
-  const containerFor = (input) => {
-    validateLocation(input.location);
-    const client = selectReportingRowClient(options.client, clients, input.credentialRef);
-    if (client.accountName !== input.location.account) {
-      throw new ReportingRowStoreError("UNSAFE_BINDING", "client does not belong to the binding account");
-    }
-    return client.getContainerClient(input.location.container);
-  };
-  const blobFor = (input) => {
-    if (typeof input.objectRef !== "string" || input.objectRef.length === 0 || input.objectRef.length > 1024) {
-      throw new ReportingRowStoreError("INVALID_INPUT", "object key is invalid");
-    }
-    return containerFor(input).getBlockBlobClient(input.objectRef);
-  };
-  const pinned = (blob, nativeVersionRef) => typeof nativeVersionRef === "string" && VERSION_ID.test(nativeVersionRef) ? { blob: blob.withVersion(nativeVersionRef), versionId: nativeVersionRef } : null;
-  async function assertCreateOnlyEnforced(container, prefix, signal) {
-    const blob = container.getBlockBlobClient(`${prefix}/.adcp-probe/${randomUUID()}`);
-    const versionIds = [];
-    let written = false;
-    const upload = async (body) => {
-      const bytes = Buffer.from(body);
-      const response = await blob.upload(bytes, bytes.byteLength, {
-        conditions: { ifNoneMatch: "*" },
-        blobHTTPHeaders: { blobContentType: "application/x-ndjson", blobCacheControl: "no-store" },
-        abortSignal: signal
-      });
-      written = true;
-      if (response.versionId) versionIds.push(response.versionId);
-      versionOf(response);
-    };
-    try {
-      await upload('{"probe":1}\n');
-      try {
-        await upload('{"probe":2}\n');
-      } catch (error) {
-        if (isConflict(error)) return;
-        throw error;
-      }
-      throw new ReportingRowStoreError("UNSAFE_BINDING", "store ignores If-None-Match and replaces blobs");
-    } finally {
-      if (written && !signal.aborted) {
-        await blob.delete({ abortSignal: signal }).catch(() => void 0);
-        for (const versionId of versionIds) {
-          if (signal.aborted) break;
-          await blob.withVersion(versionId).delete({ abortSignal: signal }).catch(() => void 0);
-        }
-      }
-    }
-  }
-  return {
-    name: "azure_blob",
-    rangedReads: true,
-    validateLocation,
-    probe(input, context) {
-      return runReportingRowProviderOperation(context.signal, async () => {
-        const container = containerFor(input);
-        let properties;
-        try {
-          properties = await container.getProperties({ abortSignal: context.signal });
-        } catch (error) {
-          if (statusOf(error) === 404) throw new ReportingRowStoreError("UNSAFE_BINDING", "container does not exist");
-          if (isForbidden(error)) throw new ReportingRowStoreError("UNSAFE_BINDING", "container is not accessible");
-          throw error;
-        }
-        if (properties.blobPublicAccess) {
-          throw new ReportingRowStoreError("UNSAFE_BINDING", "container allows anonymous read access");
-        }
-        await assertCreateOnlyEnforced(container, input.prefix, context.signal);
-      });
-    },
-    putIfAbsent(input, context) {
-      return runReportingRowProviderOperation(context.signal, async () => {
-        const blob = blobFor(input);
-        const bytes = Buffer.from(input.bytes);
-        try {
-          const response = await blob.upload(bytes, bytes.byteLength, {
-            conditions: { ifNoneMatch: "*" },
-            blobHTTPHeaders: { blobContentType: input.contentType, blobCacheControl: "no-store" },
-            metadata: metadataOf(input.metadata),
-            abortSignal: context.signal
-          });
-          return { created: true, nativeVersionRef: versionOf(response) };
-        } catch (error) {
-          if (!isConflict(error)) throw error;
-        }
-        const existing = await blob.getProperties({ abortSignal: context.signal });
-        return { created: false, nativeVersionRef: versionOf(existing) };
-      });
-    },
-    get(input, context) {
-      return runReportingRowProviderOperation(context.signal, async () => {
-        const blob = blobFor(input);
-        assertReportingRowReadBounds(input);
-        const target = pinned(blob, input.nativeVersionRef);
-        if (target === null) return null;
-        try {
-          if (input.range?.length === 0) {
-            const properties = await target.blob.getProperties({ abortSignal: context.signal });
-            if (!servedVersion(properties, target.versionId)) return null;
-            if (input.range.offset > Number(properties.contentLength ?? 0)) {
-              throw new ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "requested range exceeds the stored object");
-            }
-            return Buffer.alloc(0);
-          }
-          const response = await target.blob.download(input.range?.offset ?? 0, input.range?.length, {
-            abortSignal: context.signal
-          });
-          const body = response.readableStreamBody;
-          if (!body || typeof body[Symbol.asyncIterator] !== "function") {
-            throw new ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob body is not a stream");
-          }
-          if (!servedVersion(response, target.versionId)) {
-            body.destroy?.();
-            return null;
-          }
-          if (typeof response.contentLength === "number" && response.contentLength > input.maxBytes) {
-            body.destroy?.();
-            throw new ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "stored object exceeds its recorded size");
-          }
-          return await readReportingRowStream(body, input.maxBytes, context.signal);
-        } catch (error) {
-          if (isMissing(error)) return null;
-          if (statusOf(error) === 400) return null;
-          if (statusOf(error) === 416 || codeOf(error) === "InvalidRange") {
-            throw new ReportingRowStoreError("ROWS_INTEGRITY_FAILED", "requested range exceeds the stored object");
-          }
-          throw error;
-        }
-      });
-    },
-    stat(input, context) {
-      return runReportingRowProviderOperation(context.signal, async () => {
-        const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersionRef);
-        if (target === null) return null;
-        try {
-          const properties = await target.blob.getProperties({ abortSignal: context.signal });
-          if (!servedVersion(properties, target.versionId)) return null;
-          const size = properties.contentLength;
-          if (typeof size !== "number" || !Number.isSafeInteger(size) || size < 0) {
-            throw new ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob metadata is malformed");
-          }
-          return { nativeVersionRef: target.versionId, sizeBytes: size };
-        } catch (error) {
-          if (isMissing(error) || statusOf(error) === 400) return null;
-          throw error;
-        }
-      });
-    },
-    delete(input, context) {
-      return runReportingRowProviderOperation(context.signal, async () => {
-        const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersionRef);
-        if (target === null) return "absent";
-        const signal = context.signal;
-        try {
-          const recorded = await target.blob.getProperties({ abortSignal: signal });
-          if (recorded.versionId !== target.versionId) return "absent";
-        } catch (error) {
-          if (isMissing(error) || statusOf(error) === 400) return "absent";
-          throw error;
-        }
-        let deletedCurrent = false;
-        try {
-          const current = await blob.getProperties({ abortSignal: signal });
-          if (current.versionId === target.versionId && current.etag) {
-            await blob.delete({ conditions: { ifMatch: current.etag }, abortSignal: signal });
-            deletedCurrent = true;
-          }
-        } catch (error) {
-          if (!isMissing(error)) throw error;
-        }
-        try {
-          await target.blob.delete({ abortSignal: signal });
-          return "deleted";
-        } catch (error) {
-          if (isMissing(error) || statusOf(error) === 400) return deletedCurrent ? "deleted" : "absent";
-          throw error;
-        }
-      });
-    }
-  };
-}
-export {
-  createAzureBlobReportingRowObjectProviderV1
-};