astro 4.9.2 → 4.10.0

package/dist/env/schema.d.ts

@@ -0,0 +1,387 @@
+import { z } from 'zod';
+declare const EnvFieldType: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"string">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"boolean">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}>]>;
+export type EnvFieldType = z.infer<typeof EnvFieldType>;
+export declare const EnvSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodIntersection<z.ZodUnion<[z.ZodObject<{
+    context: z.ZodLiteral<"client">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "client";
+    access: "public";
+}, {
+    context: "client";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "public";
+}, {
+    context: "server";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"secret">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "secret";
+}, {
+    context: "server";
+    access: "secret";
+}>]>, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"string">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"boolean">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}>]>>>, Record<string, ({
+    context: "client";
+    access: "public";
+} | {
+    context: "server";
+    access: "public";
+} | {
+    context: "server";
+    access: "secret";
+}) & ({
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+} | {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+} | {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+})>, Record<string, ({
+    context: "client";
+    access: "public";
+} | {
+    context: "server";
+    access: "public";
+} | {
+    context: "server";
+    access: "secret";
+}) & ({
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+} | {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+} | {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+})>>;
+export type EnvSchema = z.infer<typeof EnvSchema>;
+declare const StringField: z.ZodIntersection<z.ZodUnion<[z.ZodObject<{
+    context: z.ZodLiteral<"client">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "client";
+    access: "public";
+}, {
+    context: "client";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "public";
+}, {
+    context: "server";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"secret">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "secret";
+}, {
+    context: "server";
+    access: "secret";
+}>]>, z.ZodObject<{
+    type: z.ZodLiteral<"string">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "string";
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}>>;
+export type StringField = z.infer<typeof StringField>;
+export declare const StringFieldInput: z.ZodIntersection<z.ZodUnion<[z.ZodObject<{
+    context: z.ZodLiteral<"client">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "client";
+    access: "public";
+}, {
+    context: "client";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "public";
+}, {
+    context: "server";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"secret">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "secret";
+}, {
+    context: "server";
+    access: "secret";
+}>]>, z.ZodObject<Omit<{
+    type: z.ZodLiteral<"string">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodString>;
+}, "type">, "strip", z.ZodTypeAny, {
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}, {
+    default?: string | undefined;
+    optional?: boolean | undefined;
+}>>;
+export type StringFieldInput = z.infer<typeof StringFieldInput>;
+declare const NumberField: z.ZodIntersection<z.ZodUnion<[z.ZodObject<{
+    context: z.ZodLiteral<"client">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "client";
+    access: "public";
+}, {
+    context: "client";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "public";
+}, {
+    context: "server";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"secret">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "secret";
+}, {
+    context: "server";
+    access: "secret";
+}>]>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "number";
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}>>;
+export type NumberField = z.infer<typeof NumberField>;
+export declare const NumberFieldInput: z.ZodIntersection<z.ZodUnion<[z.ZodObject<{
+    context: z.ZodLiteral<"client">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "client";
+    access: "public";
+}, {
+    context: "client";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "public";
+}, {
+    context: "server";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"secret">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "secret";
+}, {
+    context: "server";
+    access: "secret";
+}>]>, z.ZodObject<Omit<{
+    type: z.ZodLiteral<"number">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodNumber>;
+}, "type">, "strip", z.ZodTypeAny, {
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}, {
+    default?: number | undefined;
+    optional?: boolean | undefined;
+}>>;
+export type NumberFieldInput = z.infer<typeof NumberFieldInput>;
+declare const BooleanField: z.ZodIntersection<z.ZodUnion<[z.ZodObject<{
+    context: z.ZodLiteral<"client">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "client";
+    access: "public";
+}, {
+    context: "client";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "public";
+}, {
+    context: "server";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"secret">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "secret";
+}, {
+    context: "server";
+    access: "secret";
+}>]>, z.ZodObject<{
+    type: z.ZodLiteral<"boolean">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}, {
+    type: "boolean";
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}>>;
+export type BooleanField = z.infer<typeof BooleanField>;
+export declare const BooleanFieldInput: z.ZodIntersection<z.ZodUnion<[z.ZodObject<{
+    context: z.ZodLiteral<"client">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "client";
+    access: "public";
+}, {
+    context: "client";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"public">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "public";
+}, {
+    context: "server";
+    access: "public";
+}>, z.ZodObject<{
+    context: z.ZodLiteral<"server">;
+    access: z.ZodLiteral<"secret">;
+}, "strip", z.ZodTypeAny, {
+    context: "server";
+    access: "secret";
+}, {
+    context: "server";
+    access: "secret";
+}>]>, z.ZodObject<Omit<{
+    type: z.ZodLiteral<"boolean">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodBoolean>;
+}, "type">, "strip", z.ZodTypeAny, {
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}, {
+    default?: boolean | undefined;
+    optional?: boolean | undefined;
+}>>;
+export type BooleanFieldInput = z.infer<typeof BooleanFieldInput>;
+export {};

