@proofkit/fmodata 0.1.0-alpha.0

package/dist/esm/filter-types.d.ts

@@ -0,0 +1,76 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+export type StringOperators = {
+    eq: string | null;
+} | {
+    ne: string | null;
+} | {
+    gt: string;
+} | {
+    ge: string;
+} | {
+    lt: string;
+} | {
+    le: string;
+} | {
+    contains: string;
+} | {
+    startswith: string;
+} | {
+    endswith: string;
+} | {
+    in: string[];
+};
+export type NumberOperators = {
+    eq: number | null;
+} | {
+    ne: number | null;
+} | {
+    gt: number;
+} | {
+    ge: number;
+} | {
+    lt: number;
+} | {
+    le: number;
+} | {
+    in: number[];
+};
+export type BooleanOperators = {
+    eq: boolean | null;
+} | {
+    ne: boolean | null;
+};
+export type DateOperators = {
+    eq: Date | null;
+} | {
+    ne: Date | null;
+} | {
+    gt: Date;
+} | {
+    ge: Date;
+} | {
+    lt: Date;
+} | {
+    le: Date;
+} | {
+    in: Date[];
+};
+export type InferOutput<S> = S extends StandardSchemaV1<any, infer Output> ? Output : never;
+export type OperatorsForType<T> = T extends string | null | undefined ? StringOperators : T extends number | null | undefined ? NumberOperators : T extends boolean | null | undefined ? BooleanOperators : T extends Date | null | undefined ? DateOperators : never;
+export type OperatorsForSchemaField<S extends StandardSchemaV1> = OperatorsForType<InferOutput<S>>;
+export type FieldFilter<S extends StandardSchemaV1> = InferOutput<S> | OperatorsForSchemaField<S> | Array<OperatorsForSchemaField<S>>;
+export type LogicalFilter<Schema extends Record<string, StandardSchemaV1>> = {
+    and?: Array<TypedFilter<Schema>>;
+    or?: Array<TypedFilter<Schema>>;
+    not?: TypedFilter<Schema>;
+};
+type IsUntypedSchema<Schema> = [
+    Record<string, StandardSchemaV1>
+] extends [Schema] ? [Schema] extends [Record<string, StandardSchemaV1>] ? true : false : false;
+export type TypedFilter<Schema extends Record<string, StandardSchemaV1>> = LogicalFilter<Schema> | (IsUntypedSchema<Schema> extends true ? {
+    [key: string]: FieldFilter<any> | any;
+} & {} : {
+    [K in keyof Schema]?: FieldFilter<Schema[K]>;
+});
+export type Filter<Schema extends Record<string, StandardSchemaV1>> = TypedFilter<Schema> | Array<TypedFilter<Schema>> | string;
+export {};

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export { BaseTable } from './client/base-table.js';
+export { TableOccurrence, createTableOccurrence, } from './client/table-occurrence.js';
+export { FileMakerOData } from './client/filemaker-odata.js';
+export type { Filter, TypedFilter, FieldFilter, StringOperators, NumberOperators, BooleanOperators, DateOperators, LogicalFilter, } from './filter-types.js';

package/dist/esm/index.js

