better-supabase 0.14.0 → 0.15.1

package/dist/resolved-names-Dr7brlLL.js

@@ -1,133 +0,0 @@
-import { a as entityNoun, i as entityNames, n as checkEntityName, s as tenantRename, t as DEFAULT_TENANT } from "./entity-naming-DLDhHTbK.js";
-import { A as tenantNameOf } from "./app-tables-C5aoI5rZ.js";
-//#region src/config/defaults.ts
-/**
-* Every default `resolveConfig` fills in. Other modules (the SQL module
-* registry, the CLI) read their fallbacks from here instead of repeating the
-* literals.
-*/
-const CONFIG_DEFAULTS = {
-	output: "src/lib/supabase/generated.ts",
-	schemas: ["public"],
-	casing: "snake",
-	postgrestVersion: "13",
-	codecs: {
-		timestamptz: "string",
-		int8: "number",
-		numeric: "number"
-	},
-	sql: {
-		dir: "supabase/schemas",
-		prefix: "900_better_supabase",
-		testsDir: "supabase/tests"
-	},
-	seed: {
-		entry: "supabase/seed.ts",
-		output: "supabase/seeds/000_better_supabase.sql",
-		perTenant: "supabase/seed.tenant.ts"
-	},
-	openapi: {
-		entry: "src/lib/openapi.ts",
-		output: "openapi.json"
-	},
-	specs: { failOn: "error" },
-	doctor: {
-		format: "text",
-		sources: ["src/**/*.{ts,tsx}"],
-		policyHelperLimit: 5
-	},
-	gen: { watchInterval: 2e3 },
-	env: { output: ".env.local" }
-};
-//#endregion
-//#region src/config/json.ts
-/**
-* The JSON Schema document for a `json[...].schema` entry. A Standard Schema
-* converts for `target` (2020-12 by default); a JSON Schema object is returned
-* as it is.
-*/
-function resolveJsonSchema(source, target = "draft-2020-12") {
-	const standard = source["~standard"];
-	if (standard === void 0) return source;
-	const jsonSchema = standard.jsonSchema;
-	if (typeof jsonSchema?.input !== "function") throw new TypeError("json[...].schema: this Standard Schema library does not implement Standard JSON Schema; pass a JSON Schema object instead");
-	return jsonSchema.input({ target });
-}
-//#endregion
-//#region src/sql/resolved-names.ts
-const PLACEHOLDER = /\{([^{}]*)\}/g;
-function primaryOf(where, entities) {
-	const primary = Object.entries(entities).find(([, spec]) => spec.primary);
-	if (primary === void 0) throw new TypeError(`${where}: the block has no primary entity, so name one: ${Object.keys(entities).join(", ") || "none"}`);
-	return primary[0];
-}
-/** `blocks.<name>.entities` as entity key to its config, shorthand expanded. */
-function configured(where, entities, config) {
-	if (config === void 0) return /* @__PURE__ */ new Map();
-	if (typeof config === "string") return /* @__PURE__ */ new Map([[primaryOf(where, entities), { name: config }]]);
-	const found = /* @__PURE__ */ new Map();
-	for (const [key, value] of Object.entries(config)) {
-		if (value === void 0) continue;
-		if (!(key in entities)) throw new TypeError(`${where}: unknown entity "${key}". Entities: ${Object.keys(entities).join(", ") || "none"}`);
-		found.set(key, typeof value === "string" ? { name: value } : value);
-	}
-	return found;
-}
-function checkUrl(where, url, columns) {
-	for (const [, column] of url.matchAll(PLACEHOLDER)) if (columns === void 0 || column === void 0 || !(column in columns)) throw new TypeError(`${where}: "{${column ?? ""}}" is not a column of the entity's table. Columns: ${Object.keys(columns ?? {}).join(", ") || "none"}`);
-	return url;
-}
-/** The noun forms a rename matches, for the containment check. */
-const nounForms = (noun) => [noun.singular, noun.plural];
-function checkNoun(where, noun, others) {
-	for (const other of others) {
-		const taken = nounForms(other).find((form) => new RegExp(`(^|_)${form}(_|$)`).test(noun.singular));
-		if (taken !== void 0) throw new TypeError(`${where}: "${noun.singular}" contains "${taken}", another name the blocks rename. Choose another name.`);
-	}
-}
-function resolveEntity(where, key, spec, names, config) {
-	const from = entityNoun(spec.singular, spec.plural);
-	const to = config?.name === void 0 && config?.plural === void 0 ? from : entityNoun(config.name === void 0 ? spec.singular : checkEntityName(`${where}.${key}`, config.name), config.plural === void 0 ? void 0 : checkEntityName(`${where}.${key}.plural`, config.plural));
-	const columns = spec.table === void 0 ? void 0 : names.tables[spec.table]?.columns;
-	return {
-		key,
-		from,
-		to,
-		primary: spec.primary === true,
-		global: spec.global === true,
-		...spec.table === void 0 ? {} : { table: spec.table },
-		...config?.url === void 0 ? {} : { url: checkUrl(`${where}.${key}.url`, config.url, columns) },
-		...spec.subject === void 0 || config?.subject === false ? {} : { subject: spec.subject }
-	};
-}
-/**
-* The final names of `module` under `blocks`: its entities renamed through
-* `blocks.<module>.entities`, and the tenant through
-* `blocks.tenant.entities.organization`. Throws on an unknown entity, a name
-* that isn't a lowercase identifier, a `url` placeholder that isn't a column,
-* or a name that contains another noun the blocks rename.
-*/
-function resolveNames(module, names, blocks = {}) {
-	const where = `blocks.${module}.entities`;
-	const specs = names.entities ?? {};
-	const config = configured(where, specs, blocks[module]?.entities);
-	const tenantName = tenantNameOf(blocks);
-	const tenant = tenantName === void 0 ? DEFAULT_TENANT : tenantRename(tenantName).to;
-	const entities = Object.fromEntries(Object.entries(specs).map(([key, spec]) => [key, resolveEntity(where, key, spec, names, config.get(key))]));
-	const own = Object.values(entities).filter((entity) => !entity.global);
-	const defaults = [DEFAULT_TENANT, ...own.map((entity) => entity.from)];
-	for (const entity of own) if (entity.to.singular !== entity.from.singular) checkNoun(`${where}.${entity.key}`, entity.to, defaults.filter((noun) => noun !== entity.from));
-	const renames = own.map((entity) => ({
-		from: entity.from,
-		to: entity.to
-	}));
-	return {
-		module,
-		entities,
-		tenant,
-		naming: entityNames([...tenantName === void 0 ? [] : [tenantRename(tenantName)], ...renames]),
-		entityNaming: entityNames(renames)
-	};
-}
-//#endregion
-export { resolveJsonSchema as n, CONFIG_DEFAULTS as r, resolveNames as t };