package/dist/env/schema.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { PUBLIC_PREFIX } from "./constants.js";
+const StringSchema = z.object({
+  type: z.literal("string"),
+  optional: z.boolean().optional(),
+  default: z.string().optional()
+});
+const NumberSchema = z.object({
+  type: z.literal("number"),
+  optional: z.boolean().optional(),
+  default: z.number().optional()
+});
+const BooleanSchema = z.object({
+  type: z.literal("boolean"),
+  optional: z.boolean().optional(),
+  default: z.boolean().optional()
+});
+const EnvFieldType = z.discriminatedUnion("type", [StringSchema, NumberSchema, BooleanSchema]);
+const PublicClientEnvFieldMetadata = z.object({
+  context: z.literal("client"),
+  access: z.literal("public")
+});
+const PublicServerEnvFieldMetadata = z.object({
+  context: z.literal("server"),
+  access: z.literal("public")
+});
+const SecretServerEnvFieldMetadata = z.object({
+  context: z.literal("server"),
+  access: z.literal("secret")
+});
+const KEY_REGEX = /^[A-Z_]+$/;
+const EnvSchema = z.record(
+  z.string().regex(KEY_REGEX, {
+    message: "A valid variable name can only contain uppercase letters and underscores."
+  }),
+  z.intersection(
+    z.union([
+      PublicClientEnvFieldMetadata,
+      PublicServerEnvFieldMetadata,
+      SecretServerEnvFieldMetadata
+    ]),
+    EnvFieldType
+  )
+).superRefine((schema, ctx) => {
+  for (const [key, value] of Object.entries(schema)) {
+    if (key.startsWith(PUBLIC_PREFIX) && value.access !== "public") {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: `An environment variable whose name is prefixed by "${PUBLIC_PREFIX}" must be public.`
+      });
+    }
+    if (value.access === "public" && !key.startsWith(PUBLIC_PREFIX)) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: `An environment variable that is public must have a name prefixed by "${PUBLIC_PREFIX}".`
+      });
+    }
+  }
+});
+const StringField = z.intersection(
+  z.union([
+    PublicClientEnvFieldMetadata,
+    PublicServerEnvFieldMetadata,
+    SecretServerEnvFieldMetadata
+  ]),
+  StringSchema
+);
+const StringFieldInput = z.intersection(
+  z.union([
+    PublicClientEnvFieldMetadata,
+    PublicServerEnvFieldMetadata,
+    SecretServerEnvFieldMetadata
+  ]),
+  StringSchema.omit({ type: true })
+);
+const NumberField = z.intersection(
+  z.union([
+    PublicClientEnvFieldMetadata,
+    PublicServerEnvFieldMetadata,
+    SecretServerEnvFieldMetadata
+  ]),
+  NumberSchema
+);
+const NumberFieldInput = z.intersection(
+  z.union([
+    PublicClientEnvFieldMetadata,
+    PublicServerEnvFieldMetadata,
+    SecretServerEnvFieldMetadata
+  ]),
+  NumberSchema.omit({ type: true })
+);
+const BooleanField = z.intersection(
+  z.union([
+    PublicClientEnvFieldMetadata,
+    PublicServerEnvFieldMetadata,
+    SecretServerEnvFieldMetadata
+  ]),
+  BooleanSchema
+);
+const BooleanFieldInput = z.intersection(
+  z.union([
+    PublicClientEnvFieldMetadata,
+    PublicServerEnvFieldMetadata,
+    SecretServerEnvFieldMetadata
+  ]),
+  BooleanSchema.omit({ type: true })
+);
+export {
+  BooleanFieldInput,
+  EnvSchema,
+  NumberFieldInput,
+  StringFieldInput
+};

package/dist/env/validators.d.ts

@@ -0,0 +1,13 @@
+import type { EnvFieldType } from './schema.js';
+export type ValidationResultValue = EnvFieldType['default'];
+type ValidationResult = {
+    ok: true;
+    type: string;
+    value: ValidationResultValue;
+} | {
+    ok: false;
+    type: string;
+};
+export declare function getEnvFieldType(options: EnvFieldType): string;
+export declare function validateEnvVariable(value: string | undefined, options: EnvFieldType): ValidationResult;
+export {};

package/dist/env/validators.js

@@ -0,0 +1,57 @@
+function getEnvFieldType(options) {
+  const optional = options.optional ? options.default !== void 0 ? false : true : false;
+  return `${options.type}${optional ? " | undefined" : ""}`;
+}
+const stringValidator = (input) => {
+  return {
+    valid: typeof input === "string",
+    parsed: input
+  };
+};
+const numberValidator = (input) => {
+  const num = parseFloat(input ?? "");
+  return {
+    valid: !isNaN(num),
+    parsed: num
+  };
+};
+const booleanValidator = (input) => {
+  const bool = input === "true" ? true : input === "false" ? false : void 0;
+  return {
+    valid: typeof bool === "boolean",
+    parsed: bool
+  };
+};
+function validateEnvVariable(value, options) {
+  const validator = {
+    string: stringValidator,
+    number: numberValidator,
+    boolean: booleanValidator
+  }[options.type];
+  const type = getEnvFieldType(options);
+  if (options.optional || options.default !== void 0) {
+    if (value === void 0) {
+      return {
+        ok: true,
+        value: options.default,
+        type
+      };
+    }
+  }
+  const { valid, parsed } = validator(value);
+  if (valid) {
+    return {
+      ok: true,
+      value: parsed,
+      type
+    };
+  }
+  return {
+    ok: false,
+    type
+  };
+}
+export {
+  getEnvFieldType,
+  validateEnvVariable
+};

package/dist/env/vite-plugin-env.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="node" resolution-mode="require"/>
+import type fsMod from 'node:fs';
+import { type Plugin } from 'vite';
+import type { AstroSettings } from '../@types/astro.js';
+interface AstroEnvVirtualModPluginParams {
+    settings: AstroSettings;
+    mode: 'dev' | 'build' | string;
+    fs: typeof fsMod;
+}
+export declare function astroEnv({ settings, mode, fs, }: AstroEnvVirtualModPluginParams): Plugin | undefined;
+export {};