@rebasepro/server 0.11.1-canary.gfd39654 → 0.12.0

package/dist/{src-BYbxB4PR.js → src-Ivjud8jD.js}

@@ -339,6 +339,161 @@ var ADMIN_COLLECTION_KEYS = [
 	"sort",
 	"titleProperty"
 ];
+/**
+* Every key that belongs inside a *property's* `admin` block, as data.
+*
+* The union of `AdminPropertyOptions` and its per-type extensions
+* (`AdminStringOptions`, `AdminArrayOptions`, …) in `@rebasepro/admin-types`.
+* It lives here for the same reason {@link ADMIN_COLLECTION_KEYS} does: the
+* runtime consumers are core packages that the BaaS guard forbids from
+* importing `@rebasepro/admin-types`. Here it is the boot-time collection
+* validator in `@rebasepro/server`, which has to tell "you left `readOnly` at
+* the top of the property, where nothing reads it" apart from "you invented a
+* key we have never heard of".
+*
+* `@rebasepro/admin-types` re-exports this and asserts it names only real
+* option keys.
+*
+* @group Models
+*/
+var ADMIN_PROPERTY_KEYS = [
+	"canAddElements",
+	"clearable",
+	"columnWidth",
+	"customProps",
+	"disabled",
+	"expanded",
+	"Field",
+	"Filter",
+	"filterOperators",
+	"fixedFilter",
+	"hideFromCollection",
+	"includeEntityLink",
+	"includeId",
+	"markdown",
+	"minimalistView",
+	"multiline",
+	"Preview",
+	"previewAsTag",
+	"previewProperties",
+	"readOnly",
+	"sortable",
+	"spreadChildren",
+	"urlPreview",
+	"widget",
+	"widthPercentage"
+];
+//#endregion
+//#region ../types/src/types/data_source.ts
+/**
+* The default data-source key, used when a collection does not name a
+* `dataSource`. Shared by the frontend router and the backend driver
+* registry so both agree on "the default database".
+* @group Models
+*/
+var DEFAULT_DATA_SOURCE_KEY = "(default)";
+/**
+* Relation kinds assumed filterable when a driver does not say.
+*
+* `belongsTo` alone: its filter is a comparison on a column of the row being
+* filtered, the one shape that needs no query construction a driver might not
+* have. Everything else is a correlated subquery over another table.
+*
+* @group Models
+*/
+var DEFAULT_FILTERABLE_RELATION_KINDS = ["belongsTo"];
+/** @group Models */
+var POSTGRES_CAPABILITIES = {
+	key: "postgres",
+	label: "PostgreSQL",
+	supportsRelations: true,
+	supportsSubcollections: false,
+	supportsRLS: true,
+	supportsReferences: false,
+	supportsColumnTypes: true,
+	supportsRealtime: true,
+	supportsVectors: true,
+	filterOperators: ALL_WHERE_FILTER_OPS,
+	filterableRelationKinds: [
+		"belongsTo",
+		"manyToMany",
+		"hasMany",
+		"hasOne"
+	],
+	supportsSQLAdmin: true,
+	supportsDocumentAdmin: false,
+	supportsSchemaAdmin: true
+};
+/** @group Models */
+var FIREBASE_CAPABILITIES = {
+	key: "firestore",
+	label: "Firebase / Firestore",
+	supportsRelations: false,
+	supportsSubcollections: true,
+	supportsRLS: false,
+	supportsReferences: true,
+	supportsColumnTypes: false,
+	supportsRealtime: true,
+	supportsVectors: false,
+	filterOperators: ALL_WHERE_FILTER_OPS.filter((op) => op !== "like" && op !== "ilike" && op !== "not-like" && op !== "not-ilike"),
+	filterableRelationKinds: [],
+	supportsSQLAdmin: false,
+	supportsDocumentAdmin: false,
+	supportsSchemaAdmin: false
+};
+/** @group Models */
+var MONGODB_CAPABILITIES = {
+	key: "mongodb",
+	label: "MongoDB",
+	supportsRelations: false,
+	supportsSubcollections: true,
+	supportsRLS: false,
+	supportsReferences: true,
+	supportsColumnTypes: false,
+	supportsRealtime: false,
+	supportsVectors: false,
+	filterOperators: ALL_WHERE_FILTER_OPS,
+	filterableRelationKinds: [],
+	supportsSQLAdmin: false,
+	supportsDocumentAdmin: true,
+	supportsSchemaAdmin: true
+};
+/**
+* Fallback capabilities when the driver is unknown.
+* Enables everything so nothing is hidden unexpectedly.
+* @group Models
+*/
+var DEFAULT_CAPABILITIES = {
+	key: "(default)",
+	label: "Default",
+	supportsRelations: true,
+	supportsSubcollections: true,
+	supportsRLS: true,
+	supportsReferences: true,
+	supportsColumnTypes: true,
+	supportsRealtime: true,
+	supportsVectors: true,
+	filterOperators: ALL_WHERE_FILTER_OPS,
+	filterableRelationKinds: DEFAULT_FILTERABLE_RELATION_KINDS,
+	supportsSQLAdmin: true,
+	supportsDocumentAdmin: true,
+	supportsSchemaAdmin: true
+};
+var CAPABILITIES_REGISTRY = {
+	postgres: POSTGRES_CAPABILITIES,
+	firestore: FIREBASE_CAPABILITIES,
+	mongodb: MONGODB_CAPABILITIES,
+	"(default)": DEFAULT_CAPABILITIES
+};
+/**
+* Look up capabilities for a given engine key.
+* If `engine` is undefined or not found, returns `DEFAULT_CAPABILITIES`.
+* @group Models
+*/
+function getDataSourceCapabilities(engine) {
+	if (!engine) return POSTGRES_CAPABILITIES;
+	return CAPABILITIES_REGISTRY[engine] ?? DEFAULT_CAPABILITIES;
+}
 //#endregion
 //#region ../types/src/types/collections.ts
 /**
@@ -357,6 +512,29 @@ function isPostgresCollectionConfig(collection) {
 	return !collection.engine || collection.engine === "postgres";
 }
 /**
+* Narrows to the SQL collection fields — `table`, `relations`,
+* `disableDefaultPolicies` — by asking the engine's declared capabilities
+* rather than by naming Postgres.
+*
+* The two halves of this already existed and were never joined. The engine
+* split (`PostgresCollectionConfig` / `FirebaseCollectionConfig` /
+* `MongoDBCollectionConfig`) said which fields belong to which engine at the
+* type level; {@link DataSourceCapabilities} said the same thing at runtime,
+* down to a `supportsRelations` flag. So call sites guarded on the capability
+* and then read a field the base type had to declare for them — which is why
+* those fields were on the base, and why a MongoDB collection could be written
+* with a `table`.
+*
+* Prefer this over {@link isPostgresCollectionConfig} wherever the question is
+* "does this collection live in a SQL table", so a custom SQL engine
+* registered through `registerDataSourceCapabilities` is included.
+*
+* @group Models
+*/
+function isRelationalCollectionConfig(collection) {
+	return getDataSourceCapabilities(collection.engine).supportsRelations;
+}
+/**
 * Type guard for Firebase / Firestore collections.
 * @group Models
 */