package/dist/resource-BRRU-A7j.js

@@ -1,91 +0,0 @@
-//#region src/spec/resource.ts
-const ACTION_NAME = /^[A-Za-z][A-Za-z0-9_]*$/u;
-const RESERVED = /* @__PURE__ */ new Set([
-	"list",
-	"get",
-	"create",
-	"update",
-	"delete"
-]);
-function planAction(table, name, action, keyParam) {
-	if (!ACTION_NAME.test(name) || RESERVED.has(name)) throw new TypeError(`${table}.actions.${name}: use a name of letters, digits and "_" that is not an operation`);
-	if (!action.path.startsWith("/") || action.path === "/") throw new TypeError(`${table}.actions.${name}: the path must start with "/" and name a segment, e.g. "/{id}/send"`);
-	const segments = action.path.slice(1).split("/");
-	const params = [];
-	for (const segment of segments) {
-		const match = /^\{(\w+)\}$/u.exec(segment);
-		if (match) params.push(match[1]);
-		else if (segment === "" || /[{}]/u.test(segment)) throw new TypeError(`${table}.actions.${name}: "${action.path}" has an invalid segment`);
-	}
-	if (params.some((param) => param !== keyParam)) throw new TypeError(`${table}.actions.${name}: the only path parameter is the key ${keyParam ? `"{${keyParam}}"` : "(this table has none)"}`);
-	return {
-		...action,
-		name,
-		params,
-		segments
-	};
-}
-/**
-* Resolves what a resource serves: the operations, the key, paging, actions and
-* permissions. Shared by `defineResource` and the API model.
-*/
-function planResource(schema, table, description = {}, authorizer) {
-	const meta = schema.tables[table];
-	if (!meta) throw new TypeError(`Unknown table "${table}"`);
-	const operations = description.operations ?? (meta.kind === "view" ? ["list", "get"] : [
-		"list",
-		"get",
-		"create",
-		"update",
-		"delete"
-	]);
-	const keyParam = meta.primaryKey.length === 1 ? meta.primaryKey[0] : void 0;
-	const pagination = description.list ? description.list.pagination ?? "cursor" : description.pagination ?? (meta.primaryKey.length > 0 ? "cursor" : "offset");
-	const actions = Object.entries(description.actions ?? {}).map(([name, action]) => planAction(table, name, action, keyParam));
-	const permissions = {};
-	if (description.permissions === true) {
-		if (!authorizer?.forOperation) throw new TypeError(`${table}: permissions: true needs an authorizer with forOperation()`);
-		for (const operation of operations) {
-			const ref = authorizer.forOperation(table, operation);
-			if (ref !== void 0) permissions[operation] = ref;
-		}
-	} else if (description.permissions) {
-		for (const [operation, ref] of Object.entries(description.permissions)) if (ref !== void 0) permissions[operation] = ref;
-	}
-	for (const action of actions) if (action.permission !== void 0) permissions[action.name] = action.permission;
-	return {
-		table,
-		meta,
-		operations,
-		keyParam,
-		pagination,
-		maxPageSize: description.maxPageSize ?? 200,
-		description,
-		actions,
-		permissions
-	};
-}
-/** The action whose method and segments match, with its params. */
-function matchAction(plan, method, segments) {
-	let wrongMethod = false;
-	for (const action of plan.actions) {
-		if (action.segments.length !== segments.length) continue;
-		const params = {};
-		if (!action.segments.every((segment, index) => {
-			const value = segments[index];
-			if (segment.startsWith("{")) {
-				params[segment.slice(1, -1)] = value;
-				return value !== "";
-			}
-			return segment === value;
-		})) continue;
-		if (action.method === method) return {
-			action,
-			params
-		};
-		wrongMethod = true;
-	}
-	return wrongMethod ? "method" : void 0;
-}
-//#endregion
-export { planResource as n, matchAction as t };

