@holo-js/forms 0.1.4 → 0.1.6

package/dist/schema.d.ts

@@ -0,0 +1,13 @@
+import { SchemaInputShape, ValidationSchema, InferSchemaData } from '@holo-js/validation';
+export { DEFAULT_VALIDATION_BAG, ErrorTree, ErrorTreeNode, FieldDefinition, FieldRule, InferSchemaData, SerializedValidationException, StandardSchemaV1, StandardSchemaV1Issue, StandardSchemaV1Props, StandardSchemaV1Result, ValidationErrorBag, ValidationException, ValidationExceptionOptions, ValidationFailure, ValidationResult, ValidationSchema, ValidationSuccess, WebFileLike, createErrorBag, defineSchema, field, isValidationException, parse, safeParse, validationInternals } from '@holo-js/validation';
+
+interface FormSchema<TShape extends SchemaInputShape = SchemaInputShape> extends ValidationSchema<TShape> {
+    readonly mode: 'form';
+    readonly fields: ValidationSchema<TShape>['fields'];
+    readonly $values?: Partial<InferSchemaData<TShape>>;
+}
+type InferFormData<TSchema extends FormSchema> = TSchema extends FormSchema<infer TShape> ? InferSchemaData<TShape> : never;
+declare function schema<TShape extends SchemaInputShape>(shapeOrSchema: TShape | ValidationSchema<TShape>): FormSchema<TShape>;
+declare function isFormSchema(value: unknown): value is FormSchema;
+
+export { type FormSchema, type InferFormData, isFormSchema, schema };

package/dist/schema.mjs

@@ -0,0 +1,26 @@
+import {
+  DEFAULT_VALIDATION_BAG,
+  ValidationException,
+  createErrorBag,
+  defineSchema,
+  field,
+  isFormSchema,
+  isValidationException,
+  parse,
+  safeParse,
+  schema,
+  validationInternals
+} from "./chunk-GPWXGHZE.mjs";
+export {
+  DEFAULT_VALIDATION_BAG,
+  ValidationException,
+  createErrorBag,
+  defineSchema,
+  field,
+  isFormSchema,
+  isValidationException,
+  parse,
+  safeParse,
+  schema,
+  validationInternals
+};

package/dist/security-ODATEIFI.mjs

@@ -0,0 +1,48 @@
+import {
+  createMissingSecurityPackageError,
+  isMissingOptionalPackageError,
+  isRootSecurityError,
+  parseCookieHeader
+} from "./chunk-GH4IN2OV.mjs";
+import "./chunk-OFPH5LBY.mjs";
+
+// src/security.ts
+var securityModulePromise;
+async function importSecurityModule() {
+  if (typeof process !== "undefined" && process.env && process.env.VITEST) {
+    return await import(
+      /* @vite-ignore */
+      "@holo-js/security"
+    );
+  }
+  return await import("@holo-js/security");
+}
+async function loadSecurityModule() {
+  const runtime = globalThis;
+  if (runtime.__holoFormsSecurityModule__) {
+    return runtime.__holoFormsSecurityModule__;
+  }
+  securityModulePromise ??= (runtime.__holoFormsSecurityImport__ ? runtime.__holoFormsSecurityImport__() : importSecurityModule()).then((module) => module).catch(async (error) => {
+    securityModulePromise = void 0;
+    if (isMissingOptionalPackageError(error)) {
+      throw createMissingSecurityPackageError();
+    }
+    throw error;
+  });
+  return await securityModulePromise;
+}
+function resetSecurityModuleCache() {
+  securityModulePromise = void 0;
+}
+var formsSecurityInternals = {
+  createMissingSecurityPackageError,
+  isMissingOptionalPackageError,
+  isRootSecurityError,
+  parseCookieHeader,
+  resetSecurityModuleCache
+};
+export {
+  formsSecurityInternals,
+  loadSecurityModule,
+  resetSecurityModuleCache
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/forms",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Holo-JS Framework - forms-first validation and submission contracts",
   "type": "module",
   "license": "MIT",
@@ -10,10 +10,15 @@
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
     },
-    "./client": {
-      "types": "./dist/client.d.ts",
-      "import": "./dist/client.mjs",
-      "default": "./dist/client.mjs"
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.mjs",
+      "default": "./dist/schema.mjs"
+    },
+    "./internal/client": {
+      "types": "./dist/internal/client.d.ts",
+      "import": "./dist/internal/client.mjs",
+      "default": "./dist/internal/client.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -28,10 +33,10 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/validation": "^0.1.4"
+    "@holo-js/validation": "^0.1.6"
   },
   "peerDependencies": {
-    "@holo-js/security": "^0.1.4"
+    "@holo-js/security": "^0.1.6"
   },
   "peerDependenciesMeta": {
     "@holo-js/security": {
@@ -42,6 +47,6 @@
     "@types/node": "^22.10.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.5"
   }
 }