@@ -467,94 +645,6 @@ function isSQLAdmin(admin) {
 	return !!admin && typeof admin.executeSql === "function";
 }
 //#endregion
-//#region ../types/src/types/data_source.ts
-/**
-* The default data-source key, used when a collection does not name a
-* `dataSource`. Shared by the frontend router and the backend driver
-* registry so both agree on "the default database".
-* @group Models
-*/
-var DEFAULT_DATA_SOURCE_KEY = "(default)";
-/** @group Models */
-var POSTGRES_CAPABILITIES = {
-	key: "postgres",
-	label: "PostgreSQL",
-	supportsRelations: true,
-	supportsSubcollections: false,
-	supportsRLS: true,
-	supportsReferences: false,
-	supportsColumnTypes: true,
-	supportsRealtime: true,
-	filterOperators: ALL_WHERE_FILTER_OPS,
-	supportsSQLAdmin: true,
-	supportsDocumentAdmin: false,
-	supportsSchemaAdmin: true
-};
-/** @group Models */
-var FIREBASE_CAPABILITIES = {
-	key: "firestore",
-	label: "Firebase / Firestore",
-	supportsRelations: false,
-	supportsSubcollections: true,
-	supportsRLS: false,
-	supportsReferences: true,
-	supportsColumnTypes: false,
-	supportsRealtime: true,
-	filterOperators: ALL_WHERE_FILTER_OPS.filter((op) => op !== "like" && op !== "ilike" && op !== "not-like" && op !== "not-ilike"),
-	supportsSQLAdmin: false,
-	supportsDocumentAdmin: false,
-	supportsSchemaAdmin: false
-};
-/** @group Models */
-var MONGODB_CAPABILITIES = {
-	key: "mongodb",
-	label: "MongoDB",
-	supportsRelations: false,
-	supportsSubcollections: true,
-	supportsRLS: false,
-	supportsReferences: true,
-	supportsColumnTypes: false,
-	supportsRealtime: false,
-	filterOperators: ALL_WHERE_FILTER_OPS,
-	supportsSQLAdmin: false,
-	supportsDocumentAdmin: true,
-	supportsSchemaAdmin: true
-};
-/**
-* Fallback capabilities when the driver is unknown.
-* Enables everything so nothing is hidden unexpectedly.
-* @group Models
-*/
-var DEFAULT_CAPABILITIES = {
-	key: "(default)",
-	label: "Default",
-	supportsRelations: true,
-	supportsSubcollections: true,
-	supportsRLS: true,
-	supportsReferences: true,
-	supportsColumnTypes: true,
-	supportsRealtime: true,
-	filterOperators: ALL_WHERE_FILTER_OPS,
-	supportsSQLAdmin: true,
-	supportsDocumentAdmin: true,
-	supportsSchemaAdmin: true
-};
-var CAPABILITIES_REGISTRY = {
-	postgres: POSTGRES_CAPABILITIES,
-	firestore: FIREBASE_CAPABILITIES,
-	mongodb: MONGODB_CAPABILITIES,
-	"(default)": DEFAULT_CAPABILITIES
-};
-/**
-* Look up capabilities for a given engine key.
-* If `engine` is undefined or not found, returns `DEFAULT_CAPABILITIES`.
-* @group Models
-*/
-function getDataSourceCapabilities(engine) {
-	if (!engine) return POSTGRES_CAPABILITIES;
-	return CAPABILITIES_REGISTRY[engine] ?? DEFAULT_CAPABILITIES;
-}
-//#endregion
 //#region ../types/src/types/storage_source.ts
 /**
 * Describes a named storage backend — a place files live.
@@ -575,6 +665,98 @@ function getDataSourceCapabilities(engine) {
 * @group Models
 */
 var DEFAULT_STORAGE_SOURCE_KEY = "(default)";
