@nextlyhq/storage-vercel-blob 0.0.2-alpha.71 → 0.0.2-alpha.73

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { BlobNotFoundError, del, head, list, put } from "@vercel/blob";
-// ../nextly/dist/nextly-error-CwDiSPDF.mjs
+// ../nextly/dist/nextly-error-BLaA7N-v.mjs
 function isDbError(err) {
 	if (!err || typeof err !== "object") return false;
 	const obj = err;
@@ -76,6 +76,8 @@ const NEXTLY_ERROR_STATUS = {
 	SETUP_TOKEN_REQUIRED: 403,
 	API_KEY_ROLE_ABOVE_CREATOR: 403,
 	NOT_FOUND: 404,
+	ENTITY_REMOVED_FROM_CODE: 409,
+	ENTITY_NOT_MIGRATED: 409,
 	METHOD_NOT_ALLOWED: 405,
 	RANGE_NOT_SATISFIABLE: 416,
 	CONFLICT: 409,
@@ -89,6 +91,7 @@ const NEXTLY_ERROR_STATUS = {
 	DATABASE_BUSY: 503,
 	EXTERNAL_SERVICE_ERROR: 502,
 	SERVICE_UNAVAILABLE: 503,
+	CONFIGURATION_ERROR: 500,
 	EXTERNAL_URL_BLOCKED: 400,
 	EXTERNAL_REQUEST_FAILED: 502,
 	FILENAME_INVALID: 400,
@@ -130,7 +133,7 @@ const NEXTLY_ERROR_STATUS = {
 	NEXTLY_SCHEMA_RENAME_UNKNOWN_TARGET: 400,
 	NEXTLY_PLUGIN_CLIENT_CONFIG_INVALID: 500,
 	NEXTLY_PLUGIN_ADMIN_WIDGET_INVALID: 500,
-	NEXTLY_ADMIN_COMPONENT_MAP_STALE: 500,
+	NEXTLY_PLUGIN_REMOVED_WIDGET_CHANNEL: 500,
 	NEXTLY_PLUGIN_DOCUMENT_VIEW_INVALID: 500,
 	PLUGIN_RESOLUTION_ERROR: 500,
 	PLUGIN_DEPENDENCY_NOT_INSTALLED: 409,
@@ -412,6 +415,61 @@ var NextlyError = class NextlyError extends Error {
 		});
 	}
 	/**
+	* Something only a signed-in person can do, asked by a caller that is not
+	* one: an API key, or a request acting as no person. Forbidden, and the
+	* message says so, since it is about what kind of caller asked, not about
+	* the caller's permissions. `doing` completes "Only a signed-in person can".
+	*/
+	static personOnly(opts) {
+		return new NextlyError({
+			code: "FORBIDDEN",
+			publicMessage: `Only a signed-in person can ${opts.doing}.`,
+			logContext: opts.logContext
+		});
+	}
+	/**
+	* A role or permission built into Nextly, which is never changed or
+	* deleted. Forbidden, and the message says so: it is a fact about the role,
+	* not about the caller's permissions.
+	*/
+	static builtIn(opts) {
+		const done = {
+			change: "changed",
+			delete: "deleted",
+			assign: "assigned",
+			inherit: "inherited"
+		}[opts.change];
+		return new NextlyError({
+			code: "FORBIDDEN",
+			publicMessage: `This ${opts.thing} is built in, so it can't be ${done}.`,
+			logContext: opts.logContext
+		});
+	}
+	/**
+	* A request from a site not allowed to make it: its own `Origin` names a
+	* site the installation does not allow. Forbidden, and the message says so;
+	* the origin is the caller's own, so naming its kind tells them nothing.
+	*/
+	static originRefused(opts) {
+		return new NextlyError({
+			code: "FORBIDDEN",
+			publicMessage: "This request came from a site that isn't allowed to make it.",
+			logContext: opts?.logContext
+		});
+	}
+	/**
+	* A Single deleted without `force`: Singles hold a site's lasting settings,
+	* so they are not deleted from here, only by an admin or CLI clean-up that
+	* passes `force`. Forbidden, and the message says so.
+	*/
+	static singleNotDeletable(opts) {
+		return new NextlyError({
+			code: "FORBIDDEN",
+			publicMessage: "A Single can't be deleted from here.",
+			logContext: opts?.logContext
+		});
+	}
+	/**
 	* A collection, Single or component defined in code, which is changed by
 	* changing its code and not from here. Forbidden, and the message says so:
 	* it is a fact about the thing, not about the caller's permissions, so it
@@ -426,6 +484,57 @@ var NextlyError = class NextlyError extends Error {
 		});
 	}
 	/**
+	* A write to an entry of a collection or Single removed from code: its
+	* registry row says the app's code defines it, and the running configuration
+	* no longer declares it. Its entries are read-only until it is retired or
+	* declared again, so the message names the entity, says what happened and
+	* gives both ways out. `publicData` carries the kind and the slug, which the
+	* caller named, so a client can mark the entity without parsing the sentence.
+	*/
+	static removedFromCode(opts) {
+		const thing = opts.kind === "single" ? "Single" : "collection";
+		const its = opts.kind === "single" ? "it" : "its entries";
+		return new NextlyError({
+			code: "ENTITY_REMOVED_FROM_CODE",
+			publicMessage: `The ${thing} "${opts.slug}" was removed from code, so ${its} can't be changed. To retire it, run \`nextly migrate:create\` and then \`nextly migrate\`. To keep it, declare it again in nextly.config.ts.`,
+			publicData: {
+				kind: opts.kind,
+				slug: opts.slug
+			},
+			logContext: {
+				kind: opts.kind,
+				slug: opts.slug,
+				...opts.logContext
+			}
+		});
+	}
+	/**
+	* A read or write of a collection or Single the database has not been
+	* migrated for: the column of one of its declared fields is missing, its
+	* table is missing, or this running instance never registered it (an
+	* entity a migration added after the instance started). The message names
+	* the entity, the field or the table, and `nextly migrate`; the driver's
+	* error stays on `cause`, for the log, so no SQL reaches the answer.
+	*/
+	static notMigrated(opts) {
+		const { cause, logContext, ...publicData } = opts;
+		const entity = `${publicData.kind === "single" ? "Single" : "collection"} "${publicData.slug}"`;
+		const field = publicData.field === void 0 ? "a field" : `the field "${publicData.field}"`;
+		const table = publicData.table === void 0 ? "" : ` "${publicData.table}"`;
+		const publicMessage = publicData.reason === "column" ? `The database has not been migrated for ${field} of the ${entity}. Run \`nextly migrate\`.` : publicData.reason === "table" ? `The database has not been migrated for the ${entity}: its table${table} does not exist. Run \`nextly migrate\`.` : `The ${entity}${publicData.table === void 0 ? "" : ` (table "${publicData.table}")`} is not registered in this running instance. Run \`nextly migrate\`, then restart the server.`;
+		return new NextlyError({
+			code: "ENTITY_NOT_MIGRATED",
+			publicMessage,
+			publicData,
+			logMessage: "The database has not been migrated for this entity",
+			logContext: {
+				...publicData,
+				...logContext
+			},
+			cause
+		});
+	}
+	/**
 	* An autosave where the collection or Single does not autosave: its owner
 	* switched autosave off, or it keeps no drafts to autosave into. Forbidden,
 	* and the message says so, since it is a setting and not a permission.
@@ -569,6 +678,19 @@ var NextlyError = class NextlyError extends Error {
 			logContext: opts?.logContext
 		});
 	}
+	/**
+	* The app is set up so nextly cannot work: a missing `config`, or a Next.js
+	* or React outside the supported ranges. The public message stays generic;
+	* what to change goes in `logMessage`, for the operator.
+	*/
+	static configuration(opts) {
+		return new NextlyError({
+			code: "CONFIGURATION_ERROR",
+			publicMessage: "Server configuration error.",
+			logMessage: opts.logMessage,
+			logContext: opts.logContext
+		});
+	}
 	static serviceUnavailable(opts) {
 		return new NextlyError({
 			code: "SERVICE_UNAVAILABLE",
@@ -658,7 +780,7 @@ function ipv4ToInt(ip) {
 	}
 	return acc >>> 0;
 }
-// ../nextly/dist/validate-external-url-CnZrcJdP.mjs
+// ../nextly/dist/validate-external-url-DpPuwVvV.mjs
 const IPV4_RE = /^(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)$/;
 /**
 * IPv4 CIDR ranges that must NEVER be the destination of an outbound