@api-client/core 0.15.1 → 0.16.0

package/build/src/modeling/definitions/Categories.js

@@ -0,0 +1,33 @@
+import { SemanticType } from '../Semantics.js';
+/**
+ * Type guard to check if a semantic is a Categories semantic.
+ */
+export const isCategoriesSemantic = (semantic) => {
+    return semantic.id === SemanticType.Categories;
+};
+/**
+ * Helper function to create a Categories semantic with configuration.
+ */
+export const createCategoriesSemantic = (config = {}) => {
+    const mergedConfig = {
+        ...DEFAULT_CATEGORIES_CONFIG,
+        ...config,
+    };
+    if (config.metadata) {
+        mergedConfig.metadata = { ...config.metadata };
+    }
+    return {
+        id: SemanticType.Categories,
+        config: mergedConfig,
+    };
+};
+/**
+ * Default configuration for Categories semantic.
+ */
+export const DEFAULT_CATEGORIES_CONFIG = {
+    allowCustomCategories: true,
+    allowHierarchy: true,
+    caseSensitive: false,
+    allowUnicode: false,
+};
+//# sourceMappingURL=Categories.js.map

package/build/src/modeling/definitions/Categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Categories.js","sourceRoot":"","sources":["../../../../src/modeling/definitions/Categories.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAiD9C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAA6B,EAAyC,EAAE;IAC3G,OAAO,QAAQ,CAAC,EAAE,KAAK,YAAY,CAAC,UAAU,CAAA;AAChD,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAA2B,EAAE,EAA6B,EAAE;IACnG,MAAM,YAAY,GAAG;QACnB,GAAG,yBAAyB;QAC5B,GAAG,MAAM;KACV,CAAA;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,UAAU;QAC3B,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,qBAAqB,EAAE,IAAI;IAC3B,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,KAAK;CACpB,CAAA","sourcesContent":["import type { AppliedDataSemantic } from '../Semantics.js'\nimport { SemanticType } from '../Semantics.js'\n\n/**\n * Configuration options for the Categories semantic.\n * Controls allowed categories, hierarchy, and formatting for associations.\n */\nexport interface CategoriesConfig {\n  /**\n   * List of allowed categories.\n   */\n  allowedCategories?: string[]\n  /**\n   * Whether to allow custom categories not in the allowedCategories list.\n   */\n  allowCustomCategories?: boolean\n  /**\n   * Whether to allow hierarchical categories (tree structure).\n   */\n  allowHierarchy?: boolean\n  /**\n   * Maximum depth of the category hierarchy.\n   */\n  maxDepth?: number\n  /**\n   * Whether categories are case sensitive.\n   */\n  caseSensitive?: boolean\n  /**\n   * Whether to allow Unicode characters in categories.\n   */\n  allowUnicode?: boolean\n  /**\n   * Custom metadata for the categories association.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * Index signature to allow additional properties.\n   */\n  [key: string]: unknown\n}\n\n/**\n * Type-safe configuration for Categories semantic.\n */\nexport interface AppliedCategoriesSemantic extends AppliedDataSemantic {\n  id: SemanticType.Categories\n  config?: CategoriesConfig\n}\n\n/**\n * Type guard to check if a semantic is a Categories semantic.\n */\nexport const isCategoriesSemantic = (semantic: AppliedDataSemantic): semantic is AppliedCategoriesSemantic => {\n  return semantic.id === SemanticType.Categories\n}\n\n/**\n * Helper function to create a Categories semantic with configuration.\n */\nexport const createCategoriesSemantic = (config: CategoriesConfig = {}): AppliedCategoriesSemantic => {\n  const mergedConfig = {\n    ...DEFAULT_CATEGORIES_CONFIG,\n    ...config,\n  }\n  if (config.metadata) {\n    mergedConfig.metadata = { ...config.metadata }\n  }\n\n  return {\n    id: SemanticType.Categories,\n    config: mergedConfig,\n  }\n}\n\n/**\n * Default configuration for Categories semantic.\n */\nexport const DEFAULT_CATEGORIES_CONFIG: CategoriesConfig = {\n  allowCustomCategories: true,\n  allowHierarchy: true,\n  caseSensitive: false,\n  allowUnicode: false,\n}\n"]}