+/**
+* The environment-variable suffix for a storage or data source key.
+*
+* `""` for the default source — so a single-bucket project keeps configuring
+* plain `S3_BUCKET` — and `__<KEY>` for every named one, uppercased with
+* non-alphanumerics collapsed to underscores: `media-cdn` → `S3_BUCKET__MEDIA_CDN`.
+*
+* The rule derives the variable name from the declared key rather than
+* discovering keys by scanning the environment. Scanning would have to guess how
+* `S3_BUCKET__MEDIA_CDN` splits into a key; deriving cannot be ambiguous, and a
+* typo surfaces as a missing source at boot instead of a silently ignored
+* variable.
+*
+* It lives in this package, with no dependencies, because four things must agree
+* on it exactly: the CLI (validating a build), the runtime (reading its own
+* environment), the control plane (writing a tenant's Secret), and the docs. A
+* second implementation of a naming convention is a second chance to disagree.
+*
+* @group Models
+*/
+function storageEnvSuffix(key, defaultKey = DEFAULT_STORAGE_SOURCE_KEY) {
+	if (!key || key === defaultKey) return "";
+	const normalized = key.replace(/[^A-Za-z0-9]+/g, "_").replace(/^_+|_+$/g, "").toUpperCase();
+	if (!normalized) throw new Error(`Source key "${key}" cannot be turned into an environment variable name. Use a key containing at least one letter or digit.`);
+	return `__${normalized}`;
+}
+/**
+* Two distinct keys that collapse onto the same variable name, or `null`.
+*
+* `media-cdn` and `media_cdn` are different source keys but the same suffix, so
+* without this one of them silently reads the other's configuration. Returns the
+* offending pair rather than throwing, so each caller can raise it in its own
+* idiom — a `BundleError` at boot, a build failure in the CLI, a rejected deploy
+* in a control plane.
+*
+* @group Models
+*/
+function findStorageSuffixCollision(keys, defaultKey = DEFAULT_STORAGE_SOURCE_KEY) {
+	const seen = /* @__PURE__ */ new Map();
+	for (const key of keys) {
+		const suffix = storageEnvSuffix(key, defaultKey);
+		const existing = seen.get(suffix);
+		if (existing !== void 0 && existing !== key) return {
+			a: existing,
+			b: key,
+			suffix
+		};
+		seen.set(suffix, key);
+	}
+	return null;
+}
+/**
+* Merge the two places a project may declare storage sources into one list.
+*
+* `rebase.json` is authoritative for every field it states. Config code may add
+* sources it does not mention and fill in fields it left out, but may not
+* contradict it: the manifest is what a host reads to decide which buckets need
+* configuring, and a runtime that quietly disagreed with it would put the
+* console back to describing a topology the tenant does not have — the exact
+* failure this whole mechanism exists to end.
+*
+* Note what is *not* here: no default source is invented when both inputs are
+* empty. That decision belongs to the resolver, which knows whether declaring
+* nothing means "one plain bucket" (it does) or "no storage at all".
+*
+* @group Models
+*/
+function normalizeStorageSources(declared, exported) {
+	const merged = /* @__PURE__ */ new Map();
+	const declaredEntries = Array.isArray(declared) ? declared.filter((d) => d?.key).map((d) => [d.key, d]) : Object.entries(declared ?? {});
+	for (const [key, config] of declaredEntries) merged.set(key, {
+		key,
+		engine: config.engine,
+		transport: config.transport ?? "server",
+		...config.label !== void 0 ? { label: config.label } : {}
+	});
+	for (const definition of exported ?? []) {
+		if (!definition?.key) continue;
+		const existing = merged.get(definition.key);
+		if (!existing) {
+			merged.set(definition.key, {
+				key: definition.key,
+				engine: definition.engine,
+				transport: definition.transport ?? "server",
+				...definition.label !== void 0 ? { label: definition.label } : {}
+			});
+			continue;
+		}
+		if (existing.label === void 0 && definition.label !== void 0) existing.label = definition.label;
+	}
+	return Array.from(merged.values());
+}
 //#endregion
 //#region ../types/src/types/project_manifest.ts
 /** Header carrying the schema version an SDK was generated from. */