package/dist/resource-DYDEnww-.d.ts

@@ -1,115 +0,0 @@
-import { ht as TableMeta } from "./executor-CPyrQdjh.js";
-import { D as ResourceOperation, O as SecurityRequirement, i as JsonObject } from "./model-Btl8X9cs.js";
-//#region src/spec/schemas.d.ts
-/** A Standard Schema, or anything else that might carry `~standard`. */
-interface StandardLike {
-  readonly "~standard": object;
-}
-//#endregion
-//#region src/spec/resource.d.ts
-type ResourcePagination = "offset" | "cursor";
-type ActionMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-/** A custom endpoint on a resource, documented next to its CRUD operations. */
-interface ResourceActionSpec<Ref = string> {
-  readonly method: ActionMethod;
-  /**
-   * Relative to the collection: `/{id}/send` acts on one row (the key parameter
-   * is the table's primary key), `/export` on the table.
-   */
-  readonly path: string;
-  /** The JSON body. */
-  readonly input?: StandardLike;
-  /** The query parameters, as an object schema. */
-  readonly query?: StandardLike;
-  /** The JSON response. Without it the action answers 204. */
-  readonly output?: StandardLike;
-  /** Success status. Defaults to 200 with an output, 204 without. */
-  readonly status?: number;
-  readonly summary?: string;
-  readonly description?: string;
-  readonly deprecated?: boolean;
-  readonly permission?: Ref;
-  /** Names of the events the action emits, for AsyncAPI. */
-  readonly emits?: readonly string[];
-}
-/** One shared error response: its component name, status and description. */
-interface ErrorResponse {
-  readonly name: string;
-  readonly status: number;
-  readonly description: string;
-}
-/**
- * What a resource serves and documents. `defineResource` and `defineApi` read
- * the same object, so the routes and the spec cannot drift.
- */
-interface ResourceDescription<Ref = string> {
-  /** Defaults to every operation for tables, `list` and `get` for views. */
-  readonly operations?: readonly ResourceOperation[];
-  /** Filters, search and sorts for `list`, from `defineListQuery`. */
-  readonly list?: {
-    readonly openapi: readonly unknown[];
-    readonly pagination?: ResourcePagination;
-  };
-  /**
-   * Paging of the default list. Defaults to `cursor`, or `offset` for a table
-   * or view without a primary key; `offset` adds `page` and the total.
-   */
-  readonly pagination?: ResourcePagination;
-  /** Largest page of the default list. Defaults to 200. */
-  readonly maxPageSize?: number;
-  /** Path of the collection in the spec. Defaults to `/<table>`. */
-  readonly path?: string;
-  readonly tag?: string;
-  readonly description?: string;
-  /**
-   * Validates request bodies; their JSON Schema replaces the table's in the
-   * spec.
-   */
-  readonly input?: {
-    readonly create?: StandardLike;
-    readonly update?: StandardLike;
-  };
-  /** The response shape of an operation whose hooks change it. */
-  readonly output?: Partial<Readonly<Record<ResourceOperation, StandardLike>>>;
-  readonly actions?: Readonly<Record<string, ResourceActionSpec<Ref>>>;
-  /**
-   * The permission of each operation. `true` asks the authorizer
-   * (`forOperation`) for every enabled operation.
-   */
-  readonly permissions?: true | Partial<Readonly<Record<ResourceOperation, Ref>>>;
-  /** Overrides the model's security for this resource; `[]` makes it public. */
-  readonly security?: readonly SecurityRequirement[];
-  /** The shared error responses. Defaults to the API's `errors`. */
-  readonly errors?: readonly ErrorResponse[];
-  /**
-   * Deep-merged into the lowered operation, by operation or action name (`*`
-   * for all).
-   */
-  readonly extend?: Readonly<Record<string, JsonObject>>;
-}
-interface PlannedAction<Ref = string> extends ResourceActionSpec<Ref> {
-  readonly name: string;
-  /** The `{name}` segments of `path`. */
-  readonly params: readonly string[];
-  /** The path split into segments; `{name}` segments are params. */
-  readonly segments: readonly string[];
-}
-/** A resolved `ResourceDescription`. */
-interface ResourcePlan<Ref = string> {
-  readonly table: string;
-  readonly meta: TableMeta;
-  readonly operations: readonly ResourceOperation[];
-  /**
-   * Name of the key parameter, or `undefined` for tables without a
-   * single-column key.
-   */
-  readonly keyParam: string | undefined;
-  readonly pagination: ResourcePagination;
-  readonly maxPageSize: number;
-  readonly description: ResourceDescription<Ref>;
-  readonly actions: readonly PlannedAction<Ref>[];
-  /** The permission reference of each operation and action that has one. */
-  readonly permissions: Readonly<Record<string, Ref>>;
-}
-//#endregion
-export { ResourcePlan as a, ResourcePagination as i, ResourceActionSpec as n, StandardLike as o, ResourceDescription as r, ErrorResponse as t };