npm - @wildo-ai/saas-models - Versions diffs - 1.0.1 → 1.1.1 - Mend

@wildo-ai/saas-models 1.0.1 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1282) hide show

package/dist/esm/resources/resources-relationships.shared.factory.js CHANGED Viewed

@@ -12,6 +12,7 @@ function createConfigurationError(message) {
     error.type = ErrorType.CONFIGURATION;
     return error;
 }
+/** @wildo_source:part:end saas.models.resource-relationship-builder-parameters */
 /**
  * Create a resource relationship declaration between two resource types.
  *
@@ -53,12 +54,16 @@ function createConfigurationError(message) {
  * For `MANY <-> MANY`, the declaration is still authored at the association level:
  * developers declare the two peer entity types plus `jointResourceType`.
  *
- * The framework may later decompose that association into synthetic
+ * The framework may later decompose non-self associations into synthetic
  * entity->junction and junction->entity edges for DTO, routing, and runtime
  * processing, but that decomposition is an internal implementation detail.
  * App-facing meaning should stay association-centric, not "manually declare the
  * synthetic edges yourself."
  *
+ * Self-referencing M:N is the exception: one declaration cannot carry two
+ * distinct source/target FK identities for the same resource type. Model it with
+ * explicit junction-resource relationships instead.
+ *
  * ## Semantic Resolution Order
  *
  * Relationship declarations now have an explicit semantic precedence:
@@ -104,19 +109,44 @@ export function createResourcesRelationship(resourceType1, resourceType2, cardin
     // ========================================
     // VALIDATION GUARDS
     // ========================================
-    // Guard 1: Primary scope cannot be OPTIONAL_CONTEXT or STANDALONE
-    // Primary scope MUST always be present in URL paths - it's the root of the hierarchy
-    if (options?.isPrimaryScope && options?.accessScopeStrategy) {
-        if (options.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT) {
-            throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
-                `Primary scope cannot have accessScopeStrategy=OPTIONAL_CONTEXT.\n` +
-                `Primary scope resources MUST always be present in URL paths.`);
-        }
-        if (options.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.STANDALONE) {
-            throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
-                `Primary scope cannot have accessScopeStrategy=STANDALONE.\n` +
-                `Primary scope resources MUST always be present in URL paths.`);
-        }
+    // Guard 1: `isPrimaryScope` cannot be paired with `OPTIONAL_CONTEXT`.
+    //
+    // ## Why this guard exists (and why it only forbids OPTIONAL_CONTEXT, not STANDALONE)
+    //
+    // `isPrimaryScope` and `accessScopeStrategy` govern two ORTHOGONAL concerns:
+    //
+    // - `isPrimaryScope`        — ownership graph anchor: "this parent is the
+    //                             row's structural scope root". Drives the
+    //                             resource's `resourcePrimaryScope` enum, which
+    //                             in turn drives scope-aware services (auth,
+    //                             notifications, execution context, etc).
+    // - `accessScopeStrategy`   — URL routing + fetch-time context gating.
+    //                             STANDALONE  → no URL segment, no context gate
+    //                             REQUIRES_CONTEXT → mandatory URL segment + gate
+    //                             OPTIONAL_CONTEXT → optional URL segment
+    //
+    // The two concerns are already orthogonalized in the URL builder
+    // (`generateParentCombinations` filters out STANDALONE parents *before*
+    // bucketing the rest by `isPrimaryScope`), so a `STANDALONE + isPrimaryScope`
+    // rel is URL-inert by construction — it contributes zero path segments and
+    // simply anchors the scope enum. That is a coherent, intended configuration
+    // (e.g. internal ledgers like `jobExecutions` that are APP-scoped but not
+    // routed under `/applications/:id/…`, user-owned credential stores that are
+    // USER_SELF-scoped but not exposed as routable child resources).
+    //
+    // `OPTIONAL_CONTEXT + isPrimaryScope` is however INCOHERENT under the current
+    // combinator: `generateParentCombinations` puts every `isPrimaryScope` edge
+    // into the always-on bucket, which would force an "optional" primary parent
+    // to appear in every URL combination — contradicting its optionality. That
+    // redesign is out of scope here; until then the guard remains.
+    if (options?.isPrimaryScope &&
+        options?.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT) {
+        throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
+            `Primary scope cannot have accessScopeStrategy=OPTIONAL_CONTEXT.\n` +
+            `A primary-scope rel marks the structural ownership anchor; OPTIONAL_CONTEXT\n` +
+            `would make the anchor optional in URLs, which the current URL combinator\n` +
+            `cannot express coherently. Use REQUIRES_CONTEXT (routed anchor) or\n` +
+            `STANDALONE (logical anchor, not routed).`);
     }
     // Guard 2: MANY-to-MANY requires jointResourceType (junction table)
     if (cardinality1 === ResourceRelationshipCardinality.MANY &&
@@ -125,15 +155,23 @@ export function createResourcesRelationship(resourceType1, resourceType2, cardin
         throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
             `MANY-to-MANY relationships require a jointResourceType (junction table).`);
     }
+    if (cardinality1 === ResourceRelationshipCardinality.MANY &&
+        cardinality2 === ResourceRelationshipCardinality.MANY &&
+        options?.jointResourceType &&
+        resourceType1 === resourceType2) {
+        throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
+            `Self-referencing MANY-to-MANY relationships cannot be authored as one association declaration.\n` +
+            `Declare explicit junction-resource relationships so source and target edge identity stay explicit.`);
+    }
     // Note: foreignKeyField IS valid with isPrimaryScope - it specifies the FK field on the child
     // resource that points back to the parent, which is useful for 1:1 relationships
-    // Guard 3: jointResourceType should not be combined with foreignKeyField for non-self-referencing
-    // EXCEPTION: Self-referencing many-to-many relationships use foreignKeyField to distinguish source/target
+    // Guard 3: jointResourceType should not be combined with foreignKeyField.
+    // Self-referencing many-to-many is rejected above because a single
+    // declaration cannot encode two FK identities for the same peer resource.
     if (options?.jointResourceType && options?.foreignKeyField && resourceType1 !== resourceType2) {
         throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
             `Cannot combine jointResourceType and foreignKeyField for non-self-referencing M:N.\n` +
-            `Use jointResourceType for MANY-to-MANY via junction table.\n` +
-            `(Exception: self-referencing relationships may use foreignKeyField to distinguish source/target)`);
+            `Use jointResourceType for MANY-to-MANY via junction table.`);
     }
     // Guard 5: foreignKeyField must end with 'Id' or 'Ids' (reserved for FK naming convention)
     if (options?.foreignKeyField) {
@@ -147,8 +185,8 @@ export function createResourcesRelationship(resourceType1, resourceType2, cardin
     // Guard 6: Self-referencing 1:N/1:1 relationships require explicit foreignKeyField.
     // Without it, the default FK (derived from resourceFieldIdentifier) would collide with
     // itself in URL param generation — e.g., /resource/{resourceId}/resource/{resourceId}.
-    // M:N self-refs are exempt: they go through M:N decomposition which creates distinct
-    // synthetic relationships with their own FK fields.
+    // M:N self-refs are rejected above: one declaration cannot encode distinct
+    // source/target FK identities for the same peer resource.
     if (resourceType1 === resourceType2 && !options?.jointResourceType) {
         if (!options?.foreignKeyField) {
             throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
@@ -209,11 +247,23 @@ export function createResourcesRelationship(resourceType1, resourceType2, cardin
     else {
         accessScopeStrategy = options.accessScopeStrategy;
     }
+    // Post-default-resolution check: `isPrimaryScope` must resolve to REQUIRES_CONTEXT
+    // or STANDALONE, never OPTIONAL_CONTEXT. See Guard 1 above for the full
+    // rationale (ownership graph vs URL routing are orthogonal, except for the
+    // OPTIONAL_CONTEXT incoherence).
+    //
+    // This second gate exists because `accessScopeStrategy` may be filled in by
+    // the DEFAULTS block above (lines 332-340) rather than authored explicitly.
+    // Guard 1 only fires on explicit authoring; this one catches the defaulted
+    // case where `parentResourceRequirement=OPTIONAL` silently resolves to
+    // `OPTIONAL_CONTEXT`.
     if (options?.isPrimaryScope &&
-        accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT) {
+        accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT) {
         throw createConfigurationError(`Invalid relationship configuration: ${resourceType1} → ${resourceType2}\n` +
-            `Primary scope relationships must resolve to accessScopeStrategy=REQUIRES_CONTEXT.\n` +
-            `Primary scope resources MUST always be present in URL paths.`);
+            `Primary scope rel defaulted to accessScopeStrategy=OPTIONAL_CONTEXT\n` +
+            `(triggered by parentResourceRequirement=OPTIONAL without explicit strategy).\n` +
+            `Declare accessScopeStrategy=REQUIRES_CONTEXT (routed anchor) or STANDALONE\n` +
+            `(logical anchor, not routed) explicitly.`);
     }
     // Parse childOperations and display to apply defaults and convert to parsed types
     const parsedChildOperations = options?.childOperations
@@ -250,7 +300,9 @@ export function createResourcesRelationship(resourceType1, resourceType2, cardin
         display: parsedDisplay,
         // Foreign key field for disambiguation or non-standard naming
         foreignKeyField: options?.foreignKeyField,
+        // Write-time scope-membership constraint (opt-in; enforced on CREATE/UPDATE by write-integrity)
+        scopeMembership: options?.scopeMembership,
     };
     return Resources_SharedUtils.compileRelationshipDeclaration(relationshipDeclaration);
 }
-//# sourceMappingURL=resources-relationships.shared.factory.js.map
+//# sourceMappingURL=resources-relationships.shared.factory.js.map

package/dist/esm/resources/resources-relationships.shared.factory.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resources-relationships.shared.factory.js","sourceRoot":"","sources":["../../../src/resources/resources-relationships.shared.factory.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"resources-relationships.shared.factory.js","sourceRoot":"","sources":["../../../../src/resources/resources-relationships.shared.factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { CoreResourceType, ResourceType } from \"./resources.shared.core.definitions\";\nimport {\n RelationshipNature,\n type RelationshipHandlingReadSettings,\n ResourceParentResourceRequirement,\n ResourcePrimaryScope,\n ResourceRelationship,\n ResourceRelationshipDeclaration,\n ResourceRelationshipAccessScopeStrategy,\n ResourceRelationshipCardinality,\n ResourceRelationshipConditionFn,\n type ScopeMembership,\n} from \"./resources.shared.schemas\";\nimport { ErrorType } from \"../errors/errors.shared.schemas\";\nimport { RelationshipContextPolicy } from \"./context-policy.shared.schemas\";\nimport { ChildOperationsConfig, ChildOperationsConfigSchema, ResourceRelationshipDiscriminator } from \"./child-operations.shared.schemas\";\nimport { RelationshipDisplayConfig, RelationshipDisplayConfigSchema } from \"./relationship-display.shared.schemas\";\nimport { Resources_SharedUtils } from \"./resources.shared.utils\";\n\n/*\n Creates a configuration error with ErrorType.CONFIGURATION\n /\nfunction createConfigurationError(message: string): Error {\n const error = new Error(message);\n (error as any).type = ErrorType.CONFIGURATION;\n return error;\n}\n\n/\n @wildo_source:part:start saas.models.resource-relationship-builder-parameters facet:layer:shared facet:family:resource-config\n \n Parameters accepted by `createResourcesRelationship()` (app registry authoring).\n /\nexport type ResourceRelationship_BuilderParameters = {\n isDisabled? : boolean,\n isPrimaryScope? : boolean,\n parentResourceRequirement? : ResourceParentResourceRequirement,\n accessScopeStrategy? : ResourceRelationshipAccessScopeStrategy,\n jointResourceType?: ResourceType,\n /\n Opt-in flag for relationships that form cycles in the resource graph.\n * Required on every edge in a cycle for schema-level validation to pass.\n * @see ResourceRelationshipSchema.allowCycle\n /\n allowCycle?: boolean,\n /* Context policy for this relationship - controls how related resources are fetched /\n contextPolicy?: RelationshipContextPolicy,\n /\n High-level shared meaning of the relationship.\n \n This is the primary semantic field app developers should author. The\n * framework derives the deeper internal handling contract from it plus the\n * optional explicit read intent when present.\n /\n nature: RelationshipNature,\n /\n Optional explicit semantic read intent.\n \n This does not replace `childOperations.nested.onRead`; it only declares the\n * semantic read model the framework should resolve.\n /\n read?: RelationshipHandlingReadSettings,\n /\n Child operations configuration for this relationship.\n * Handles BACKEND concerns: lifecycle cascade and nested DTO aggregation.\n /\n childOperations?: ChildOperationsConfig,\n /\n Static discriminator filter for conditional relationships.\n * When specified, this relationship only applies when the parent resource's\n * discriminator field matches one of the specified values.\n /\n discriminator?: ResourceRelationshipDiscriminator,\n /\n Function-based condition for conditional relationships.\n * Evaluated at runtime with the parent resource data.\n * Unlike the static `discriminator`, this allows arbitrary logic.\n /\n condition?: ResourceRelationshipConditionFn,\n /\n Frontend display configuration for this relationship.\n * Defines how related resources are displayed in the UI.\n /\n display?: RelationshipDisplayConfig,\n /\n Foreign key field name for this relationship.\n \n When omitted: Inferred from parent's resourceFieldIdentifier via allResourceFieldIdentifiers map.\n * When specified: Used for disambiguation when multiple FKs point to same resource type,\n * or when FK field name differs from standard naming convention.\n \n Examples:\n * - Standard: ORGANIZATIONS → TODOS uses organizationId (inferred, no foreignKeyField needed)\n * - Disambiguation: TODOS → USERS via assignedToUserId vs createdByUserId (explicit)\n * - Self-referencing M:N is not expressed as one relationship declaration;\n * declare two explicit junction-resource edges so source and target FK\n * identities remain distinct.\n /\n foreignKeyField?: string,\n /\n Write-time SCOPE CONFINEMENT for a REFERENCE foreign key: the referenced target must be linked to\n * the writing row's scope through a junction, enforced on CREATE and UPDATE. Opt-in and additive —\n * omit for unchanged behavior.\n \n STRUCTURE only. `scopeMembership: true` is the simple case (junction auto-resolved from the M:N\n * scope-junction map); the object form names the junction / its columns when convention cannot — a\n * SELF-REFERENTIAL junction (organizations ↔ organizations). Per-variant POLICY (status, roles, typed\n * junction rows) is declared on the operation config's `referenceConstraints`.\n \n @example todos.assignedToUserId must be a member of the row's organization:\n * { nature: RelationshipNature.REFERENCE, foreignKeyField: 'assignedToUserId', scopeMembership: true }\n \n @example todos.sharedWithOrganizationId must be a partner of the row's organization:\n * { nature: RelationshipNature.REFERENCE, foreignKeyField: 'sharedWithOrganizationId',\n * scopeMembership: { junction: CoreResourceType.ORGANIZATION_PARTNERSHIPS } }\n /\n scopeMembership?: ScopeMembership,\n};\n/* @wildo_source:part:end saas.models.resource-relationship-builder-parameters /\n\n\n\n/\n Create a resource relationship declaration between two resource types.\n \n This is the primary entry point for declaring relationships in the resource registry.\n * Returns a `ResourceRelationship` object that is spread into the registry's relationship\n * array and later categorized by `transformResourceRelationships()` at factory time.\n \n ## Conditional Relationships\n \n Relationships can optionally carry runtime conditions via `discriminator` and/or `condition`:\n \n - `discriminator` (static): A simple `{ discriminatorField, values }` object.\n * The relationship is active only when `String(parent[discriminatorField])` is in `values`.\n * Useful for discriminated union patterns (e.g., recurring vs. one-time todos).\n \n - `condition` (dynamic): An arbitrary `(parentResource) => boolean` function.\n * Allows cross-field logic, computed checks, etc. Cannot be serialized to Zod.\n \n When both are provided, AND semantics apply — both must pass for the relationship\n * to be active at runtime.\n \n These conditions are NOT evaluated at startup/factory time. They are stored inline\n * on the relationship object and evaluated at runtime by:\n * - `ResourceContextBackendService.fetchChildResourcesWithPolicy()` — backend context building\n * - `ServicesRegistryHandler.filterRelationshipsByParent()` — nested CRUD + lifecycle\n * - `ResourceLayout_ContainerNested` — frontend display filtering\n \n @param resourceType1 - The parent resource type in 1:N/1:1, or the first entity side in M:N\n * @param resourceType2 - The child resource type in 1:N/1:1, or the second entity side in M:N\n * @param cardinality1 - Cardinality from the perspective of resourceType1\n * @param cardinality2 - Cardinality from the perspective of resourceType2\n * @param options - Required relationship options; must include `nature`.\n * Other relationship fields remain optional as needed (discriminator,\n * condition, childOperations, display, etc.)\n * @returns A fully constructed `ResourceRelationship` object\n \n ## M:N developer mental model\n \n For `MANY <-> MANY`, the declaration is still authored at the association level:\n * developers declare the two peer entity types plus `jointResourceType`.\n \n The framework may later decompose non-self associations into synthetic\n * entity->junction and junction->entity edges for DTO, routing, and runtime\n * processing, but that decomposition is an internal implementation detail.\n * App-facing meaning should stay association-centric, not \"manually declare the\n * synthetic edges yourself.\"\n \n Self-referencing M:N is the exception: one declaration cannot carry two\n * distinct source/target FK identities for the same resource type. Model it with\n * explicit junction-resource relationships instead.\n \n ## Semantic Resolution Order\n \n Relationship declarations now have an explicit semantic precedence:\n \n 1. structural topology (`cardinality`, `jointResourceType`, `foreignKeyField`, ...)\n 2. `nature`\n * 3. explicit semantic read intent (`read`) when authored\n * 4. derived handling contract (future resolver step, internal)\n * 5. current low-level operational projection (`childOperations`)\n \n `nature` is therefore the primary semantic declaration for app developers.\n * The fuller handling contract belongs to framework internals, not the authored\n * relationship API.\n \n ## Greenfield Direction\n \n Relationship declarations must define explicit `nature`. Missing annotations\n * are configuration bugs, not a compatibility target.\n \n @example Static discriminator (recurring todos → occurrences)\n * ```typescript\n * createResourcesRelationship(TODOS, RECURRING_OCCURRENCES, ONE, MANY, {\n * nature: RelationshipNature.COMPOSITION,\n * discriminator: { discriminatorField: 'recurringType', values: ['RECURRING'] },\n * childOperations: { lifecycle: { onParentDelete: { enabled: true } } },\n * })\n * ```\n \n @example Function-based condition\n * ```typescript\n * createResourcesRelationship(ORDERS, REFUND_RECORDS, ONE, MANY, {\n * nature: RelationshipNature.COMPOSITION,\n * condition: (parent) => parent.status === 'COMPLETED' && parent.totalAmount > 0,\n * })\n * ```\n /\nexport function createResourcesRelationship(\n resourceType1: ResourceType, \n resourceType2: ResourceType, \n cardinality1: ResourceRelationshipCardinality, \n cardinality2: ResourceRelationshipCardinality, \n options: ResourceRelationship_BuilderParameters\n ) : ResourceRelationship {\n\n if (!options?.nature) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Relationship declarations must define nature explicitly.\\n` +\n `Greenfield relationship semantics no longer infer meaning from childOperations or jointResourceType.`\n );\n }\n \n // ========================================\n // VALIDATION GUARDS\n // ========================================\n\n // Guard 1: `isPrimaryScope` cannot be paired with `OPTIONAL_CONTEXT`.\n //\n // ## Why this guard exists (and why it only forbids OPTIONAL_CONTEXT, not STANDALONE)\n //\n // `isPrimaryScope` and `accessScopeStrategy` govern two ORTHOGONAL concerns:\n //\n // - `isPrimaryScope` — ownership graph anchor: \"this parent is the\n // row's structural scope root\". Drives the\n // resource's `resourcePrimaryScope` enum, which\n // in turn drives scope-aware services (auth,\n // notifications, execution context, etc).\n // - `accessScopeStrategy` — URL routing + fetch-time context gating.\n // STANDALONE → no URL segment, no context gate\n // REQUIRES_CONTEXT → mandatory URL segment + gate\n // OPTIONAL_CONTEXT → optional URL segment\n //\n // The two concerns are already orthogonalized in the URL builder\n // (`generateParentCombinations` filters out STANDALONE parents before*\n // bucketing the rest by `isPrimaryScope`), so a `STANDALONE + isPrimaryScope`\n // rel is URL-inert by construction — it contributes zero path segments and\n // simply anchors the scope enum. That is a coherent, intended configuration\n // (e.g. internal ledgers like `jobExecutions` that are APP-scoped but not\n // routed under `/applications/:id/…`, user-owned credential stores that are\n // USER_SELF-scoped but not exposed as routable child resources).\n //\n // `OPTIONAL_CONTEXT + isPrimaryScope` is however INCOHERENT under the current\n // combinator: `generateParentCombinations` puts every `isPrimaryScope` edge\n // into the always-on bucket, which would force an \"optional\" primary parent\n // to appear in every URL combination — contradicting its optionality. That\n // redesign is out of scope here; until then the guard remains.\n if (options?.isPrimaryScope &&\n options?.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Primary scope cannot have accessScopeStrategy=OPTIONAL_CONTEXT.\\n` +\n `A primary-scope rel marks the structural ownership anchor; OPTIONAL_CONTEXT\\n` +\n `would make the anchor optional in URLs, which the current URL combinator\\n` +\n `cannot express coherently. Use REQUIRES_CONTEXT (routed anchor) or\\n` +\n `STANDALONE (logical anchor, not routed).`\n );\n }\n \n // Guard 2: MANY-to-MANY requires jointResourceType (junction table)\n if (cardinality1 === ResourceRelationshipCardinality.MANY && \n cardinality2 === ResourceRelationshipCardinality.MANY &&\n !options?.jointResourceType) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `MANY-to-MANY relationships require a jointResourceType (junction table).`\n );\n }\n\n if (\n cardinality1 === ResourceRelationshipCardinality.MANY &&\n cardinality2 === ResourceRelationshipCardinality.MANY &&\n options?.jointResourceType &&\n resourceType1 === resourceType2\n ) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Self-referencing MANY-to-MANY relationships cannot be authored as one association declaration.\\n` +\n `Declare explicit junction-resource relationships so source and target edge identity stay explicit.`\n );\n }\n \n // Note: foreignKeyField IS valid with isPrimaryScope - it specifies the FK field on the child\n // resource that points back to the parent, which is useful for 1:1 relationships\n \n // Guard 3: jointResourceType should not be combined with foreignKeyField.\n // Self-referencing many-to-many is rejected above because a single\n // declaration cannot encode two FK identities for the same peer resource.\n if (options?.jointResourceType && options?.foreignKeyField && resourceType1 !== resourceType2) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Cannot combine jointResourceType and foreignKeyField for non-self-referencing M:N.\\n` +\n `Use jointResourceType for MANY-to-MANY via junction table.`\n );\n }\n \n // Guard 5: foreignKeyField must end with 'Id' or 'Ids' (reserved for FK naming convention)\n if (options?.foreignKeyField) {\n const fkField = options.foreignKeyField;\n if (!fkField.endsWith('Id') && !fkField.endsWith('Ids')) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `foreignKeyField \"${fkField}\" must end with 'Id' or 'Ids' (e.g., assignedToUserId, memberIds).\\n` +\n `This naming convention is reserved for foreign key fields.`\n );\n }\n }\n \n // Guard 6: Self-referencing 1:N/1:1 relationships require explicit foreignKeyField.\n // Without it, the default FK (derived from resourceFieldIdentifier) would collide with\n // itself in URL param generation — e.g., /resource/{resourceId}/resource/{resourceId}.\n // M:N self-refs are rejected above: one declaration cannot encode distinct\n // source/target FK identities for the same peer resource.\n if (resourceType1 === resourceType2 && !options?.jointResourceType) {\n if (!options?.foreignKeyField) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Self-referencing 1:N/1:1 relationships MUST specify foreignKeyField explicitly.\\n` +\n `Without it, URL parameter names collide (same resource type on both sides).`\n );\n }\n\n // Guard 7: Self-referencing 1:N/1:1 relationships must have OPTIONAL parent requirement.\n // Tree roots have no parent — MANDATORY would make root-level access impossible.\n const effectiveParentReq = options?.parentResourceRequirement \|\| ResourceParentResourceRequirement.MANDATORY;\n if (effectiveParentReq === ResourceParentResourceRequirement.MANDATORY) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Self-referencing 1:N/1:1 relationships MUST have parentResourceRequirement=OPTIONAL.\\n` +\n `Tree/graph roots have no parent — MANDATORY would make root-level access impossible.`\n );\n }\n }\n\n // Guard 8: junction-backed relationships are association semantics when nature is explicit.\n if (options?.jointResourceType && options?.nature && options.nature !== RelationshipNature.ASSOCIATION) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Relationships with jointResourceType must declare nature=ASSOCIATION.\\n` +\n `Junction-backed relationships are association-centric in the shared model.`\n );\n }\n\n // Guard 9: explicit association semantics require a junction resource.\n if (options?.nature === RelationshipNature.ASSOCIATION && !options?.jointResourceType) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `nature=ASSOCIATION requires jointResourceType.\\n` +\n `Association semantics are reserved for explicit link-management / junction-backed relationships.`\n );\n }\n \n // ========================================\n // PRIMARY SCOPE MAPPING\n // ========================================\n \n let primaryScope : ResourcePrimaryScope \| undefined;\n if (options?.isPrimaryScope) {\n \n const primaryScopeMap = {\n [CoreResourceType.ORGANIZATIONS]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.USERS]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.USER_SELF]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.APPLICATION]: ResourcePrimaryScope.APPLICATION,\n [CoreResourceType.ANONYMOUS_USERS]: ResourcePrimaryScope.ANONYMOUS,\n }\n primaryScope = primaryScopeMap[resourceType1 as CoreResourceType];\n \n if (!primaryScope) {\n throw createConfigurationError(`Resource type ${resourceType1} is not related to a primary scope`);\n }\n }\n \n // ========================================\n // ACCESS SCOPE STRATEGY DEFAULTS\n // ========================================\n\n const parentResourceRequirement = options?.parentResourceRequirement \|\| ResourceParentResourceRequirement.MANDATORY;\n let accessScopeStrategy = ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT;\n\n if (!options?.accessScopeStrategy) {\n if (parentResourceRequirement === ResourceParentResourceRequirement.MANDATORY) {\n accessScopeStrategy = ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT;\n } else {\n accessScopeStrategy = ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT;\n }\n } else {\n accessScopeStrategy = options.accessScopeStrategy;\n }\n\n // Post-default-resolution check: `isPrimaryScope` must resolve to REQUIRES_CONTEXT\n // or STANDALONE, never OPTIONAL_CONTEXT. See Guard 1 above for the full\n // rationale (ownership graph vs URL routing are orthogonal, except for the\n // OPTIONAL_CONTEXT incoherence).\n //\n // This second gate exists because `accessScopeStrategy` may be filled in by\n // the DEFAULTS block above (lines 332-340) rather than authored explicitly.\n // Guard 1 only fires on explicit authoring; this one catches the defaulted\n // case where `parentResourceRequirement=OPTIONAL` silently resolves to\n // `OPTIONAL_CONTEXT`.\n if (options?.isPrimaryScope &&\n accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT) {\n throw createConfigurationError(\n `Invalid relationship configuration: ${resourceType1} → ${resourceType2}\\n` +\n `Primary scope rel defaulted to accessScopeStrategy=OPTIONAL_CONTEXT\\n` +\n `(triggered by parentResourceRequirement=OPTIONAL without explicit strategy).\\n` +\n `Declare accessScopeStrategy=REQUIRES_CONTEXT (routed anchor) or STANDALONE\\n` +\n `(logical anchor, not routed) explicitly.`\n );\n }\n \n // Parse childOperations and display to apply defaults and convert to parsed types\n const parsedChildOperations = options?.childOperations \n ? ChildOperationsConfigSchema.parse(options.childOperations)\n : undefined;\n \n const parsedDisplay = options?.display\n ? RelationshipDisplayConfigSchema.parse(options.display)\n : undefined;\n\n const relationshipDeclaration: ResourceRelationshipDeclaration = {\n cardinality1,\n cardinality2,\n resourceType1,\n resourceType2,\n accessScopeStrategy,\n parentResourceRequirement,\n isPrimaryScope: options?.isPrimaryScope \|\| false,\n primaryScope,\n jointResourceType: options?.jointResourceType \|\| undefined,\n allowCycle: options?.allowCycle \|\| false,\n isDisabled: options?.isDisabled \|\| false,\n // Context policy for relationship traversal\n contextPolicy: options?.contextPolicy,\n // High-level shared semantic meaning authored by app developers.\n nature: options.nature,\n // Optional explicit semantic read intent authored by app developers.\n read: options?.read,\n // Child operations configuration (lifecycle + nested DTOs) - parsed to apply defaults\n childOperations: parsedChildOperations,\n // Static discriminator filter for conditional relationships\n discriminator: options?.discriminator,\n // Function-based condition for conditional relationships\n condition: options?.condition,\n // Frontend display configuration - parsed to apply defaults\n display: parsedDisplay,\n // Foreign key field for disambiguation or non-standard naming\n foreignKeyField: options?.foreignKeyField,\n // Write-time scope-membership constraint (opt-in; enforced on CREATE/UPDATE by write-integrity)\n scopeMembership: options?.scopeMembership,\n };\n\n return Resources_SharedUtils.compileRelationshipDeclaration(relationshipDeclaration);\n }\n"]}

package/dist/esm/resources/resources-serialization.shared.schemas.d.ts CHANGED Viewed

@@ -1,12 +1,12 @@
 import { z } from 'zod';
-import { ResourceConfiguration_Operation, AnyResourceConfiguration, ResourcesRegistry } from './resources-config.shared.schemas.js';
+import { ResourceConfiguration_Operation, AnyResourceConfiguration, ResourcesRegistry } from './resources-config.shared.schemas';
 import { SerializableZodSchema } from '@wildo-ai/zod-decorators';
 export declare const FunctionKindSchema: z.ZodEnum<any>;
 export type FunctionKind = z.infer<typeof FunctionKindSchema>;
 export declare const SourceAnchorsSchema: z.ZodObject<{
     pre: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     post: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type SourceAnchors = z.infer<typeof SourceAnchorsSchema>;
 export declare const SourceRefSchema: z.ZodObject<{
     filePath: z.ZodString;
@@ -18,13 +18,13 @@ export declare const SourceRefSchema: z.ZodObject<{
     anchors: z.ZodOptional<z.ZodObject<{
         pre: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         post: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type SourceRef = z.infer<typeof SourceRefSchema>;
 export declare const FunctionParameterSchema: z.ZodObject<{
     name: z.ZodString;
     type: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type FunctionParameter = z.infer<typeof FunctionParameterSchema>;
 export declare const FunctionDescriptorSchema: z.ZodObject<{
     functionId: z.ZodString;
@@ -37,7 +37,7 @@ export declare const FunctionDescriptorSchema: z.ZodObject<{
     parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip>>>;
     returnType: z.ZodOptional<z.ZodString>;
     sourceTextTs: z.ZodOptional<z.ZodString>;
     sourceRef: z.ZodOptional<z.ZodObject<{
@@ -50,11 +50,11 @@ export declare const FunctionDescriptorSchema: z.ZodObject<{
         anchors: z.ZodOptional<z.ZodObject<{
             pre: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
             post: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     imports: z.ZodOptional<z.ZodArray<z.ZodString>>;
     diagnostics: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type FunctionDescriptor = z.infer<typeof FunctionDescriptorSchema>;
 export declare const OperationFunctionsSchema: z.ZodObject<{
     functions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -68,7 +68,7 @@ export declare const OperationFunctionsSchema: z.ZodObject<{
         parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
+        }, z.core.$strip>>>;
         returnType: z.ZodOptional<z.ZodString>;
         sourceTextTs: z.ZodOptional<z.ZodString>;
         sourceRef: z.ZodOptional<z.ZodObject<{
@@ -81,12 +81,12 @@ export declare const OperationFunctionsSchema: z.ZodObject<{
             anchors: z.ZodOptional<z.ZodObject<{
                 pre: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
                 post: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         imports: z.ZodOptional<z.ZodArray<z.ZodString>>;
         diagnostics: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export type OperationFunctions = z.infer<typeof OperationFunctionsSchema>;
 export declare const ResourceFunctionsSchema: z.ZodObject<{
     functions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -100,7 +100,7 @@ export declare const ResourceFunctionsSchema: z.ZodObject<{
         parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
+        }, z.core.$strip>>>;
         returnType: z.ZodOptional<z.ZodString>;
         sourceTextTs: z.ZodOptional<z.ZodString>;
         sourceRef: z.ZodOptional<z.ZodObject<{
@@ -113,12 +113,12 @@ export declare const ResourceFunctionsSchema: z.ZodObject<{
             anchors: z.ZodOptional<z.ZodObject<{
                 pre: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
                 post: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         imports: z.ZodOptional<z.ZodArray<z.ZodString>>;
         diagnostics: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export type ResourceFunctions = z.infer<typeof ResourceFunctionsSchema>;
 /**
  * Deserialize a SerializableZodSchema back into a Zod schema.

package/dist/esm/resources/resources-serialization.shared.schemas.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resources-serialization.shared.schemas.d.ts","sourceRoot":"","sources":["~~../../../~~src/resources/resources-serialization.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,+BAA+B,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACjI,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAK5C,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,mBAAmB;;;~~uCAGpB~~,CAAC;AAGb,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;;;;~~uCAQ1B~~,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,uBAAuB;;;~~uCAGlC~~,CAAC;AAGH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~uCAsBnC~~,CAAC;AAGH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~uCAGnC~~,CAAC;AAGH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~uCAElC~~,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAKxE;;;;;;;;GAQG;AAEH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,+BAA+B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC9C,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,kBAAkB,GAAG,sBAAsB,CAC1F,GAAG;IACF,UAAU,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3C,UAAU,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAE1C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,wBAAwB,EACxB,YAAY,GAAG,YAAY,CAC5B,GAAG;IACF,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC1C,wBAAwB,CAAC,EAAE,MAAM,EAAE,GAAG;QAAE,WAAW,EAAE,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,4BAA4B,EAAE,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;IAChF,qCAAqC,EAAE,iBAAiB,CAAC,uCAAuC,CAAC,CAAC;IAClG,qBAAqB,EAAE,iBAAiB,CAAC,uBAAuB,CAAC,CAAC;IAClE,sBAAsB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,iCAAiC,CAAA;KAAE,CAAC;CAC9E,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,CAAC,YAAY,EAAE,MAAM,GAAG,yBAAyB,CAAC;CACnD,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2FAA2F;IAC3F,IAAI,EAAE,GAAG,CAAC;IACV,gBAAgB,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC"}
1	+ {"version":3,"file":"resources-serialization.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/resources/resources-serialization.shared.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/resources/resources-serialization.shared.schemas.js CHANGED Viewed

@@ -50,4 +50,4 @@ export const OperationFunctionsSchema = z.object({
 export const ResourceFunctionsSchema = z.object({
     functions: z.array(FunctionDescriptorSchema).default([]),
 });
-//# sourceMappingURL=resources-serialization.shared.schemas.js.map
+//# sourceMappingURL=resources-serialization.shared.schemas.js.map

package/dist/esm/resources/resources-serialization.shared.schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resources-serialization.shared.schemas.js","sourceRoot":"","sources":["~~../../../~~src/resources/resources-serialization.shared.schemas.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"resources-serialization.shared.schemas.js","sourceRoot":"","sources":["../../../../src/resources/resources-serialization.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { ResourceConfiguration_Operation, AnyResourceConfiguration, ResourcesRegistry } from './resources-config.shared.schemas';\nimport { SerializableZodSchema } from '@wildo-ai/zod-decorators';\n\n// Generic function kinds; keep extensible for future additions\nexport const FunctionKindSchema: z.ZodEnum<any> = z.enum([\n 'ENABLED_CONDITION',\n 'BASIC_PREFIX_OPERATION',\n 'FRONTEND_LABEL',\n 'CUSTOM',\n]);\nexport type FunctionKind = z.infer<typeof FunctionKindSchema>;\n\nexport const SourceAnchorsSchema = z.object({\n pre: z.array(z.string()).optional(),\n post: z.array(z.string()).optional(),\n}).partial();\n\n\nexport type SourceAnchors = z.infer<typeof SourceAnchorsSchema>;\n\nexport const SourceRefSchema = z.object({\n filePath: z.string(),\n exportName: z.string().optional(),\n commitSha: z.string().optional(),\n observedSha: z.string().optional(),\n start: z.number().int().nonnegative().optional(),\n end: z.number().int().nonnegative().optional(),\n anchors: SourceAnchorsSchema.optional(),\n});\nexport type SourceRef = z.infer<typeof SourceRefSchema>;\n\nexport const FunctionParameterSchema = z.object({\n name: z.string(),\n type: z.string().optional(),\n});\n\n\nexport type FunctionParameter = z.infer<typeof FunctionParameterSchema>;\n\nexport const FunctionDescriptorSchema = z.object({\n // Stable id: use resourceType + segments joined with '.' (no hash)\n functionId: z.string(),\n kind: FunctionKindSchema,\n resourceType: z.string(),\n // Path within the resource configuration for clarity and future-proofing\n propertyPath: z.string(),\n editable: z.boolean().default(false),\n\n // Introspection metadata (optional)\n name: z.string().optional(),\n isAsync: z.boolean().optional(),\n parameters: z.array(FunctionParameterSchema).optional(),\n returnType: z.string().optional(),\n\n // Source mapping & content; sourceTextTs only produced by app-lifecycle\n sourceTextTs: z.string().optional(),\n sourceRef: SourceRefSchema.optional(),\n\n // Optional extras for UI\n imports: z.array(z.string()).optional(),\n diagnostics: z.array(z.string()).optional(),\n});\n\n\nexport type FunctionDescriptor = z.infer<typeof FunctionDescriptorSchema>;\n\nexport const OperationFunctionsSchema = z.object({\n // multiple functions per operation, generic\n functions: z.array(FunctionDescriptorSchema).default([]),\n});\n\n\nexport type OperationFunctions = z.infer<typeof OperationFunctionsSchema>;\n\nexport const ResourceFunctionsSchema = z.object({\n functions: z.array(FunctionDescriptorSchema).default([]),\n});\nexport type ResourceFunctions = z.infer<typeof ResourceFunctionsSchema>;\n\n\n\n\n/*\n Deserialize a SerializableZodSchema back into a Zod schema.\n * - Reconstructs approximate Zod types from the descriptor\n * - Re-applies optional/nullable wrappers\n * - Re-applies SCHEMA_METADATA as decorators when possible\n \n NOTE: databaseSchema has been removed. Backend-only fields are now marked with\n * the isBackendOnly decorator in mainSchema and are stripped at the service layer.\n /\n\nexport type SerializableOperation = Omit<\n ResourceConfiguration_Operation<any, any, any>,\n 'requestDto' \| 'responseDto' \| 'mainSchema' \| 'enabledCondition' \| 'basicPrefixOperation'\n> & {\n requestDto?: SerializableZodSchema \| null;\n responseDto?: SerializableZodSchema \| null;\n mainSchema?: SerializableZodSchema \| null;\n // platform view only: don't serialize functions here\n hasEnabledCondition?: boolean;\n hasBasicPrefixOperation?: boolean;\n};\n\nexport type SerializableResourceConfiguration = Omit<\n AnyResourceConfiguration,\n 'operations' \| 'mainSchema'\n> & {\n operations: SerializableOperation[];\n mainSchema?: SerializableZodSchema \| null;\n getFrontendResourceLabel?: string[] \| { hasFunction: true } \| undefined;\n};\n\nexport type SerializableResourcesRegistry = {\n notificationBadgeDefinitions: ResourcesRegistry['notificationBadgeDefinitions'];\n additionalUserNotificationDefinitions: ResourcesRegistry['additionalUserNotificationDefinitions'];\n resourceRelationships: ResourcesRegistry['resourceRelationships'];\n resourceConfigurations: { [key: string]: SerializableResourceConfiguration };\n}\n\nexport type EnrichedOperationFunctions = {\n functions: FunctionDescriptor[];\n};\n\nexport type EnrichedResourceFunctions = {\n functions: FunctionDescriptor[];\n};\n\nexport type EnrichedResourcesFunctionsIndex = {\n [resourceType: string]: EnrichedResourceFunctions;\n};\n\n// ============================================================================\n// Queue System Schemas (Phase 6.1-6.2)\n// ============================================================================\n\n/\n Queue Job Payload Schema\n \n PLACEHOLDER - Queue system implementation pending.\n \n When the queue system is implemented, this schema should define the structure\n * of queue job payloads for resource operations.\n \n The payload should include:\n * - Resource type and operation identifier\n * - Resource data validated against `operation.internalDto`\n * - Execution context (user, organization, etc.)\n \n IMPORTANT: Resource data in the payload MUST be validated against\n * `operation.internalDto` before serialization:\n * - `internalDto` includes `isBackendOnly` fields (needed for backend-to-backend communication)\n * - Date coercion is already applied in `internalDto`\n * - Use `operation.internalDto.parse(data)` for validation\n \n Example structure (when queue system is ready):\n * ```typescript\n * const QueueJobPayloadSchema = z.object({\n * resourceType: z.string(),\n * operationIdentifier: z.string(),\n * data: z.any(), // Should be validated against operation.internalDto before enqueueing\n * executionContext: z.object({\n * userId: z.string().optional(),\n * organizationId: z.string().optional(),\n * // ... other context fields\n * }),\n * metadata: z.object({\n * jobId: z.string().optional(),\n * retryCount: z.number().optional(),\n * // ... other metadata\n * }).optional(),\n * });\n * ```\n \n @see Phase 6.1 - Use internalDto for Queue Payloads\n * @see Phase 6.2 - Validate Queue Payloads Against internalDto\n /\nexport type QueueJobPayload = {\n resourceType: string;\n operationIdentifier: string;\n /* Resource data - MUST be validated against operation.internalDto before serialization /\n data: any;\n executionContext: {\n userId?: string;\n organizationId?: string;\n [key: string]: any;\n };\n metadata?: {\n jobId?: string;\n retryCount?: number;\n [key: string]: any;\n };\n};\n\n/\n Queue Job Result Schema\n \n PLACEHOLDER - Queue system implementation pending.\n \n When the queue system is implemented, this schema should define the structure\n * of queue job results after execution.\n \n Example structure (when queue system is ready):\n * ```typescript\n * const QueueJobResultSchema = z.object({\n * success: z.boolean(),\n * result: z.any().optional(), // Operation result (if successful)\n * error: z.object({\n * message: z.string(),\n * code: z.string().optional(),\n * context: z.record(z.any()).optional(),\n * }).optional(), // Error details (if failed)\n * executionTime: z.number().optional(), // Milliseconds\n * });\n * ```\n \n @see Phase 6.1-6.2 - Queue System Integration\n */\nexport type QueueJobResult = {\n success: boolean;\n result?: any;\n error?: {\n message: string;\n code?: string;\n context?: Record<string, any>;\n };\n executionTime?: number; // Milliseconds\n};\n"]}

package/dist/esm/resources/resources.shared.core.definitions.d.ts CHANGED Viewed

@@ -1,4 +1,12 @@
 import { z } from 'zod';
+/**
+ * @wildo_source:part:start saas.models.core-resource-operation facet:layer:shared facet:family:resource-config
+ *
+ * Core CRUD and collection operations every resource may expose.
+ *
+ * @remarks Import from `@wildo-ai/saas-models`. App `resources-config` picks a
+ * subset via `coreOperations` and adds `customOperation` identifiers.
+ */
 export declare enum CoreResourceOperation {
     READ = "read",// View/retrieve existing resource
     UPDATE = "update",// Update existing resource
@@ -38,6 +46,7 @@ export declare const ARRAY_RESPONSE_OPERATIONS: CoreResourceOperation[];
  * These operations use IDs from execution context or query parameters, not from request body.
  */
 export declare const OPERATIONS_WITHOUT_REQUEST_BODY: CoreResourceOperation[];
+/** @wildo_source:part:end saas.models.core-resource-operation */
 export declare enum CoreResourceType {
     USER_SELF = "user_self",
     USERS = "users",
@@ -50,30 +59,32 @@ export declare enum CoreResourceType {
     ORGANIZATION_UNITS = "organizationUnits",
     ORGANIZATION_PROFILES = "organizationProfiles",
     ORGANIZATION_PREFERENCES = "organizationPreferences",
+    PLATFORM_ACCESS_GRANTS = "platformAccessGrants",
     ORGANIZATION_NOTIFICATIONS = "organizationNotifications",
     ORGANIZATION_FEATURES = "organizationFeatures",
     USER_FEATURES = "userFeatures",
     ORGANIZATION_MEMBERS = "organizationMembers",
-    ORGANIZATION_MEMBER_INVITATIONS = "organizationMemberInvitations",
+    /** Junction: a membership's role inside one organization unit (replaced an embedded array — D-B5). */
+    ORGANIZATION_UNIT_MEMBERS = "organizationUnitMembers",
     ORG_API_KEYS = "organizationApiKeys",
+    OAUTH_CLIENTS_ORGANIZATION = "organizationOAuthClients",
     ORGANIZATION_SCIM_TOKENS = "organizationScimTokens",
     ORGANIZATION_SCIM_PROVISIONING_CONFIG = "organizationScimProvisioningConfig",
     ORGANIZATION_SSO_CONNECTIONS = "organizationSsoConnections",
     ORGANIZATION_SSO_CONFIG = "organizationSsoConfig",
-    ORGANIZATION_AUTH_POLICY = "organizationAuthPolicy",
     ORGANIZATION_SIEM_EXPORT_CONFIG = "organizationSiemExportConfig",
     ORGANIZATION_SIEM_DELIVERY_DLQ = "organizationSiemDeliveryDlq",
     APPLICATION = "applications",
     APPLICATION_SSO_CONFIG = "applicationSsoConfig",
     APPLICATION_SSO_CONNECTIONS = "applicationSsoConnections",
-    APPLICATION_AUTH_POLICY = "applicationAuthPolicy",
     APPLICATION_SIEM_EXPORT_CONFIG = "applicationSiemExportConfig",
     APPLICATION_SIEM_DELIVERY_DLQ = "applicationSiemDeliveryDlq",
-    APPLICATION_SCIM_TOKENS = "applicationScimTokens",
     APPLICATION_SCIM_PROVISIONING_CONFIG = "applicationScimProvisioningConfig",
     APPLICATION_API_KEYS = "applicationApiKeys",
+    OAUTH_CLIENTS_APPLICATION = "applicationOAuthClients",
     APPLICATION_METADATA = "applicationMetadata",
     APPLICATION_VERSIONS = "applicationVersions",
+    APPLICATION_FEATURES = "applicationFeatures",
     ORGANIZATION_BILLING_ACCOUNTS = "organizationBillingAccounts",
     USER_BILLING_ACCOUNTS = "userBillingAccounts",
     ORGANIZATION_SUBSCRIPTIONS = "organizationSubscriptions",
@@ -89,21 +100,72 @@ export declare enum CoreResourceType {
     PROMOTIONS = "promotions",
     REFERRALS = "referrals",
     AUDIT_LOGS = "auditLogs",
-    NOTIFICATION_BADGES = "notificationBadges",
+    USER_NOTIFICATION_BADGES = "userNotificationBadges",
+    ORGANIZATION_NOTIFICATION_BADGES = "organizationNotificationBadges",
+    ORGANIZATION_WEBHOOK_CONFIG = "organizationWebhookConfig",
+    APPLICATION_WEBHOOK_CONFIG = "applicationWebhookConfig",
+    ORGANIZATION_M2M_WEBHOOK_DELIVERY_LOG = "organizationM2mWebhookDeliveryLog",
+    APPLICATION_M2M_WEBHOOK_DELIVERY_LOG = "applicationM2mWebhookDeliveryLog",
     FILES = "files",
     JOB_EXECUTIONS = "jobExecutions",
     JOB_PAYLOAD_STORAGE = "jobPayloadStorage",
-    EMAIL_TEMPLATES = "emailTemplates",
-    EMAIL_HEADER_FOOTER_TEMPLATES = "emailHeaderFooterTemplates",
     USER_IDENTITY_LINKS = "userIdentityLinks",
+    OAUTH_CONSENT_GRANTS = "oauthConsentGrants",
     ANONYMOUS_USERS = "anonymous_users",
+    INBOUND_CONTACTS = "inboundContacts",
     USER_GUIDANCE_STATE = "userGuidanceState",
     ORGANIZATION_GUIDANCE_STATE = "organizationGuidanceState",
     USER_PROGRESSION_STATE = "userProgressionState",
     ORGANIZATION_PROGRESSION_STATE = "organizationProgressionState",
     USER_LIFECYCLE_STATE = "userLifecycleState",
-    ORGANIZATION_LIFECYCLE_STATE = "organizationLifecycleState"
+    ORGANIZATION_LIFECYCLE_STATE = "organizationLifecycleState",
+    USER_FLOW_ACTOR_EXECUTIONS = "userFlowActorExecutions",
+    ORGANIZATION_FLOW_ACTOR_EXECUTIONS = "organizationFlowActorExecutions",
+    APPLICATION_FLOW_ACTOR_EXECUTIONS = "applicationFlowActorExecutions",
+    USER_FLOW_ACTOR_TASKS = "userFlowActorTasks",
+    ORGANIZATION_FLOW_ACTOR_TASKS = "organizationFlowActorTasks",
+    APPLICATION_FLOW_ACTOR_TASKS = "applicationFlowActorTasks",
+    USER_A2A_PUSH_DELIVERY_LOG = "userA2aPushDeliveryLog",
+    ORGANIZATION_A2A_PUSH_DELIVERY_LOG = "organizationA2aPushDeliveryLog",
+    APPLICATION_A2A_PUSH_DELIVERY_LOG = "applicationA2aPushDeliveryLog",
+    USER_A2A_TOKEN_BUDGET_STATE = "userA2aTokenBudgetState",
+    ORGANIZATION_A2A_TOKEN_BUDGET_STATE = "organizationA2aTokenBudgetState",
+    APPLICATION_A2A_TOKEN_BUDGET_STATE = "applicationA2aTokenBudgetState"
 }
+/**
+ * The core resources the ENGINE'S OWN runtime reads, which an application may never exclude.
+ *
+ * `excludedResourceTypes` exists so an application can drop core vocabulary it does not use — the
+ * billing-conditional resources it was built for, or, for a purpose-built console, most of the core
+ * catalog. That freedom has one floor: a resource the engine itself reads to function.
+ *
+ * It is declared HERE, in the shared tier, because the floor has TWO enforcement sites in different
+ * layers and they must never disagree: the frontend registry must REGISTER the resource, and the
+ * backend serving that frontend must MOUNT its controller. A floor honoured on one side only fails
+ * exactly as loudly as no floor at all — the workbench proved both halves in turn, first a registry
+ * with no `user_self` entry, then a 404 on `/api/v1/user-self/:id/context`.
+ *
+ * `USER_SELF` is that floor today. `UserOrgsContext.restoreUserSession` reads it to build the
+ * authenticated context after every login and every reload, and returns `false` when the registry
+ * has no entry for it — on which the caller logs out "to avoid a half-restored state". So excluding
+ * it does not degrade a feature; it makes authentication IMPOSSIBLE, in the most misleading way
+ * available: `POST /auth/authenticate` answers 200 with a valid token, the very next request goes out
+ * with no `Authorization` header, the 401 that follows is read as an expired session, and the user
+ * lands back on the login form. The only trace is one `warn`.
+ *
+ * That is why this is a floor the engine ENFORCES rather than a line in an application's
+ * documentation. An application cannot see this dependency — `restoreUserSession` is engine-internal
+ * — so an exclusion set derived from the application's own vocabulary (which is the correct way to
+ * write one) has no way to know it must carve this out. Measured on the application-creation
+ * workbench, whose exclusion is derived exactly that way: login succeeded and bounced, every time.
+ *
+ * `ORGANIZATIONS` is deliberately NOT here. `loadOrganizations` also reads the registry, but it warns
+ * and returns an empty list, so excluding it degrades the organization switcher and nothing else —
+ * a legitimate choice for a console with no tenant vocabulary. The floor is what BREAKS when absent,
+ * not everything the engine happens to read; a floor that grows past that would quietly re-impose the
+ * whole core catalog on every application.
+ */
+export declare const ENGINE_RUNTIME_REQUIRED_RESOURCE_TYPES: ReadonlySet<string>;
 /**
  * Set of all billing resource types.
  * Used by the resource exclusion mechanism to conditionally exclude
@@ -111,10 +173,16 @@ export declare enum CoreResourceType {
  */
 export declare const BILLING_RESOURCE_TYPES: ReadonlySet<CoreResourceType>;
 /**
+ * @wildo_source:part:start saas.models.resource-type facet:layer:shared facet:family:resource-config
+ *
  * Resource Type Schema (Core + Custom)
+ *
+ * @remarks Import from `@wildo-ai/saas-models`. Custom app resources use
+ * string literals beyond `CoreResourceType`.
  */
 export declare const ResourceTypeSchema: z.ZodUnion<readonly [z.ZodEnum<typeof CoreResourceType>, z.ZodString]>;
 export type ResourceType = z.infer<typeof ResourceTypeSchema>;
+/** @wildo_source:part:end saas.models.resource-type */
 /**
  * When multiple resource types share the same field identifier (e.g., USERS and
  * USER_SELF both use "userId"), this map declares which resource type is the
@@ -127,8 +195,16 @@ export declare const coreResourceShared_FieldIdentifierPriority: Record<string,
 export declare const coreResourceShared_FieldIdentifier: {
     [key in CoreResourceType]: string;
 };
+/**
+ * @wildo_source:part:start saas.models.resource-field-identifier facet:layer:shared facet:family:resource-config
+ *
+ * FK / primary-key field identifier string for a resource (core or custom).
+ *
+ * @remarks Import from `@wildo-ai/saas-models`.
+ */
 export declare const ResourceFieldIdentifierSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
 export type ResourceFieldIdentifier = z.infer<typeof ResourceFieldIdentifierSchema>;
+/** @wildo_source:part:end saas.models.resource-field-identifier */
 /**
  * Cascade direction for self-referencing relationships.
  * Used when resourceType1 === resourceType2 to disambiguate parent vs child.

package/dist/esm/resources/resources.shared.core.definitions.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resources.shared.core.definitions.d.ts","sourceRoot":"","sources":["~~../../../~~src/resources/resources.shared.core.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oBAAY,qBAAqB;IAC/B,IAAI,SAAS,CAAS,kCAAkC;IACxD,MAAM,WAAW,CAAO,2BAA2B;IACnD,WAAW,gBAAgB,CAAI,4BAA4B;IAC3D,MAAM,WAAW,CAAK,kBAAkB;IACxC,WAAW,gBAAgB,CAAI,4BAA4B;IAC3D,MAAM,WAAW,CAAK,sBAAsB;IAC5C,WAAW,gBAAgB,CAAI,4BAA4B;IAC3D,IAAI,SAAS,CAAS,iCAAiC;IACvD,MAAM,WAAW,CAAK,2CAA2C;IACjE,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,mBAAmB,yBAAuC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAAE,qBAAqB,EAMpE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,qBAAqB,EAGhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,qBAAqB,EAG5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,qBAAqB,EAK5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,qBAAqB,EAMlE,CAAC;~~AAEF~~,oBAAY,gBAAgB;IAE1B,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,gBAAgB,oBAAoB;IACpC,aAAa,iBAAiB;IAC9B,gBAAgB,oBAAoB;IACpC,kBAAkB,qBAAqB;IACvC,qBAAqB,wBAAwB;IAC7C,aAAa,kBAAkB;IAC/B,kBAAkB,sBAAsB;IACxC,qBAAqB,yBAAyB;IAC9C,wBAAwB,4BAA4B;IACpD,0BAA0B,8BAA8B;IACxD,qBAAqB,yBAAyB;IAC9C,aAAa,iBAAiB;IAC9B,oBAAoB,wBAAwB;IAC5C~~,+BAA+B~~,~~kCAAkC~~;~~IAGjE~~,YAAY,wBAAwB;IACpC,wBAAwB,2BAA2B;IACnD,qCAAqC,uCAAuC;IAG5E,4BAA4B,+BAA+B;IAC3D,uBAAuB,0BAA0B;~~IACjD,wBAAwB,2BAA2B;IAGnD~~,+BAA+B,iCAAiC;IAChE,8BAA8B,gCAAgC;IAE9D,WAAW,iBAAiB;IAC5B,sBAAsB,yBAAyB;IAC/C,2BAA2B,8BAA8B;IACzD,~~uBAAuB,0BAA0B;IACjD,~~8BAA8B,gCAAgC;IAC9D,6BAA6B,+BAA+B;IAC5D,~~uBAAuB,0BAA0B;IACjD,~~oCAAoC,sCAAsC;IAC1E,oBAAoB,uBAAuB;IAC3C,oBAAoB,wBAAwB;IAC5C,oBAAoB,wBAAwB;IAG5C,6BAA6B,gCAAgC;IAC7D,qBAAqB,wBAAwB;IAG7C,0BAA0B,8BAA8B;IACxD,kBAAkB,sBAAsB;IAGxC,yBAAyB,4BAA4B;IACrD,iBAAiB,oBAAoB;IAGrC,0BAA0B,6BAA6B;IACvD,kBAAkB,qBAAqB;IAGvC,yBAAyB,4BAA4B;IACrD,iBAAiB,oBAAoB;IAGrC,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,SAAS,cAAc;IAGvB,UAAU,cAAc;~~IAGxB~~,~~mBAAmB~~,~~uBAAuB~~;~~IAG1C~~,KAAK,UAAU;IAGf,cAAc,kBAAkB;IAChC,mBAAmB,sBAAsB;IAGzC,~~eAAe,~~mBAAmB~~;IAClC~~,~~6BAA6B,+BAA+B~~;~~IAG5D~~,~~mBAAmB~~,~~sBAAsB~~;~~IAGzC~~,eAAe,oBAAoB;~~IAGnC~~,mBAAmB,sBAAsB;IACzC,2BAA2B,8BAA8B;IAGzD,sBAAsB,yBAAyB;IAC/C,8BAA8B,iCAAiC;IAG/D,oBAAoB,uBAAuB;IAC3C,4BAA4B,+BAA+B;~~CAC5D~~;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,gBAAgB,CAqB/D,CAAC;AAEH~~;;GAEG~~;AACH,eAAO,MAAM,kBAAkB,wEAG7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;~~AAE9D~~;;;;;;;GAOG;AACH,eAAO,MAAM,0CAA0C,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAEvF,CAAC;AAEF,eAAO,MAAM,kCAAkC,EAAE;KAAG,GAAG,IAAI,gBAAgB,GAAG,MAAM;~~CAgFnF~~,CAAC;AAEF,eAAO,MAAM,6BAA6B,iDAKxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;~~AAEpF~~;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,6DAA6D;IAC7D,OAAO,YAAY;IACnB,0DAA0D;IAC1D,QAAQ,aAAa;CACtB"}
1	+ {"version":3,"file":"resources.shared.core.definitions.d.ts","sourceRoot":"","sources":["../../../../src/resources/resources.shared.core.definitions.ts"],"names":[],"mappings":"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"}