@@ -0,0 +1,10 @@
+import { BaseTable } from "./client/base-table.js";
+import { TableOccurrence, createTableOccurrence } from "./client/table-occurrence.js";
+import { FileMakerOData } from "./client/filemaker-odata.js";
+export {
+  BaseTable,
+  FileMakerOData,
+  TableOccurrence,
+  createTableOccurrence
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/esm/types.d.ts

@@ -0,0 +1,67 @@
+import { FFetchOptions } from '@fetchkit/ffetch';
+import { z } from 'zod/v4';
+import { StandardSchemaV1 } from '@standard-schema/spec';
+export type Auth = {
+    username: string;
+    password: string;
+} | {
+    apiKey: string;
+};
+export interface ExecutableBuilder<T> {
+    execute(): Promise<Result<T>>;
+    getRequestConfig(): {
+        method: string;
+        url: string;
+        body?: any;
+    };
+}
+export interface ExecutionContext {
+    _makeRequest<T>(url: string, options?: RequestInit & FFetchOptions): Promise<T>;
+}
+export type InferSchemaType<Schema extends Record<string, StandardSchemaV1>> = {
+    [K in keyof Schema]: Schema[K] extends StandardSchemaV1<any, infer Output> ? Output : never;
+};
+export type WithSystemFields<T> = T extends Record<string, any> ? T & {
+    ROWID: number;
+    ROWMODID: number;
+} : never;
+export type ExcludeSystemFields<T extends keyof any> = Exclude<T, "ROWID" | "ROWMODID">;
+export type OmitSystemFields<T> = Omit<T, "ROWID" | "ROWMODID">;
+export type ODataRecordMetadata = {
+    "@id": string;
+    "@editLink": string;
+};
+export type ODataListResponse<T> = {
+    "@context": string;
+    value: (T & ODataRecordMetadata)[];
+};
+export type ODataSingleResponse<T> = T & ODataRecordMetadata & {
+    "@context": string;
+};
+export type ODataFieldResponse<T> = {
+    "@context": string;
+    value: T;
+};
+export type Result<T, E = Error> = {
+    data: T;
+    error: undefined;
+} | {
+    data: undefined;
+    error: E;
+};
+export type MakeFieldsRequired<T, Keys extends keyof T> = Partial<T> & Required<Pick<T, Keys>>;
+export type InsertData<BT> = BT extends import('./client/base-table.js').BaseTable<infer Schema extends Record<string, z.ZodType>, any, infer InsertRequired extends readonly any[], any> ? [InsertRequired[number]] extends [keyof InferSchemaType<Schema>] ? InsertRequired extends readonly (keyof InferSchemaType<Schema>)[] ? MakeFieldsRequired<InferSchemaType<Schema>, InsertRequired[number]> : Partial<InferSchemaType<Schema>> : Partial<InferSchemaType<Schema>> : Partial<Record<string, any>>;
+export type UpdateData<BT> = BT extends import('./client/base-table.js').BaseTable<infer Schema extends Record<string, z.ZodType>, any, any, infer UpdateRequired extends readonly any[]> ? [UpdateRequired[number]] extends [keyof InferSchemaType<Schema>] ? UpdateRequired extends readonly (keyof InferSchemaType<Schema>)[] ? MakeFieldsRequired<InferSchemaType<Schema>, UpdateRequired[number]> : Partial<InferSchemaType<Schema>> : Partial<InferSchemaType<Schema>> : Partial<Record<string, any>>;
+export type ExecuteOptions = {
+    includeODataAnnotations?: boolean;
+    skipValidation?: boolean;
+};
+export type ConditionallyWithODataAnnotations<T, IncludeODataAnnotations extends boolean> = IncludeODataAnnotations extends true ? T & {
+    "@id": string;
+    "@editLink": string;
+} : T;
+export type ExtractSchemaFromOccurrence<Occ> = Occ extends {
+    baseTable: {
+        schema: infer S;
+    };
+} ? S extends Record<string, StandardSchemaV1> ? S : Record<string, StandardSchemaV1> : Record<string, StandardSchemaV1>;

package/dist/esm/validation.d.ts

@@ -0,0 +1,41 @@
+import { ODataRecordMetadata } from './types.js';
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { TableOccurrence } from './client/table-occurrence.js';
+export type ExpandValidationConfig = {
+    relation: string;
+    targetSchema?: Record<string, StandardSchemaV1>;
+    targetOccurrence?: TableOccurrence<any, any, any, any>;
+    selectedFields?: string[];
+    nestedExpands?: ExpandValidationConfig[];
+};
+/**
+ * Validates a single record against a schema, only validating selected fields.
+ * Also validates expanded relations if expandConfigs are provided.
+ */
+export declare function validateRecord<T extends Record<string, any>>(record: any, schema: Record<string, StandardSchemaV1> | undefined, selectedFields?: (keyof T)[], expandConfigs?: ExpandValidationConfig[]): Promise<{
+    valid: true;
+    data: T & ODataRecordMetadata;
+} | {
+    valid: false;
+    error: Error;
+}>;
+/**
+ * Validates a list response against a schema.
+ */
+export declare function validateListResponse<T extends Record<string, any>>(response: any, schema: Record<string, StandardSchemaV1> | undefined, selectedFields?: (keyof T)[], expandConfigs?: ExpandValidationConfig[]): Promise<{
+    valid: true;
+    data: (T & ODataRecordMetadata)[];
+} | {
+    valid: false;
+    error: Error;
+}>;
+/**
+ * Validates a single record response against a schema.
+ */
+export declare function validateSingleResponse<T extends Record<string, any>>(response: any, schema: Record<string, StandardSchemaV1> | undefined, selectedFields?: (keyof T)[], expandConfigs?: ExpandValidationConfig[], mode?: "exact" | "maybe"): Promise<{
+    valid: true;
+    data: (T & ODataRecordMetadata) | null;
+} | {
+    valid: false;
+    error: Error;
+}>;

package/dist/esm/validation.js

@@ -0,0 +1,270 @@
+async function validateRecord(record, schema, selectedFields, expandConfigs) {
+  var _a, _b;
+  const { "@id": id, "@editLink": editLink, ...rest } = record;
+  const metadata = {
+    "@id": id || "",
+    "@editLink": editLink || ""
+  };
+  if (!schema) {
+    return {
+      valid: true,
+      data: { ...rest, ...metadata }
+    };
+  }
+  const { ROWID, ROWMODID, ...restWithoutSystemFields } = rest;
+  if (selectedFields && selectedFields.length > 0) {
+    const validatedRecord2 = {};
+    for (const field of selectedFields) {
+      const fieldName = String(field);
+      const fieldSchema = schema[fieldName];
+      if (fieldSchema) {
+        const input = rest[fieldName];
+        let result = fieldSchema["~standard"].validate(input);
+        if (result instanceof Promise) result = await result;
+        if (result.issues) {
+          return {
+            valid: false,
+            error: new Error(
+              `Validation failed for field '${fieldName}': ${JSON.stringify(result.issues, null, 2)}`
+            )
+          };
+        }
+        validatedRecord2[fieldName] = result.value;
+      } else {
+        validatedRecord2[fieldName] = rest[fieldName];
+      }
+    }
+    if (expandConfigs && expandConfigs.length > 0) {
+      for (const expandConfig of expandConfigs) {
+        const expandValue = rest[expandConfig.relation];
+        if (expandValue === void 0) {
+          if (Array.isArray(rest.error) && rest.error.length > 0) {
+            const errorDetail = (_a = rest.error[0]) == null ? void 0 : _a.error;
+            if (errorDetail == null ? void 0 : errorDetail.message) {
+              const errorMessage = errorDetail.message;
+              const isRelatedToExpand = errorMessage.toLowerCase().includes(expandConfig.relation.toLowerCase()) || expandConfig.selectedFields && expandConfig.selectedFields.some(
+                (field) => errorMessage.toLowerCase().includes(field.toLowerCase())
+              );
+              if (isRelatedToExpand) {
+                return {
+                  valid: false,
+                  error: new Error(
+                    `Validation failed for expanded relation '${expandConfig.relation}': ${errorMessage}`
+                  )
+                };
+              }
+            }
+          }
+        } else {
+          if (Array.isArray(expandValue)) {
+            const validatedExpandedItems = [];
+            for (let i = 0; i < expandValue.length; i++) {
+              const item = expandValue[i];
+              const itemValidation = await validateRecord(
+                item,
+                expandConfig.targetSchema,
+                expandConfig.selectedFields,
+                expandConfig.nestedExpands
+              );
+              if (!itemValidation.valid) {
+                return {
+                  valid: false,
+                  error: new Error(
+                    `Validation failed for expanded relation '${expandConfig.relation}' at index ${i}: ${itemValidation.error.message}`
+                  )
+                };
+              }
+              validatedExpandedItems.push(itemValidation.data);
+            }
+            validatedRecord2[expandConfig.relation] = validatedExpandedItems;
+          } else {
+            const itemValidation = await validateRecord(
+              expandValue,
+              expandConfig.targetSchema,
+              expandConfig.selectedFields,
+              expandConfig.nestedExpands
+            );
+            if (!itemValidation.valid) {
+              return {
+                valid: false,
+                error: new Error(
+                  `Validation failed for expanded relation '${expandConfig.relation}': ${itemValidation.error.message}`
+                )
+              };
+            }
+            validatedRecord2[expandConfig.relation] = itemValidation.data;
+          }
+        }
+      }
+    }
+    return {
+      valid: true,
+      data: { ...validatedRecord2, ...metadata }
+    };
+  }
+  const validatedRecord = { ...restWithoutSystemFields };
+  for (const [fieldName, fieldSchema] of Object.entries(schema)) {
+    const input = rest[fieldName];
+    let result = fieldSchema["~standard"].validate(input);
+    if (result instanceof Promise) result = await result;
+    if (result.issues) {
+      return {
+        valid: false,
+        error: new Error(
+          `Validation failed for field '${fieldName}': ${JSON.stringify(result.issues, null, 2)}`
+        )
+      };
+    }
+    validatedRecord[fieldName] = result.value;
+  }
+  if (expandConfigs && expandConfigs.length > 0) {
+    for (const expandConfig of expandConfigs) {
+      const expandValue = rest[expandConfig.relation];
+      if (expandValue === void 0) {
+        if (Array.isArray(rest.error) && rest.error.length > 0) {
+          const errorDetail = (_b = rest.error[0]) == null ? void 0 : _b.error;
+          if (errorDetail == null ? void 0 : errorDetail.message) {
+            const errorMessage = errorDetail.message;
+            const isRelatedToExpand = errorMessage.toLowerCase().includes(expandConfig.relation.toLowerCase()) || expandConfig.selectedFields && expandConfig.selectedFields.some(
+              (field) => errorMessage.toLowerCase().includes(field.toLowerCase())
+            );
+            if (isRelatedToExpand) {
+              return {
+                valid: false,
+                error: new Error(
+                  `Validation failed for expanded relation '${expandConfig.relation}': ${errorMessage}`
+                )
+              };
+            }
+          }
+        }
+      } else {
+        if (Array.isArray(expandValue)) {
+          const validatedExpandedItems = [];
+          for (let i = 0; i < expandValue.length; i++) {
+            const item = expandValue[i];
+            const itemValidation = await validateRecord(
+              item,
+              expandConfig.targetSchema,
+              expandConfig.selectedFields,
+              expandConfig.nestedExpands
+            );
+            if (!itemValidation.valid) {
+              return {
+                valid: false,
+                error: new Error(
+                  `Validation failed for expanded relation '${expandConfig.relation}' at index ${i}: ${itemValidation.error.message}`
+                )
+              };
+            }
+            validatedExpandedItems.push(itemValidation.data);
+          }
+          validatedRecord[expandConfig.relation] = validatedExpandedItems;
+        } else {
+          const itemValidation = await validateRecord(
+            expandValue,
+            expandConfig.targetSchema,
+            expandConfig.selectedFields,
+            expandConfig.nestedExpands
+          );
+          if (!itemValidation.valid) {
+            return {
+              valid: false,
+              error: new Error(
+                `Validation failed for expanded relation '${expandConfig.relation}': ${itemValidation.error.message}`
+              )
+            };
+          }
+          validatedRecord[expandConfig.relation] = itemValidation.data;
+        }
+      }
+    }
+  }
+  return {
+    valid: true,
+    data: { ...validatedRecord, ...metadata }
+  };
+}
+async function validateListResponse(response, schema, selectedFields, expandConfigs) {
+  if (!response || typeof response !== "object") {
+    return {
+      valid: false,
+      error: new Error("Invalid response: expected an object")
+    };
+  }
+  const { "@context": context, value, ...rest } = response;
+  if (!Array.isArray(value)) {
+    return {
+      valid: false,
+      error: new Error(
+        "Invalid response: expected 'value' property to be an array"
+      )
+    };
+  }
+  const validatedRecords = [];
+  for (let i = 0; i < value.length; i++) {
+    const record = value[i];
+    const validation = await validateRecord(
+      record,
+      schema,
+      selectedFields,
+      expandConfigs
+    );
+    if (!validation.valid) {
+      return {
+        valid: false,
+        error: new Error(
+          `Validation failed for record at index ${i}: ${validation.error.message}`
+        )
+      };
+    }
+    validatedRecords.push(validation.data);
+  }
+  return {
+    valid: true,
+    data: validatedRecords
+  };
+}
+async function validateSingleResponse(response, schema, selectedFields, expandConfigs, mode = "maybe") {
+  var _a;
+  if (response.value && Array.isArray(response.value) && response.value.length > 1) {
+    return {
+      valid: false,
+      error: new Error(
+        `Expected ${mode === "exact" ? "exactly one" : "at most one"} record, but received ${response.value.length}`
+      )
+    };
+  }
+  if (!response || response.value && response.value.length === 0) {
+    if (mode === "exact") {
+      return {
+        valid: false,
+        error: new Error("Expected exactly one record, but received none")
+      };
+    }
+    return {
+      valid: true,
+      data: null
+    };
+  }
+  const record = ((_a = response.value) == null ? void 0 : _a[0]) ?? response;
+  const validation = await validateRecord(
+    record,
+    schema,
+    selectedFields,
+    expandConfigs
+  );
+  if (!validation.valid) {
+    return validation;
+  }
+  return {
+    valid: true,
+    data: validation.data
+  };
+}
+export {
+  validateListResponse,
+  validateRecord,
+  validateSingleResponse
+};
+//# sourceMappingURL=validation.js.map

package/dist/esm/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sources":["../../src/validation.ts"],"sourcesContent":["import type { ODataRecordMetadata } from \"./types\";\nimport { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { TableOccurrence } from \"./client/table-occurrence\";\n\n// Type for expand validation configuration\nexport type ExpandValidationConfig = {\n  relation: string;\n  targetSchema?: Record<string, StandardSchemaV1>;\n  targetOccurrence?: TableOccurrence<any, any, any, any>;\n  selectedFields?: string[];\n  nestedExpands?: ExpandValidationConfig[];\n};\n\n/**\n * Validates a single record against a schema, only validating selected fields.\n * Also validates expanded relations if expandConfigs are provided.\n */\nexport async function validateRecord<T extends Record<string, any>>(\n  record: any,\n  schema: Record<string, StandardSchemaV1> | undefined,\n  selectedFields?: (keyof T)[],\n  expandConfigs?: ExpandValidationConfig[],\n): Promise<\n  | { valid: true; data: T & ODataRecordMetadata }\n  | { valid: false; error: Error }\n> {\n  // Extract OData metadata fields (don't validate them - include if present)\n  const { \"@id\": id, \"@editLink\": editLink, ...rest } = record;\n\n  // Include metadata fields if present (don't validate they exist)\n  const metadata: ODataRecordMetadata = {\n    \"@id\": id || \"\",\n    \"@editLink\": editLink || \"\",\n  };\n\n  // If no schema, just return the data with metadata\n  if (!schema) {\n    return {\n      valid: true,\n      data: { ...rest, ...metadata } as T & ODataRecordMetadata,\n    };\n  }\n\n  // Filter out FileMaker system fields that shouldn't be in responses by default\n  const { ROWID, ROWMODID, ...restWithoutSystemFields } = rest;\n\n  // If selected fields are specified, validate only those fields\n  if (selectedFields && selectedFields.length > 0) {\n    const validatedRecord: Record<string, any> = {};\n\n    for (const field of selectedFields) {\n      const fieldName = String(field);\n      const fieldSchema = schema[fieldName];\n\n      if (fieldSchema) {\n        const input = rest[fieldName];\n        let result = fieldSchema[\"~standard\"].validate(input);\n        if (result instanceof Promise) result = await result;\n\n        // if the `issues` field exists, the validation failed\n        if (result.issues) {\n          return {\n            valid: false,\n            error: new Error(\n              `Validation failed for field '${fieldName}': ${JSON.stringify(result.issues, null, 2)}`,\n            ),\n          };\n        }\n\n        validatedRecord[fieldName] = result.value;\n      } else {\n        // For fields not in schema (like when explicitly selecting ROWID/ROWMODID)\n        // include them from the original response\n        validatedRecord[fieldName] = rest[fieldName];\n      }\n    }\n\n    // Validate expanded relations\n    if (expandConfigs && expandConfigs.length > 0) {\n      for (const expandConfig of expandConfigs) {\n        const expandValue = rest[expandConfig.relation];\n\n        // Check if expand field is missing\n        if (expandValue === undefined) {\n          // Check for inline error array (FileMaker returns errors inline when expand fails)\n          if (Array.isArray(rest.error) && rest.error.length > 0) {\n            // Extract error message from inline error\n            const errorDetail = rest.error[0]?.error;\n            if (errorDetail?.message) {\n              const errorMessage = errorDetail.message;\n              // Check if the error is related to this expand by checking if:\n              // 1. The error mentions the relation name, OR\n              // 2. The error mentions any of the selected fields\n              const isRelatedToExpand =\n                errorMessage\n                  .toLowerCase()\n                  .includes(expandConfig.relation.toLowerCase()) ||\n                (expandConfig.selectedFields &&\n                  expandConfig.selectedFields.some((field) =>\n                    errorMessage.toLowerCase().includes(field.toLowerCase()),\n                  ));\n\n              if (isRelatedToExpand) {\n                return {\n                  valid: false,\n                  error: new Error(\n                    `Validation failed for expanded relation '${expandConfig.relation}': ${errorMessage}`,\n                  ),\n                };\n              }\n            }\n          }\n          // If no inline error but expand was expected, that's also an issue\n          // However, this might be a legitimate case (e.g., no related records)\n          // So we'll only fail if there's an explicit error array\n        } else {\n          // Original validation logic for when expand exists\n          if (Array.isArray(expandValue)) {\n            // Validate each item in the expanded array\n            const validatedExpandedItems: any[] = [];\n            for (let i = 0; i < expandValue.length; i++) {\n              const item = expandValue[i];\n              const itemValidation = await validateRecord(\n                item,\n                expandConfig.targetSchema,\n                expandConfig.selectedFields as string[] | undefined,\n                expandConfig.nestedExpands,\n              );\n              if (!itemValidation.valid) {\n                return {\n                  valid: false,\n                  error: new Error(\n                    `Validation failed for expanded relation '${expandConfig.relation}' at index ${i}: ${itemValidation.error.message}`,\n                  ),\n                };\n              }\n              validatedExpandedItems.push(itemValidation.data);\n            }\n            validatedRecord[expandConfig.relation] = validatedExpandedItems;\n          } else {\n            // Single expanded item (shouldn't happen in OData, but handle it)\n            const itemValidation = await validateRecord(\n              expandValue,\n              expandConfig.targetSchema,\n              expandConfig.selectedFields as string[] | undefined,\n              expandConfig.nestedExpands,\n            );\n            if (!itemValidation.valid) {\n              return {\n                valid: false,\n                error: new Error(\n                  `Validation failed for expanded relation '${expandConfig.relation}': ${itemValidation.error.message}`,\n                ),\n              };\n            }\n            validatedRecord[expandConfig.relation] = itemValidation.data;\n          }\n        }\n      }\n    }\n\n    // Merge validated data with metadata\n    return {\n      valid: true,\n      data: { ...validatedRecord, ...metadata } as T & ODataRecordMetadata,\n    };\n  }\n\n  // Validate all fields in schema, but exclude ROWID/ROWMODID by default\n  const validatedRecord: Record<string, any> = { ...restWithoutSystemFields };\n\n  for (const [fieldName, fieldSchema] of Object.entries(schema)) {\n    const input = rest[fieldName];\n    let result = fieldSchema[\"~standard\"].validate(input);\n    if (result instanceof Promise) result = await result;\n\n    // if the `issues` field exists, the validation failed\n    if (result.issues) {\n      return {\n        valid: false,\n        error: new Error(\n          `Validation failed for field '${fieldName}': ${JSON.stringify(result.issues, null, 2)}`,\n        ),\n      };\n    }\n\n    validatedRecord[fieldName] = result.value;\n  }\n\n  // Validate expanded relations even when not using selected fields\n  if (expandConfigs && expandConfigs.length > 0) {\n    for (const expandConfig of expandConfigs) {\n      const expandValue = rest[expandConfig.relation];\n\n      // Check if expand field is missing\n      if (expandValue === undefined) {\n        // Check for inline error array (FileMaker returns errors inline when expand fails)\n        if (Array.isArray(rest.error) && rest.error.length > 0) {\n          // Extract error message from inline error\n          const errorDetail = rest.error[0]?.error;\n          if (errorDetail?.message) {\n            const errorMessage = errorDetail.message;\n            // Check if the error is related to this expand by checking if:\n            // 1. The error mentions the relation name, OR\n            // 2. The error mentions any of the selected fields\n            const isRelatedToExpand =\n              errorMessage\n                .toLowerCase()\n                .includes(expandConfig.relation.toLowerCase()) ||\n              (expandConfig.selectedFields &&\n                expandConfig.selectedFields.some((field) =>\n                  errorMessage.toLowerCase().includes(field.toLowerCase()),\n                ));\n\n            if (isRelatedToExpand) {\n              return {\n                valid: false,\n                error: new Error(\n                  `Validation failed for expanded relation '${expandConfig.relation}': ${errorMessage}`,\n                ),\n              };\n            }\n          }\n        }\n        // If no inline error but expand was expected, that's also an issue\n        // However, this might be a legitimate case (e.g., no related records)\n        // So we'll only fail if there's an explicit error array\n      } else {\n        // Original validation logic for when expand exists\n        if (Array.isArray(expandValue)) {\n          // Validate each item in the expanded array\n          const validatedExpandedItems: any[] = [];\n          for (let i = 0; i < expandValue.length; i++) {\n            const item = expandValue[i];\n            const itemValidation = await validateRecord(\n              item,\n              expandConfig.targetSchema,\n              expandConfig.selectedFields as string[] | undefined,\n              expandConfig.nestedExpands,\n            );\n            if (!itemValidation.valid) {\n              return {\n                valid: false,\n                error: new Error(\n                  `Validation failed for expanded relation '${expandConfig.relation}' at index ${i}: ${itemValidation.error.message}`,\n                ),\n              };\n            }\n            validatedExpandedItems.push(itemValidation.data);\n          }\n          validatedRecord[expandConfig.relation] = validatedExpandedItems;\n        } else {\n          // Single expanded item (shouldn't happen in OData, but handle it)\n          const itemValidation = await validateRecord(\n            expandValue,\n            expandConfig.targetSchema,\n            expandConfig.selectedFields as string[] | undefined,\n            expandConfig.nestedExpands,\n          );\n          if (!itemValidation.valid) {\n            return {\n              valid: false,\n              error: new Error(\n                `Validation failed for expanded relation '${expandConfig.relation}': ${itemValidation.error.message}`,\n              ),\n            };\n          }\n          validatedRecord[expandConfig.relation] = itemValidation.data;\n        }\n      }\n    }\n  }\n\n  return {\n    valid: true,\n    data: { ...validatedRecord, ...metadata } as T & ODataRecordMetadata,\n  };\n}\n\n/**\n * Validates a list response against a schema.\n */\nexport async function validateListResponse<T extends Record<string, any>>(\n  response: any,\n  schema: Record<string, StandardSchemaV1> | undefined,\n  selectedFields?: (keyof T)[],\n  expandConfigs?: ExpandValidationConfig[],\n): Promise<\n  | { valid: true; data: (T & ODataRecordMetadata)[] }\n  | { valid: false; error: Error }\n> {\n  // Check if response has the expected structure\n  if (!response || typeof response !== \"object\") {\n    return {\n      valid: false,\n      error: new Error(\"Invalid response: expected an object\"),\n    };\n  }\n\n  // Extract @context (for internal validation, but we won't return it)\n  const { \"@context\": context, value, ...rest } = response;\n\n  if (!Array.isArray(value)) {\n    return {\n      valid: false,\n      error: new Error(\n        \"Invalid response: expected 'value' property to be an array\",\n      ),\n    };\n  }\n\n  // Validate each record in the array\n  const validatedRecords: (T & ODataRecordMetadata)[] = [];\n\n  for (let i = 0; i < value.length; i++) {\n    const record = value[i];\n    const validation = await validateRecord<T>(\n      record,\n      schema,\n      selectedFields,\n      expandConfigs,\n    );\n\n    if (!validation.valid) {\n      return {\n        valid: false,\n        error: new Error(\n          `Validation failed for record at index ${i}: ${validation.error.message}`,\n        ),\n      };\n    }\n\n    validatedRecords.push(validation.data);\n  }\n\n  return {\n    valid: true,\n    data: validatedRecords,\n  };\n}\n\n/**\n * Validates a single record response against a schema.\n */\nexport async function validateSingleResponse<T extends Record<string, any>>(\n  response: any,\n  schema: Record<string, StandardSchemaV1> | undefined,\n  selectedFields?: (keyof T)[],\n  expandConfigs?: ExpandValidationConfig[],\n  mode: \"exact\" | \"maybe\" = \"maybe\",\n): Promise<\n  | { valid: true; data: (T & ODataRecordMetadata) | null }\n  | { valid: false; error: Error }\n> {\n  // Check for multiple records (error in both modes)\n  if (response.value && Array.isArray(response.value) && response.value.length > 1) {\n    return {\n      valid: false,\n      error: new Error(\n        `Expected ${mode === \"exact\" ? \"exactly one\" : \"at most one\"} record, but received ${response.value.length}`\n      ),\n    };\n  }\n\n  // Handle empty responses\n  if (!response || (response.value && response.value.length === 0)) {\n    if (mode === \"exact\") {\n      return {\n        valid: false,\n        error: new Error(\"Expected exactly one record, but received none\"),\n      };\n    }\n    // mode === \"maybe\" - return null for empty\n    return {\n      valid: true,\n      data: null,\n    };\n  }\n\n  // Single record validation\n  const record = response.value?.[0] ?? response;\n  const validation = await validateRecord<T>(\n    record,\n    schema,\n    selectedFields,\n    expandConfigs,\n  );\n\n  if (!validation.valid) {\n    return validation as { valid: false; error: Error };\n  }\n\n  return {\n    valid: true,\n    data: validation.data,\n  };\n}\n"],"names":["validatedRecord"],"mappings":"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"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@proofkit/fmodata",
+  "version": "0.1.0-alpha.0",
+  "description": "FileMaker OData API client",
+  "repository": "git@github.com:proofgeist/proofkit.git",
+  "author": "Eric <37158449+eluce2@users.noreply.github.com>",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc && vite build && publint --strict",
+    "build:watch": "tsc && vite build --watch",
+    "check-format": "prettier --check .",
+    "format": "prettier --write .",
+    "dev": "tsc --watch",
+    "test": "vitest run --typecheck",
+    "test:typecheck": "vitest run --typecheck",
+    "test:watch": "vitest --typecheck",
+    "test:e2e": "op inject -i op.env -o .env.local -f && vitest run tests/e2e.test.ts",
+    "capture": "op inject -i op.env -o .env.local -f && tsx scripts/capture-responses.ts",
+    "knip": "knip",
+    "pub:alpha": "bun run scripts/publish-alpha.ts"
+  },
+  "dependencies": {
+    "@fetchkit/ffetch": "^4.1.0",
+    "dotenv": "^16.5.0",
+    "neverthrow": "^8.2.0",
+    "odata-query": "^8.0.4"
+  },
+  "devDependencies": {
+    "@standard-schema/spec": "^1.0.0",
+    "@tanstack/vite-config": "^0.2.0",
+    "@types/node": "^22.17.1",
+    "prettier": "^3.5.3",
+    "publint": "^0.3.12",
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.3",
+    "vite": "^6.3.4",
+    "vitest": "^4.0.7",
+    "zod": "4.1.12"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "keywords": [
+    "filemaker",
+    "fms",
+    "fm",
+    "odata",
+    "proofgeist",
+    "proofkit"
+  ]
+}

package/src/client/base-table.ts

@@ -0,0 +1,25 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+export class BaseTable<
+  Schema extends Record<string, StandardSchemaV1> = any,
+  IdField extends keyof Schema | undefined = undefined,
+  InsertRequired extends readonly (keyof Schema)[] = readonly [],
+  UpdateRequired extends readonly (keyof Schema)[] = readonly [],
+> {
+  public readonly schema: Schema;
+  public readonly idField?: IdField;
+  public readonly insertRequired?: InsertRequired;
+  public readonly updateRequired?: UpdateRequired;
+
+  constructor(config: {
+    schema: Schema;
+    idField?: IdField;
+    insertRequired?: InsertRequired;
+    updateRequired?: UpdateRequired;
+  }) {
+    this.schema = config.schema;
+    this.idField = config.idField;
+    this.insertRequired = config.insertRequired;
+    this.updateRequired = config.updateRequired;
+  }
+}