@protobase/schema 0.15.1 → 0.15.2

package/dist/fields/file.js

@@ -1,6 +1,9 @@
 import { z } from "zod";
 //#region src/fields/file.ts
-/** A file column holds `{provider}:{path}?name=…&size=…` as text; writes send a ticket from `:upload` instead. */
+/**
+* A file column holds `{provider}:{path}?name=…&size=…` as text, or an https URL with `.externalUrls()`; writes send a
+* ticket from `:upload` instead.
+*/
 const file = {
 	type: "file",
 	constraints: [],

package/dist/file-field.d.ts

@@ -27,6 +27,12 @@ export declare class FileField<V> extends Field<V> {
    * format: 'webp' } }`. `{ original }` stores that image instead of the upload. Other files get none.
    */
   variants(variants: Record<string, ImageVariant>, options?: ImageVariantOptions): FileField<V>;
+  /**
+   * Also takes an https URL of a file elsewhere, such as `https://images.example.com/photos/42.jpg`, stored as it is:
+   * never uploaded, without variants, and drawn from that address. See
+   * [External URLs](website/src/content/docs/reference/files.mdx#external-urls).
+   */
+  externalUrls(): FileField<V>;
   /** The column is nullable: the field may hold no file. */
   optional(): FileField<V | null>;
   /** Never written through the API. */

package/dist/file-field.js

@@ -49,6 +49,14 @@ var FileField = class FileField extends Field {
 			...options.original && { original: checkedVariant("The original", options.original) }
 		});
 	}
+	/**
+	* Also takes an https URL of a file elsewhere, such as `https://images.example.com/photos/42.jpg`, stored as it is:
+	* never uploaded, without variants, and drawn from that address. See
+	* [External URLs](website/src/content/docs/reference/files.mdx#external-urls).
+	*/
+	externalUrls() {
+		return this.withFile({ external: true });
+	}
 	/** The column is nullable: the field may hold no file. */
 	optional() {
 		return this.with({ nullable: true });

package/dist/files/file-options.d.ts

@@ -64,6 +64,8 @@ export type FileOptions = {
   variants?: Record<string, ImageVariant>;
   /** The image stored instead of the upload (`.variants()`' `original`). */
   original?: ImageVariant;
+  /** Whether a value may also be an https URL of a file elsewhere (`.externalUrls()`). */
+  external?: true;
 };
 /** Bytes from a number or text such as `10 MB` (decimal units) or `5 MiB` (binary units). */
 export declare const parseSize: (size: number | string) => number;

package/dist/model.d.ts

@@ -61,6 +61,8 @@ export type FileFieldModel = {
   variants?: Record<string, ImageVariant>;
   /** What is stored instead of an uploaded image, when the upload is not kept. */
   original?: ImageVariant;
+  /** Whether a value may also be an https URL of a file elsewhere, drawn and linked as it is (`.externalUrls()`). */
+  external?: true;
 };
 /** `digitsEnd`: only the end of the value's digits, spaces, `+` and dashes ignored (phone numbers). */
 export type SearchMatch = 'digitsEnd';

package/dist/resource-model.js

@@ -38,7 +38,8 @@ const fieldModel = (name, field) => {
 			...writtenFields(meta.file).length > 0 && { derive: writtenFields(meta.file) },
 			...meta.file.placeholder !== void 0 && { placeholder: meta.file.placeholder },
 			...meta.file.variants && Object.keys(meta.file.variants).length > 0 && { variants: structuredClone(meta.file.variants) },
-			...meta.file.original && { original: { ...meta.file.original } }
+			...meta.file.original && { original: { ...meta.file.original } },
+			...meta.file.external && { external: true }
 		} }
 	};
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/schema",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "Resource, field, view and access definitions for Protobase configs.",
   "license": "Apache-2.0",
   "repository": {