package/build/src/modeling/definitions/Derived.d.ts

@@ -0,0 +1,54 @@
+import type { AppliedDataSemantic } from '../Semantics.js';
+import { SemanticType } from '../Semantics.js';
+/**
+ * Configuration options for the Derived semantic.
+ * Controls source fields, transformation, and recalculation behavior.
+ *
+ * Use Derived when you need to combine, format, or transform existing field values
+ */
+export interface DerivedConfig {
+    /**
+     * List of source field names this value is derived from.
+     */
+    sourceFields: string[];
+    /**
+     * Name of a transformation function to apply to the source fields.
+     */
+    transformation?: string;
+    /**
+     * Whether to recalculate the value on update (default: true).
+     */
+    recalculateOnUpdate?: boolean;
+    /**
+     * Whether to allow manual override of the derived value.
+     */
+    allowManualOverride?: boolean;
+    /**
+     * Custom metadata for the derived field.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Index signature to allow additional properties.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Type-safe configuration for Derived semantic.
+ */
+export interface AppliedDerivedSemantic extends AppliedDataSemantic {
+    id: SemanticType.Derived;
+    config?: DerivedConfig;
+}
+/**
+ * Type guard to check if a semantic is a Derived semantic.
+ */
+export declare const isDerivedSemantic: (semantic: AppliedDataSemantic) => semantic is AppliedDerivedSemantic;
+/**
+ * Helper function to create a Derived semantic with configuration.
+ */
+export declare const createDerivedSemantic: (config: DerivedConfig) => AppliedDerivedSemantic;
+/**
+ * Default configuration for Derived semantic.
+ */
+export declare const DEFAULT_DERIVED_CONFIG: Partial<DerivedConfig>;
+//# sourceMappingURL=Derived.d.ts.map

package/build/src/modeling/definitions/Derived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Derived.d.ts","sourceRoot":"","sources":["../../../../src/modeling/definitions/Derived.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,EAAE,EAAE,YAAY,CAAC,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,mBAAmB,KAAG,QAAQ,IAAI,sBAE7E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,aAAa,KAAG,sBAa7D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,aAAa,CAGzD,CAAA"}

package/build/src/modeling/definitions/Derived.js

@@ -0,0 +1,31 @@
+import { SemanticType } from '../Semantics.js';
+/**
+ * Type guard to check if a semantic is a Derived semantic.
+ */
+export const isDerivedSemantic = (semantic) => {
+    return semantic.id === SemanticType.Derived;
+};
+/**
+ * Helper function to create a Derived semantic with configuration.
+ */
+export const createDerivedSemantic = (config) => {
+    const mergedConfig = {
+        ...DEFAULT_DERIVED_CONFIG,
+        ...config,
+    };
+    if (config.metadata) {
+        mergedConfig.metadata = { ...config.metadata };
+    }
+    return {
+        id: SemanticType.Derived,
+        config: mergedConfig,
+    };
+};
+/**
+ * Default configuration for Derived semantic.
+ */
+export const DEFAULT_DERIVED_CONFIG = {
+    recalculateOnUpdate: true,
+    allowManualOverride: false,
+};
+//# sourceMappingURL=Derived.js.map

package/build/src/modeling/definitions/Derived.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Derived.js","sourceRoot":"","sources":["../../../../src/modeling/definitions/Derived.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AA2C9C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAA6B,EAAsC,EAAE;IACrG,OAAO,QAAQ,CAAC,EAAE,KAAK,YAAY,CAAC,OAAO,CAAA;AAC7C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAqB,EAA0B,EAAE;IACrF,MAAM,YAAY,GAAG;QACnB,GAAG,sBAAsB;QACzB,GAAG,MAAM;KACV,CAAA;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,OAAO;QACxB,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC5D,mBAAmB,EAAE,IAAI;IACzB,mBAAmB,EAAE,KAAK;CAC3B,CAAA","sourcesContent":["import type { AppliedDataSemantic } from '../Semantics.js'\nimport { SemanticType } from '../Semantics.js'\n\n/**\n * Configuration options for the Derived semantic.\n * Controls source fields, transformation, and recalculation behavior.\n *\n * Use Derived when you need to combine, format, or transform existing field values\n */\nexport interface DerivedConfig {\n  /**\n   * List of source field names this value is derived from.\n   */\n  sourceFields: string[]\n  /**\n   * Name of a transformation function to apply to the source fields.\n   */\n  transformation?: string\n  /**\n   * Whether to recalculate the value on update (default: true).\n   */\n  recalculateOnUpdate?: boolean\n  /**\n   * Whether to allow manual override of the derived value.\n   */\n  allowManualOverride?: boolean\n  /**\n   * Custom metadata for the derived field.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * Index signature to allow additional properties.\n   */\n  [key: string]: unknown\n}\n\n/**\n * Type-safe configuration for Derived semantic.\n */\nexport interface AppliedDerivedSemantic extends AppliedDataSemantic {\n  id: SemanticType.Derived\n  config?: DerivedConfig\n}\n\n/**\n * Type guard to check if a semantic is a Derived semantic.\n */\nexport const isDerivedSemantic = (semantic: AppliedDataSemantic): semantic is AppliedDerivedSemantic => {\n  return semantic.id === SemanticType.Derived\n}\n\n/**\n * Helper function to create a Derived semantic with configuration.\n */\nexport const createDerivedSemantic = (config: DerivedConfig): AppliedDerivedSemantic => {\n  const mergedConfig = {\n    ...DEFAULT_DERIVED_CONFIG,\n    ...config,\n  }\n  if (config.metadata) {\n    mergedConfig.metadata = { ...config.metadata }\n  }\n\n  return {\n    id: SemanticType.Derived,\n    config: mergedConfig,\n  }\n}\n\n/**\n * Default configuration for Derived semantic.\n */\nexport const DEFAULT_DERIVED_CONFIG: Partial<DerivedConfig> = {\n  recalculateOnUpdate: true,\n  allowManualOverride: false,\n}\n"]}

package/build/src/modeling/definitions/Description.d.ts

@@ -0,0 +1,36 @@
+import type { AppliedDataSemantic } from '../Semantics.js';
+import { SemanticType } from '../Semantics.js';
+/**
+ * Configuration options for the Description semantic.
+ * Controls length, formatting, and markdown support.
+ */
+export interface DescriptionConfig {
+    /**
+     * Custom metadata for the description field.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Index signature to allow additional properties.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Type-safe configuration for Description semantic.
+ */
+export interface AppliedDescriptionSemantic extends AppliedDataSemantic {
+    id: SemanticType.Description;
+    config?: DescriptionConfig;
+}
+/**
+ * Type guard to check if a semantic is a Description semantic.
+ */
+export declare const isDescriptionSemantic: (semantic: AppliedDataSemantic) => semantic is AppliedDescriptionSemantic;
+/**
+ * Helper function to create a Description semantic with configuration.
+ */
+export declare const createDescriptionSemantic: (config?: DescriptionConfig) => AppliedDescriptionSemantic;
+/**
+ * Default configuration for Description semantic.
+ */
+export declare const DEFAULT_DESCRIPTION_CONFIG: DescriptionConfig;
+//# sourceMappingURL=Description.d.ts.map

package/build/src/modeling/definitions/Description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Description.d.ts","sourceRoot":"","sources":["../../../../src/modeling/definitions/Description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,EAAE,EAAE,YAAY,CAAC,WAAW,CAAA;IAC5B,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,mBAAmB,KAAG,QAAQ,IAAI,0BAEjF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAQ,iBAAsB,KAAG,0BAa1E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAAsB,CAAA"}

package/build/src/modeling/definitions/Description.js

@@ -0,0 +1,28 @@
+import { SemanticType } from '../Semantics.js';
+/**
+ * Type guard to check if a semantic is a Description semantic.
+ */
+export const isDescriptionSemantic = (semantic) => {
+    return semantic.id === SemanticType.Description;
+};
+/**
+ * Helper function to create a Description semantic with configuration.
+ */
+export const createDescriptionSemantic = (config = {}) => {
+    const mergedConfig = {
+        ...DEFAULT_DESCRIPTION_CONFIG,
+        ...config,
+    };
+    if (config.metadata) {
+        mergedConfig.metadata = { ...config.metadata };
+    }
+    return {
+        id: SemanticType.Description,
+        config: mergedConfig,
+    };
+};
+/**
+ * Default configuration for Description semantic.
+ */
+export const DEFAULT_DESCRIPTION_CONFIG = {};
+//# sourceMappingURL=Description.js.map

package/build/src/modeling/definitions/Description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Description.js","sourceRoot":"","sources":["../../../../src/modeling/definitions/Description.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAyB9C;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAA6B,EAA0C,EAAE;IAC7G,OAAO,QAAQ,CAAC,EAAE,KAAK,YAAY,CAAC,WAAW,CAAA;AACjD,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,SAA4B,EAAE,EAA8B,EAAE;IACtG,MAAM,YAAY,GAAG;QACnB,GAAG,0BAA0B;QAC7B,GAAG,MAAM;KACV,CAAA;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,WAAW;QAC5B,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB,EAAE,CAAA","sourcesContent":["import type { AppliedDataSemantic } from '../Semantics.js'\nimport { SemanticType } from '../Semantics.js'\n\n/**\n * Configuration options for the Description semantic.\n * Controls length, formatting, and markdown support.\n */\nexport interface DescriptionConfig {\n  /**\n   * Custom metadata for the description field.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * Index signature to allow additional properties.\n   */\n  [key: string]: unknown\n}\n\n/**\n * Type-safe configuration for Description semantic.\n */\nexport interface AppliedDescriptionSemantic extends AppliedDataSemantic {\n  id: SemanticType.Description\n  config?: DescriptionConfig\n}\n\n/**\n * Type guard to check if a semantic is a Description semantic.\n */\nexport const isDescriptionSemantic = (semantic: AppliedDataSemantic): semantic is AppliedDescriptionSemantic => {\n  return semantic.id === SemanticType.Description\n}\n\n/**\n * Helper function to create a Description semantic with configuration.\n */\nexport const createDescriptionSemantic = (config: DescriptionConfig = {}): AppliedDescriptionSemantic => {\n  const mergedConfig = {\n    ...DEFAULT_DESCRIPTION_CONFIG,\n    ...config,\n  }\n  if (config.metadata) {\n    mergedConfig.metadata = { ...config.metadata }\n  }\n\n  return {\n    id: SemanticType.Description,\n    config: mergedConfig,\n  }\n}\n\n/**\n * Default configuration for Description semantic.\n */\nexport const DEFAULT_DESCRIPTION_CONFIG: DescriptionConfig = {}\n"]}

package/build/src/modeling/definitions/Email.d.ts

@@ -0,0 +1,66 @@
+import type { AppliedDataSemantic } from '../Semantics.js';
+import { SemanticType } from '../Semantics.js';
+/**
+ * Configuration options for the Email semantic.
+ * Controls validation, allowed domains, and verification.
+ */
+export interface EmailConfig {
+    /**
+     * List of allowed email domains (e.g., ['example.com']).
+     */
+    allowedDomains?: string[];
+    /**
+     * Whether email verification is required.
+     */
+    requireVerification?: boolean;
+    /**
+     * Method to use for verification: 'email', 'sms', or 'none'.
+     */
+    verificationMethod?: 'email' | 'sms' | 'none';
+    /**
+     * Whether to allow subaddressing (user+tag@domain.com).
+     */
+    allowSubaddressing?: boolean;
+    /**
+     * Whether to allow internationalized email addresses.
+     *
+     * - When true (default): Allows email addresses with non-ASCII characters in the domain part,
+     *   like user@münchen.de or user@café.com
+     * - When false: Only allows ASCII characters in the domain part, like user@example.com
+     *
+     * Why it exists:
+     * - Internationalization: Many countries have domain names with native characters (like German umlauts,
+     *   French accents, etc.)
+     * - RFC 6531: The standard for internationalized email addresses
+     * - Validation flexibility: Some systems may need to restrict to ASCII-only domains for compatibility reasons
+     */
+    allowInternational?: boolean;
+    /**
+     * Custom metadata for the email field.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Index signature to allow additional properties.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Type-safe configuration for Email semantic.
+ */
+export interface AppliedEmailSemantic extends AppliedDataSemantic {
+    id: SemanticType.Email;
+    config?: EmailConfig;
+}
+/**
+ * Type guard to check if a semantic is an Email semantic.
+ */
+export declare const isEmailSemantic: (semantic: AppliedDataSemantic) => semantic is AppliedEmailSemantic;
+/**
+ * Helper function to create an Email semantic with configuration.
+ */
+export declare const createEmailSemantic: (config?: EmailConfig) => AppliedEmailSemantic;
+/**
+ * Default configuration for Email semantic.
+ */
+export declare const DEFAULT_EMAIL_CONFIG: EmailConfig;
+//# sourceMappingURL=Email.d.ts.map

package/build/src/modeling/definitions/Email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Email.d.ts","sourceRoot":"","sources":["../../../../src/modeling/definitions/Email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;IAC7C;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,EAAE,EAAE,YAAY,CAAC,KAAK,CAAA;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,mBAAmB,KAAG,QAAQ,IAAI,oBAE3E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAQ,WAAgB,KAAG,oBAa9D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAA"}

package/build/src/modeling/definitions/Email.js

@@ -0,0 +1,33 @@
+import { SemanticType } from '../Semantics.js';
+/**
+ * Type guard to check if a semantic is an Email semantic.
+ */
+export const isEmailSemantic = (semantic) => {
+    return semantic.id === SemanticType.Email;
+};
+/**
+ * Helper function to create an Email semantic with configuration.
+ */
+export const createEmailSemantic = (config = {}) => {
+    const mergedConfig = {
+        ...DEFAULT_EMAIL_CONFIG,
+        ...config,
+    };
+    if (config.metadata) {
+        mergedConfig.metadata = { ...config.metadata };
+    }
+    return {
+        id: SemanticType.Email,
+        config: mergedConfig,
+    };
+};
+/**
+ * Default configuration for Email semantic.
+ */
+export const DEFAULT_EMAIL_CONFIG = {
+    requireVerification: false,
+    verificationMethod: 'email',
+    allowSubaddressing: true,
+    allowInternational: true,
+};
+//# sourceMappingURL=Email.js.map

package/build/src/modeling/definitions/Email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Email.js","sourceRoot":"","sources":["../../../../src/modeling/definitions/Email.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAuD9C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAA6B,EAAoC,EAAE;IACjG,OAAO,QAAQ,CAAC,EAAE,KAAK,YAAY,CAAC,KAAK,CAAA;AAC3C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAsB,EAAE,EAAwB,EAAE;IACpF,MAAM,YAAY,GAAG;QACnB,GAAG,oBAAoB;QACvB,GAAG,MAAM;KACV,CAAA;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAChD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,KAAK;QACtB,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,OAAO;IAC3B,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;CACzB,CAAA","sourcesContent":["import type { AppliedDataSemantic } from '../Semantics.js'\nimport { SemanticType } from '../Semantics.js'\n\n/**\n * Configuration options for the Email semantic.\n * Controls validation, allowed domains, and verification.\n */\nexport interface EmailConfig {\n  /**\n   * List of allowed email domains (e.g., ['example.com']).\n   */\n  allowedDomains?: string[]\n  /**\n   * Whether email verification is required.\n   */\n  requireVerification?: boolean\n  /**\n   * Method to use for verification: 'email', 'sms', or 'none'.\n   */\n  verificationMethod?: 'email' | 'sms' | 'none'\n  /**\n   * Whether to allow subaddressing (user+tag@domain.com).\n   */\n  allowSubaddressing?: boolean\n  /**\n   * Whether to allow internationalized email addresses.\n   *\n   * - When true (default): Allows email addresses with non-ASCII characters in the domain part,\n   *   like user@münchen.de or user@café.com\n   * - When false: Only allows ASCII characters in the domain part, like user@example.com\n   *\n   * Why it exists:\n   * - Internationalization: Many countries have domain names with native characters (like German umlauts,\n   *   French accents, etc.)\n   * - RFC 6531: The standard for internationalized email addresses\n   * - Validation flexibility: Some systems may need to restrict to ASCII-only domains for compatibility reasons\n   */\n  allowInternational?: boolean\n  /**\n   * Custom metadata for the email field.\n   */\n  metadata?: Record<string, unknown>\n  /**\n   * Index signature to allow additional properties.\n   */\n  [key: string]: unknown\n}\n\n/**\n * Type-safe configuration for Email semantic.\n */\nexport interface AppliedEmailSemantic extends AppliedDataSemantic {\n  id: SemanticType.Email\n  config?: EmailConfig\n}\n\n/**\n * Type guard to check if a semantic is an Email semantic.\n */\nexport const isEmailSemantic = (semantic: AppliedDataSemantic): semantic is AppliedEmailSemantic => {\n  return semantic.id === SemanticType.Email\n}\n\n/**\n * Helper function to create an Email semantic with configuration.\n */\nexport const createEmailSemantic = (config: EmailConfig = {}): AppliedEmailSemantic => {\n  const mergedConfig = {\n    ...DEFAULT_EMAIL_CONFIG,\n    ...config,\n  }\n  if (config.metadata) {\n    mergedConfig.metadata = { ...config.metadata }\n  }\n\n  return {\n    id: SemanticType.Email,\n    config: mergedConfig,\n  }\n}\n\n/**\n * Default configuration for Email semantic.\n */\nexport const DEFAULT_EMAIL_CONFIG: EmailConfig = {\n  requireVerification: false,\n  verificationMethod: 'email',\n  allowSubaddressing: true,\n  allowInternational: true,\n}\n"]}

package/build/src/modeling/definitions/GeospatialCoordinates.d.ts

@@ -0,0 +1,212 @@
+import type { AppliedDataSemantic } from '../Semantics.js';
+import { SemanticType } from '../Semantics.js';
+/**
+ * Supported coordinate formats for geospatial data.
+ */
+export declare enum GeospatialCoordinateFormat {
+    /**
+     * Latitude, Longitude format: "40.7128,-74.0060"
+     */
+    LatLon = "lat,lon",
+    /**
+     * Longitude, Latitude format: "-74.0060,40.7128"
+     */
+    LonLat = "lon,lat",
+    /**
+     * PostGIS POINT format: "POINT(-74.0060 40.7128)"
+     */
+    PostGIS = "postgis",
+    /**
+     * Degree format with cardinal directions: "40.7128°N, 74.0060°W"
+     */
+    Degree = "degree",
+    /**
+     * Well-Known Text (WKT) format: "POINT(-74.0060 40.7128)"
+     */
+    WKT = "wkt",
+    /**
+     * GeoJSON format: {"type": "Point", "coordinates": [-74.0060, 40.7128]}
+     */
+    GeoJSON = "geojson"
+}
+/**
+ * Supported distance units for spatial queries.
+ */
+export declare enum GeospatialDistanceUnit {
+    /**
+     * Meters (SI unit)
+     */
+    Meters = "meters",
+    /**
+     * Kilometers
+     */
+    Kilometers = "kilometers",
+    /**
+     * Miles (imperial)
+     */
+    Miles = "miles",
+    /**
+     * Feet (imperial)
+     */
+    Feet = "feet",
+    /**
+     * Yards (imperial)
+     */
+    Yards = "yards",
+    /**
+     * Nautical miles
+     */
+    NauticalMiles = "nautical_miles"
+}
+/**
+ * Supported spatial reference systems.
+ */
+export declare enum GeospatialSpatialReferenceSystem {
+    /**
+     * WGS84 (World Geodetic System 1984) - Most common for GPS coordinates
+     */
+    WGS84 = "EPSG:4326",
+    /**
+     * Web Mercator - Common for web mapping
+     */
+    WebMercator = "EPSG:3857",
+    /**
+     * NAD83 (North American Datum 1983)
+     */
+    NAD83 = "EPSG:4269",
+    /**
+     * NAD27 (North American Datum 1927)
+     */
+    NAD27 = "EPSG:4267"
+}
+/**
+ * Configuration options for the GeospatialCoordinates semantic.
+ * These options control how the runtime handles geospatial data and queries.
+ */
+export interface GeospatialCoordinatesConfig {
+    /**
+     * The coordinate format expected for input/output.
+     * Defaults to 'lat,lon' if not specified.
+     */
+    format?: GeospatialCoordinateFormat;
+    /**
+     * The spatial reference system (SRS) for the coordinates.
+     * Defaults to WGS84 (EPSG:4326) if not specified.
+     */
+    spatialReferenceSystem?: GeospatialSpatialReferenceSystem;
+    /**
+     * The default distance unit for spatial queries.
+     * Defaults to 'meters' if not specified.
+     */
+    defaultDistanceUnit?: GeospatialDistanceUnit;
+    /**
+     * Whether to enable automatic spatial indexing.
+     * Defaults to true if not specified.
+     */
+    enableSpatialIndexing?: boolean;
+    /**
+     * Whether to enable automatic coordinate validation.
+     * Defaults to true if not specified.
+     */
+    enableValidation?: boolean;
+    /**
+     * Custom validation rules for coordinate bounds.
+     * If not specified, uses standard latitude (-90 to 90) and longitude (-180 to 180) bounds.
+     */
+    validationBounds?: {
+        /**
+         * Minimum latitude value
+         */
+        minLatitude?: number;
+        /**
+         * Maximum latitude value
+         */
+        maxLatitude?: number;
+        /**
+         * Minimum longitude value
+         */
+        minLongitude?: number;
+        /**
+         * Maximum longitude value
+         */
+        maxLongitude?: number;
+    };
+    /**
+     * Whether to enable automatic PostGIS integration when using PostgreSQL.
+     * Defaults to true if not specified.
+     */
+    enablePostGISIntegration?: boolean;
+    /**
+     * The PostGIS geometry type to use for storage.
+     * Defaults to 'POINT' if not specified.
+     */
+    postGISGeometryType?: 'POINT' | 'LINESTRING' | 'POLYGON' | 'MULTIPOINT' | 'MULTILINESTRING' | 'MULTIPOLYGON';
+    /**
+     * Whether to enable distance-based query endpoints.
+     * Defaults to true if not specified.
+     */
+    enableDistanceQueries?: boolean;
+    /**
+     * Maximum distance allowed in distance queries (in the default distance unit).
+     * Defaults to 100000 (100km) if not specified.
+     */
+    maxQueryDistance?: number;
+    /**
+     * Whether to enable bounding box query endpoints.
+     * Defaults to true if not specified.
+     */
+    enableBoundingBoxQueries?: boolean;
+    /**
+     * Whether to enable polygon intersection query endpoints.
+     * Defaults to false if not specified.
+     */
+    enablePolygonQueries?: boolean;
+    /**
+     * Custom API endpoint prefix for geospatial queries.
+     * Defaults to '/nearby' if not specified.
+     */
+    apiEndpointPrefix?: string;
+    /**
+     * Whether to include elevation data in coordinates (3D coordinates).
+     * Defaults to false if not specified.
+     */
+    includeElevation?: boolean;
+    /**
+     * Precision for coordinate storage (number of decimal places).
+     * Defaults to 6 if not specified.
+     */
+    coordinatePrecision?: number;
+    /**
+     * Whether to enable reverse geocoding capabilities.
+     * Defaults to false if not specified.
+     */
+    enableReverseGeocoding?: boolean;
+    /**
+     * Custom metadata for the geospatial field.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Index signature to allow additional properties.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Type-safe configuration for GeospatialCoordinates semantic.
+ */
+export interface AppliedGeospatialCoordinatesSemantic extends AppliedDataSemantic {
+    id: SemanticType.GeospatialCoordinates;
+    config?: GeospatialCoordinatesConfig;
+}
+/**
+ * Type guard to check if a semantic is a GeospatialCoordinates semantic.
+ */
+export declare const isGeospatialCoordinatesSemantic: (semantic: AppliedDataSemantic) => semantic is AppliedGeospatialCoordinatesSemantic;
+/**
+ * Helper function to create a GeospatialCoordinates semantic with configuration.
+ */
+export declare const createGeospatialCoordinatesSemantic: (config?: GeospatialCoordinatesConfig) => AppliedGeospatialCoordinatesSemantic;
+/**
+ * Default configuration for GeospatialCoordinates semantic.
+ */
+export declare const DEFAULT_GEOSPATIAL_CONFIG: GeospatialCoordinatesConfig;
+//# sourceMappingURL=GeospatialCoordinates.d.ts.map

package/build/src/modeling/definitions/GeospatialCoordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeospatialCoordinates.d.ts","sourceRoot":"","sources":["../../../../src/modeling/definitions/GeospatialCoordinates.ts"],"names":[],"mappings":"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"}