package/dist/chunk-663LOLKH.mjs

@@ -1,421 +0,0 @@
-// src/contracts.ts
-import {
-  createErrorBag,
-  defineSchema,
-  isValidationSchema,
-  validate as validateInput
-} from "@holo-js/validation";
-
-// src/security.ts
-var securityModulePromise;
-function isMissingOptionalPackageError(error) {
-  if (!(error instanceof Error)) {
-    return false;
-  }
-  return [
-    /Cannot find package ['"]?@holo-js\/security['"]?/,
-    /Cannot find module ['"]?@holo-js\/security['"]?/,
-    /Failed to resolve module specifier ['"]?@holo-js\/security['"]?/,
-    /Failed to load url ['"]?@holo-js\/security['"]?/,
-    /Could not resolve ['"]?@holo-js\/security['"]?/
-  ].some((pattern) => pattern.test(error.message));
-}
-function createMissingSecurityPackageError() {
-  return new FormContractError(
-    "[@holo-js/forms] Security-aware form options require the optional @holo-js/security package to be installed."
-  );
-}
-async function importSecurityModule() {
-  const specifier = ["@holo-js", "security"].join("/");
-  if (typeof process !== "undefined" && process.env && process.env.VITEST) {
-    return await import(
-      /* @vite-ignore */
-      specifier
-    );
-  }
-  return await import(specifier);
-}
-async function loadSecurityModule() {
-  const runtime = globalThis;
-  if (runtime.__holoFormsSecurityModule__) {
-    return runtime.__holoFormsSecurityModule__;
-  }
-  securityModulePromise ??= (runtime.__holoFormsSecurityImport__ ? runtime.__holoFormsSecurityImport__() : importSecurityModule()).then((module) => module).catch(async (error) => {
-    securityModulePromise = void 0;
-    if (isMissingOptionalPackageError(error)) {
-      throw createMissingSecurityPackageError();
-    }
-    throw error;
-  });
-  return await securityModulePromise;
-}
-function resetSecurityModuleCache() {
-  securityModulePromise = void 0;
-}
-function parseCookieHeader(header) {
-  const decodeCookiePart = (value) => {
-    try {
-      return decodeURIComponent(value);
-    } catch {
-      return void 0;
-    }
-  };
-  return Object.freeze(Object.fromEntries(
-    header.split(";").map((segment) => segment.trim()).filter(Boolean).map((segment) => {
-      const separator = segment.indexOf("=");
-      if (separator <= 0) {
-        return void 0;
-      }
-      const key = decodeCookiePart(segment.slice(0, separator));
-      const value = decodeCookiePart(segment.slice(separator + 1));
-      if (!key || typeof value === "undefined") {
-        return void 0;
-      }
-      return [
-        key,
-        value
-      ];
-    }).filter((entry) => !!entry)
-  ));
-}
-function isRootSecurityError(error) {
-  const candidate = error;
-  return error instanceof Error && typeof candidate?.status === "number" && (candidate.status === 419 || candidate.status === 429);
-}
-var formsSecurityInternals = {
-  createMissingSecurityPackageError,
-  isMissingOptionalPackageError,
-  isRootSecurityError,
-  parseCookieHeader,
-  resetSecurityModuleCache
-};
-
-// src/contracts.ts
-var FormContractError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "FormContractError";
-  }
-};
-function schema(shapeOrSchema) {
-  const base = isValidationSchema(shapeOrSchema) ? shapeOrSchema : defineSchema(shapeOrSchema);
-  return Object.freeze({
-    ...base,
-    mode: "form"
-  });
-}
-function isFormSchema(value) {
-  return isValidationSchema(value) && value.mode === "form";
-}
-function normalizeStatus(value, fallback) {
-  if (typeof value === "undefined") {
-    return fallback;
-  }
-  if (!Number.isInteger(value) || value < 100) {
-    throw new FormContractError("HTTP status codes must be integers greater than or equal to 100.");
-  }
-  return value;
-}
-function serializeSubmissionState(valid, values, errors) {
-  return Object.freeze({
-    valid,
-    submitted: true,
-    values,
-    errors: errors.flatten()
-  });
-}
-function createSubmission(valid, values, errors, failureStatus = 422) {
-  const normalizedFailureStatus = normalizeStatus(failureStatus, 422);
-  const serialize = () => serializeSubmissionState(valid, values, errors);
-  const failure = () => ({
-    ok: false,
-    status: normalizedFailureStatus,
-    valid: false,
-    values,
-    errors: errors.flatten()
-  });
-  const success = (payload, status) => ({
-    ok: true,
-    status: normalizeStatus(status, 200),
-    data: payload
-  });
-  if (valid) {
-    const data = values;
-    return Object.freeze({
-      valid: true,
-      submitted: true,
-      data,
-      values: data,
-      errors,
-      serialize,
-      success,
-      fail(status) {
-        const payload = failure();
-        return {
-          ...payload,
-          status: normalizeStatus(status, payload.status)
-        };
-      }
-    });
-  }
-  return Object.freeze({
-    valid: false,
-    submitted: true,
-    data: void 0,
-    values,
-    errors,
-    serialize,
-    success,
-    fail(status) {
-      const payload = failure();
-      return {
-        ...payload,
-        status: normalizeStatus(status, payload.status)
-      };
-    }
-  });
-}
-function createSuccessfulSubmission(schemaDefinition, data) {
-  void schemaDefinition;
-  return createSubmission(true, data, createErrorBag());
-}
-function createFailedSubmission(schemaDefinition, values, flattenedErrors, status = 422) {
-  void schemaDefinition;
-  const normalizedStatus = normalizeStatus(status, 422);
-  return createSubmission(
-    false,
-    values,
-    createErrorBag(flattenedErrors),
-    normalizedStatus
-  );
-}
-function isRequestInput(input) {
-  return typeof Request !== "undefined" && input instanceof Request;
-}
-function isRequestLikeBody(value) {
-  if (typeof value === "string" || value instanceof URLSearchParams) {
-    return true;
-  }
-  if (typeof FormData !== "undefined" && value instanceof FormData) {
-    return true;
-  }
-  if (typeof Blob !== "undefined" && value instanceof Blob) {
-    return true;
-  }
-  if (typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer) {
-    return true;
-  }
-  if (ArrayBuffer.isView(value)) {
-    return true;
-  }
-  return !!value && typeof value === "object" && (Symbol.asyncIterator in value || "pipe" in value || "getReader" in value);
-}
-function isHeadersTupleArray(value) {
-  return Array.isArray(value) && value.every((entry) => Array.isArray(entry) && entry.length === 2 && typeof entry[0] === "string" && typeof entry[1] === "string");
-}
-function isRequestLikeHeaders(value) {
-  return value instanceof Headers || isHeadersTupleArray(value) || !!value && typeof value === "object";
-}
-function normalizeRequestHeaders(input) {
-  if (input instanceof Headers) {
-    return new Headers(input);
-  }
-  const headers = new Headers();
-  if (isHeadersTupleArray(input)) {
-    for (const [name, value] of input) {
-      headers.append(name, value);
-    }
-    return headers;
-  }
-  if (input && typeof input === "object") {
-    for (const [name, value] of Object.entries(input)) {
-      if (typeof value === "string") {
-        headers.append(name, value);
-        continue;
-      }
-      if (Array.isArray(value)) {
-        const separator = name.toLowerCase() === "cookie" ? "; " : ",";
-        const joined = value.filter((entry) => typeof entry === "string").join(separator);
-        if (joined) {
-          headers.append(name, joined);
-        }
-      }
-    }
-  }
-  return headers;
-}
-function extractRequestLikeUrl(input, headers) {
-  const url = input.web?.request?.url ?? (typeof input.url === "string" ? input.url : input.url?.toString()) ?? (typeof input.req === "object" && !(input.req instanceof Request) ? input.req.url : void 0) ?? input.node?.req?.url ?? input.path ?? "/";
-  try {
-    return new URL(url).toString();
-  } catch {
-    const protocol = headers.get("x-forwarded-proto") ?? "http";
-    const host = headers.get("x-forwarded-host") ?? headers.get("host") ?? "localhost";
-    return new URL(url, `${protocol}://${host}`).toString();
-  }
-}
-function extractRequestLikeMethod(input) {
-  return input.web?.request?.method ?? input.method ?? (typeof input.req === "object" && !(input.req instanceof Request) ? input.req.method : void 0) ?? input.node?.req?.method ?? "GET";
-}
-function extractRequestLikeBody(input, headers, method) {
-  if (method === "GET" || method === "HEAD") {
-    return void 0;
-  }
-  const rawBody = input.body ?? (typeof input.req === "object" && !(input.req instanceof Request) ? input.req.body : void 0) ?? input.node?.req?.body ?? input.node?.req;
-  if (typeof rawBody === "undefined" || rawBody === null) {
-    return void 0;
-  }
-  if (isRequestLikeBody(rawBody)) {
-    return rawBody;
-  }
-  if (typeof rawBody === "object") {
-    if (!headers.has("content-type")) {
-      headers.set("content-type", "application/json");
-    }
-    return JSON.stringify(rawBody);
-  }
-  return String(rawBody);
-}
-function isRequestLikeInput(input) {
-  if (!input || typeof input !== "object") {
-    return false;
-  }
-  const candidate = input;
-  return candidate.web?.request instanceof Request || candidate.req instanceof Request || typeof candidate.method === "string" || typeof candidate.path === "string" || typeof candidate.url === "string" || candidate.url instanceof URL || isRequestLikeHeaders(candidate.headers) || !!candidate.req && typeof candidate.req === "object" || !!candidate.node?.req && typeof candidate.node.req === "object";
-}
-function normalizeRequestLikeInput(input) {
-  if (isRequestInput(input)) {
-    return input;
-  }
-  if (!isRequestLikeInput(input)) {
-    return void 0;
-  }
-  if (input.web?.request instanceof Request) {
-    return input.web.request;
-  }
-  if (input.req instanceof Request) {
-    return input.req;
-  }
-  const headers = normalizeRequestHeaders(
-    input.headers ?? (typeof input.req === "object" && !(input.req instanceof Request) ? input.req.headers : void 0) ?? input.node?.req?.headers
-  );
-  const method = extractRequestLikeMethod(input);
-  const body = extractRequestLikeBody(input, headers, method);
-  return new Request(extractRequestLikeUrl(input, headers), {
-    method,
-    headers,
-    body,
-    // Undici requires duplex when constructing a Request from a stream/async iterable in Node.
-    ...body && typeof body === "object" && (Symbol.asyncIterator in body || "pipe" in body || "getReader" in body) ? { duplex: "half" } : {}
-  });
-}
-async function createSecurityFailureSubmission(input, schemaDefinition, error) {
-  let values = {};
-  let flattenedErrors = {};
-  try {
-    const inspection = await validateInput(input.clone(), schemaDefinition);
-    if (inspection.valid) {
-      values = inspection.data;
-    } else {
-      values = inspection.values;
-      flattenedErrors = inspection.errors.flatten();
-    }
-  } catch {
-    values = {};
-    flattenedErrors = {};
-  }
-  return createFailedSubmission(
-    schemaDefinition,
-    values,
-    {
-      ...flattenedErrors,
-      _root: [
-        ...flattenedErrors._root ?? [],
-        error.message
-      ]
-    },
-    error.status
-  );
-}
-async function validate(input, schemaDefinition, options = {}) {
-  let validatedSubmission;
-  const usesSecurityOptions = options.csrf === true || typeof options.throttle === "string";
-  const normalizedRequestInput = usesSecurityOptions ? normalizeRequestLikeInput(input) : void 0;
-  const validationInput = normalizedRequestInput ?? input;
-  if (usesSecurityOptions && !normalizedRequestInput) {
-    throw new FormContractError(
-      "Security-aware validate() options require a Request or request-like event input."
-    );
-  }
-  if (usesSecurityOptions) {
-    const request = normalizedRequestInput;
-    try {
-      const security = await loadSecurityModule();
-      const verificationRequest = (() => {
-        try {
-          return request.clone();
-        } catch {
-          return request;
-        }
-      })();
-      if (options.csrf === true) {
-        await security.csrf.verify(verificationRequest);
-      }
-      if (typeof options.throttle === "string") {
-        const inspection = await validateInput(request.clone(), schemaDefinition);
-        const throttleValues = inspection.valid ? inspection.data : inspection.values;
-        validatedSubmission = inspection.valid ? createSuccessfulSubmission(schemaDefinition, inspection.data) : createFailedSubmission(schemaDefinition, inspection.values, inspection.errors.flatten());
-        await security.rateLimit(options.throttle, {
-          request,
-          values: throttleValues
-        });
-      }
-    } catch (error) {
-      if (formsSecurityInternals.isRootSecurityError(error)) {
-        if (validatedSubmission) {
-          return createFailedSubmission(
-            schemaDefinition,
-            validatedSubmission.valid ? validatedSubmission.data : validatedSubmission.values,
-            {
-              ...validatedSubmission.valid ? {} : validatedSubmission.errors.flatten(),
-              _root: [
-                ...!validatedSubmission.valid ? validatedSubmission.errors.flatten()._root ?? [] : [],
-                error.message
-              ]
-            },
-            error.status
-          );
-        }
-        return await createSecurityFailureSubmission(request, schemaDefinition, error);
-      }
-      throw error;
-    }
-  }
-  if (validatedSubmission) {
-    return validatedSubmission;
-  }
-  const result = await validateInput(validationInput, schemaDefinition);
-  if (result.valid) {
-    return createSuccessfulSubmission(schemaDefinition, result.data);
-  }
-  return createFailedSubmission(schemaDefinition, result.values, result.errors.flatten());
-}
-var formsInternals = {
-  createSubmission,
-  isRequestLikeHeaders,
-  normalizeRequestLikeInput,
-  normalizeStatus,
-  normalizeRequestHeaders,
-  serializeSubmissionState
-};
-
-export {
-  formsSecurityInternals,
-  FormContractError,
-  schema,
-  isFormSchema,
-  createSuccessfulSubmission,
-  createFailedSubmission,
-  validate,
-  formsInternals
-};

package/dist/client.d.ts

@@ -1,52 +0,0 @@
-import { FormSubmissionResult, SerializedFormSubmission, FormFailurePayload, FormSuccessPayload, FormSchema } from './index.js';
-import { WebFileLike, ValidationErrorBag, SchemaInputShape, InferSchemaData } from '@holo-js/validation';
-
-type PrimitiveLike = string | number | boolean | bigint | symbol | null | undefined | Date | Blob | WebFileLike;
-type ValidateOnMode = 'submit' | 'blur' | 'change';
-interface ClientSubmitContext<TData> {
-    readonly action?: string;
-    readonly method: string;
-    readonly values: TData;
-    readonly formData: FormData;
-}
-type ClientSubmitResult<TData> = FormSubmissionResult<TData> | SerializedFormSubmission<TData> | FormFailurePayload<TData> | FormSuccessPayload<unknown>;
-interface UseFormOptions<TData> {
-    readonly action?: string;
-    readonly method?: string;
-    readonly csrf?: boolean;
-    readonly validateOn?: ValidateOnMode;
-    readonly initialValues?: Partial<TData>;
-    readonly initialState?: SerializedFormSubmission<TData>;
-    readonly submitter?: (context: ClientSubmitContext<TData>) => Promise<ClientSubmitResult<TData>> | ClientSubmitResult<TData>;
-}
-interface FormFieldState<TValue> {
-    value: TValue;
-    readonly errors: readonly string[];
-    readonly touched: boolean;
-    readonly dirty: boolean;
-    set(value: TValue): Promise<void>;
-    onInput(value: TValue): Promise<void>;
-    onBlur(): Promise<void>;
-    validate(): Promise<readonly string[]>;
-}
-type FormFieldTree<TData> = [TData] extends [readonly unknown[]] ? FormFieldState<TData> : [TData] extends [PrimitiveLike] ? FormFieldState<TData> : [TData] extends [Record<string, unknown>] ? {
-    readonly [K in keyof TData]: FormFieldTree<TData[K]>;
-} : FormFieldState<TData>;
-interface UseFormResult<TData> {
-    readonly fields: FormFieldTree<TData>;
-    readonly values: TData;
-    readonly errors: ValidationErrorBag<TData>;
-    readonly submitting: boolean;
-    readonly valid: boolean;
-    readonly lastSubmission?: SerializedFormSubmission<TData> | FormSuccessPayload<unknown>;
-    subscribe(listener: () => void): () => void;
-    validate(): Promise<FormSubmissionResult<TData>>;
-    validateField(path: string): Promise<readonly string[]>;
-    submit(): Promise<ClientSubmitResult<TData>>;
-    reset(values?: Partial<TData>): void;
-    setValue(path: string, value: unknown): Promise<void>;
-    applyServerState(result: ClientSubmitResult<TData>): ClientSubmitResult<TData>;
-}
-declare function useForm<TSchema extends FormSchema<SchemaInputShape>>(schemaDefinition: TSchema, options?: UseFormOptions<InferSchemaData<TSchema['fields']>>): UseFormResult<InferSchemaData<TSchema['fields']>>;
-
-export { type ClientSubmitContext, type ClientSubmitResult, type FormFieldState, type FormFieldTree, type UseFormOptions, type UseFormResult, type ValidateOnMode, useForm };