@@ -770,6 +952,6 @@ function computeSchemaVersion(collections) {
 	return `v1:${hex(h1)}${hex(h2)}`;
 }
 //#endregion
-export { RebaseClientError as C, RebaseApiError as S, toCanonicalOp as _, DEFAULT_DATA_SOURCE_KEY as a, GeoPoint as b, policy as c, getDeclaredSubcollections as d, isPostgresCollectionConfig as f, REST_TO_CANONICAL as g, NULL_OPS as h, DEFAULT_STORAGE_SOURCE_KEY as i, isToMany as l, CANONICAL_TO_REST as m, serializeCollections as n, getDataSourceCapabilities as o, ADMIN_COLLECTION_KEYS as p, SCHEMA_VERSION_HEADER as r, isSQLAdmin as s, computeSchemaVersion as t, getCollectionDataPath as u, EntityReference as v, Vector as x, EntityRelation as y };
+export { EntityReference as C, RebaseApiError as D, Vector as E, RebaseClientError as O, toCanonicalOp as S, GeoPoint as T, ADMIN_COLLECTION_KEYS as _, findStorageSuffixCollision as a, NULL_OPS as b, isSQLAdmin as c, getCollectionDataPath as d, getDeclaredSubcollections as f, getDataSourceCapabilities as g, DEFAULT_DATA_SOURCE_KEY as h, DEFAULT_STORAGE_SOURCE_KEY as i, policy as l, isRelationalCollectionConfig as m, serializeCollections as n, normalizeStorageSources as o, isPostgresCollectionConfig as p, SCHEMA_VERSION_HEADER as r, storageEnvSuffix as s, computeSchemaVersion as t, isToMany as u, ADMIN_PROPERTY_KEYS as v, EntityRelation as w, REST_TO_CANONICAL as x, CANONICAL_TO_REST as y };
 
-//# sourceMappingURL=src-BYbxB4PR.js.map
+//# sourceMappingURL=src-Ivjud8jD.js.map