@wildo-ai/saas-models 1.1.8 → 1.1.10

package/dist/esm/resources/resource-status-lifecycle.example.js

@@ -0,0 +1,156 @@
+/**
+ * Illustrative status lifecycle on a resource, for the app-facing `resource-status-lifecycle` skill.
+ *
+ * TIER B (framework-owned illustrative sample): the reference applications show transitions
+ * (`todo-lists` ARCHIVE / RESTORE) but not the whole pattern — their status field stays freely
+ * editable through UPDATE and nothing freezes a terminal state — so anchoring them would teach a
+ * lifecycle anyone can bypass. Typed against the real factory, and pinned by a contract test that
+ * builds the configuration, so a sample the factory refuses fails CI.
+ */
+import { CurrencyAllowed, CurrencySchema, DocumentSequenceScope, z_money } from '@wildo-ai/zod-decorators';
+import { z } from 'zod';
+import { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+import { createResourceConfiguration_Initialization } from './resources-config.shared.factory.js';
+import { createResourcesRelationship } from './resources-relationships.shared.factory.js';
+import { CoreResourceOperation, CoreResourceType } from './resources.shared.core.definitions.js';
+import { RelationshipNature, ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceRelationshipCardinality, } from './resources.shared.schemas.js';
+/**
+ * @wildo_source:part:start example.resource.status-lifecycle.quote facet:kind:usage-example facet:audience:app-developer
+ *
+ * A quote moves DRAFT → SENT → ACCEPTED or DECLINED. `z_money`, `CurrencySchema`, `CurrencyAllowed` and
+ * `DocumentSequenceScope` import from `@wildo-ai/zod-decorators`; everything else below from
+ * `@wildo-ai/saas-models` (and `zod`). The schema lives in `<resource>.schemas.ts`, the rest in
+ * `<resource>.resources-config.ts`.
+ *
+ * Four things make it a lifecycle rather than a field anyone edits:
+ * 1. `status` is `.excludeFromUpdate()`, so the generic UPDATE cannot move it at all.
+ * 2. Each transition is its own operation, `resourceOperationLike: UPDATE` with an empty
+ *    `requestDto`: the target state is the server's decision, never the caller's.
+ * 3. `enabledCondition` says which state the transition starts from. The engine enforces it on the
+ *    backend (and the UI hides the action), so SEND on an accepted quote is refused.
+ * 4. `basicPrefixOperation` returns ONLY the new state and its timestamp (spreading the current row
+ *    would write every field back, overwriting a concurrent edit), and `authoritativeFields` names
+ *    them. A key the prefix introduces is kept on the ordinary HTTP path anyway; the declaration is
+ *    what keeps it when a caller reaches the service with that key already in its payload (an MCP
+ *    tool, another service), where the strict re-parse would otherwise strip it.
+ * And UPDATE itself is enabled only while the quote is a DRAFT: SENT is LOCKED (no edits, yet ACCEPT and
+ * DECLINE still move it on) and ACCEPTED and DECLINED are FINAL (nothing moves them again).
+ *
+ * It is also a COMMERCIAL DOCUMENT, and these fields make it one:
+ * - `number` is allocated by the server at create, consecutive per organization and year (`Q-2026-00042`); a client
+ *   never sends it, and the decorator makes it unique and server-only;
+ * - `currency` is the quote's one currency; every amount on it is a fiat `z_money()` in that currency;
+ * - `lines` are an array on the quote, so they freeze with it: the UPDATE that edits them is refused once it is SENT;
+ * - `total` is the server's: excluded from create and update, computed by a prefix on CREATE and UPDATE with
+ *   `authoritativeFields: ['total']` from the lines and `discountPercent` (see the computed-total recipe), never typed
+ *   by a person.
+ *
+ * Concurrency: the starting-state check runs before the write and is not a compare-and-swap. Two
+ * transitions from the same state arriving at the same moment (ACCEPT and DECLINE on one SENT quote)
+ * can both pass it, and the last write wins. Sequential calls are refused correctly. Closing the
+ * concurrent case is the engine's work (a transition whose write is conditional on its starting state),
+ * not something an application can declare today.
+ */
+export var Quote_Status;
+(function (Quote_Status) {
+    Quote_Status["DRAFT"] = "DRAFT";
+    Quote_Status["SENT"] = "SENT";
+    Quote_Status["ACCEPTED"] = "ACCEPTED";
+    Quote_Status["DECLINED"] = "DECLINED";
+})(Quote_Status || (Quote_Status = {}));
+export const Quote_Schema = z.object({
+    _id: z.string().min(1).isPrimaryKey(),
+    organizationId: z.string().min(1).isDBIndexed().isForeignKey().excludeFromUpdate(),
+    number: z.string().documentSequence({ format: 'Q-{YYYY}-{n:5}', scope: DocumentSequenceScope.ORGANIZATION }).isSummaryField(),
+    title: z.string().trim().min(1).max(200).isSummaryField(),
+    currency: CurrencySchema,
+    lines: z.array(z.object({
+        description: z.string().trim().min(1).max(500),
+        quantity: z.number().int().min(1),
+        unitPrice: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }),
+    })).default([]),
+    discountPercent: z.number().min(0).max(100).default(0),
+    total: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }).optional().isSummaryField().excludeFromCreate().excludeFromUpdate(),
+    status: z.enum(Quote_Status).default(Quote_Status.DRAFT).isSummaryField().excludeFromCreate().excludeFromUpdate(),
+    sentAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),
+    decidedAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),
+});
+/** In `<module>.relationships.ts`: the organization the quote belongs to (its primary scope). */
+export const quote_ResourceRelationships = [
+    createResourcesRelationship(CoreResourceType.ORGANIZATIONS, 'quotes', ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY, { nature: RelationshipNature.COMPOSITION, isPrimaryScope: true, foreignKeyField: 'organizationId' }),
+];
+export var Quote_Operations;
+(function (Quote_Operations) {
+    Quote_Operations["SEND"] = "send";
+    Quote_Operations["ACCEPT"] = "accept";
+    Quote_Operations["DECLINE"] = "decline";
+})(Quote_Operations || (Quote_Operations = {}));
+export const quote_ResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
+    mainSchema: Quote_Schema,
+    resourceIdentifier: 'quotes',
+    resourceFieldIdentifier: 'quoteId',
+    resourceRelationships: resourcesRelationships,
+    isSystemResource: false,
+    coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.CREATE, CoreResourceOperation.UPDATE],
+    customOperation: Quote_Operations,
+    operationsConfiguration: {
+        [CoreResourceOperation.READ]: { variants: [{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, roles: [CORE_ORG_ROLES.ORG_MEMBER], riskLevel: ResourceOperationRiskLevel.LOW }] },
+        [CoreResourceOperation.LIST]: { variants: [{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, roles: [CORE_ORG_ROLES.ORG_MEMBER], riskLevel: ResourceOperationRiskLevel.LOW }] },
+        [CoreResourceOperation.CREATE]: { variants: [{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, roles: [CORE_ORG_ROLES.ORG_MEMBER], riskLevel: ResourceOperationRiskLevel.MEDIUM }] },
+        [CoreResourceOperation.UPDATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_MEMBER],
+                    riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                    // Frozen once sent: the content a customer received does not change under them.
+                    enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.DRAFT,
+                }],
+        },
+        [Quote_Operations.SEND]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_MEMBER],
+                    // A decision a customer relies on: HIGH puts every transition in the audit trail.
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                    resourceOperationLike: CoreResourceOperation.UPDATE,
+                    requestDto: z.object({}),
+                    enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.DRAFT,
+                    basicPrefixOperation: () => ({ status: Quote_Status.SENT, sentAt: new Date() }),
+                    authoritativeFields: ['status', 'sentAt'],
+                }],
+        },
+        [Quote_Operations.ACCEPT]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_MEMBER],
+                    // Only a sent quote can be accepted; accepting a draft is refused.
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                    resourceOperationLike: CoreResourceOperation.UPDATE,
+                    requestDto: z.object({}),
+                    enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.SENT,
+                    basicPrefixOperation: () => ({ status: Quote_Status.ACCEPTED, decidedAt: new Date() }),
+                    authoritativeFields: ['status', 'decidedAt'],
+                }],
+        },
+        [Quote_Operations.DECLINE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_MEMBER],
+                    // Starts from SENT like ACCEPT, so after either has run the other is refused. Two calls arriving at the
+                    // same moment are not serialized: see the concurrency note above.
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                    resourceOperationLike: CoreResourceOperation.UPDATE,
+                    requestDto: z.object({}),
+                    enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.SENT,
+                    basicPrefixOperation: () => ({ status: Quote_Status.DECLINED, decidedAt: new Date() }),
+                    authoritativeFields: ['status', 'decidedAt'],
+                }],
+        },
+    },
+});
+/** @wildo_source:part:end example.resource.status-lifecycle.quote */
+//# sourceMappingURL=resource-status-lifecycle.example.js.map

package/dist/esm/resources/resource-status-lifecycle.example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-status-lifecycle.example.js","sourceRoot":"","sources":["../../../src/resources/resource-status-lifecycle.example.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Illustrative status lifecycle on a resource, for the app-facing `resource-status-lifecycle` skill.\n *\n * TIER B (framework-owned illustrative sample): the reference applications show transitions\n * (`todo-lists` ARCHIVE / RESTORE) but not the whole pattern — their status field stays freely\n * editable through UPDATE and nothing freezes a terminal state — so anchoring them would teach a\n * lifecycle anyone can bypass. Typed against the real factory, and pinned by a contract test that\n * builds the configuration, so a sample the factory refuses fails CI.\n */\n\nimport { CurrencyAllowed, CurrencySchema, DocumentSequenceScope, z_money } from '@wildo-ai/zod-decorators';\nimport { z } from 'zod';\n\nimport { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { createResourceConfiguration_Initialization } from './resources-config.shared.factory';\nimport { createResourcesRelationship } from './resources-relationships.shared.factory';\nimport { CoreResourceOperation, CoreResourceType } from './resources.shared.core.definitions';\nimport {\n  RelationshipNature,\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n  ResourceRelationshipCardinality,\n  type ResourceRelationship,\n} from './resources.shared.schemas';\n\n/**\n * @wildo_source:part:start example.resource.status-lifecycle.quote facet:kind:usage-example facet:audience:app-developer\n *\n * A quote moves DRAFT → SENT → ACCEPTED or DECLINED. `z_money`, `CurrencySchema`, `CurrencyAllowed` and\n * `DocumentSequenceScope` import from `@wildo-ai/zod-decorators`; everything else below from\n * `@wildo-ai/saas-models` (and `zod`). The schema lives in `<resource>.schemas.ts`, the rest in\n * `<resource>.resources-config.ts`.\n *\n * Four things make it a lifecycle rather than a field anyone edits:\n * 1. `status` is `.excludeFromUpdate()`, so the generic UPDATE cannot move it at all.\n * 2. Each transition is its own operation, `resourceOperationLike: UPDATE` with an empty\n *    `requestDto`: the target state is the server's decision, never the caller's.\n * 3. `enabledCondition` says which state the transition starts from. The engine enforces it on the\n *    backend (and the UI hides the action), so SEND on an accepted quote is refused.\n * 4. `basicPrefixOperation` returns ONLY the new state and its timestamp (spreading the current row\n *    would write every field back, overwriting a concurrent edit), and `authoritativeFields` names\n *    them. A key the prefix introduces is kept on the ordinary HTTP path anyway; the declaration is\n *    what keeps it when a caller reaches the service with that key already in its payload (an MCP\n *    tool, another service), where the strict re-parse would otherwise strip it.\n * And UPDATE itself is enabled only while the quote is a DRAFT: SENT is LOCKED (no edits, yet ACCEPT and\n * DECLINE still move it on) and ACCEPTED and DECLINED are FINAL (nothing moves them again).\n *\n * It is also a COMMERCIAL DOCUMENT, and these fields make it one:\n * - `number` is allocated by the server at create, consecutive per organization and year (`Q-2026-00042`); a client\n *   never sends it, and the decorator makes it unique and server-only;\n * - `currency` is the quote's one currency; every amount on it is a fiat `z_money()` in that currency;\n * - `lines` are an array on the quote, so they freeze with it: the UPDATE that edits them is refused once it is SENT;\n * - `total` is the server's: excluded from create and update, computed by a prefix on CREATE and UPDATE with\n *   `authoritativeFields: ['total']` from the lines and `discountPercent` (see the computed-total recipe), never typed\n *   by a person.\n *\n * Concurrency: the starting-state check runs before the write and is not a compare-and-swap. Two\n * transitions from the same state arriving at the same moment (ACCEPT and DECLINE on one SENT quote)\n * can both pass it, and the last write wins. Sequential calls are refused correctly. Closing the\n * concurrent case is the engine's work (a transition whose write is conditional on its starting state),\n * not something an application can declare today.\n */\nexport enum Quote_Status {\n  DRAFT = 'DRAFT',\n  SENT = 'SENT',\n  ACCEPTED = 'ACCEPTED',\n  DECLINED = 'DECLINED',\n}\n\nexport const Quote_Schema = z.object({\n  _id: z.string().min(1).isPrimaryKey(),\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().excludeFromUpdate(),\n  number: z.string().documentSequence({ format: 'Q-{YYYY}-{n:5}', scope: DocumentSequenceScope.ORGANIZATION }).isSummaryField(),\n  title: z.string().trim().min(1).max(200).isSummaryField(),\n  currency: CurrencySchema,\n  lines: z.array(z.object({\n    description: z.string().trim().min(1).max(500),\n    quantity: z.number().int().min(1),\n    unitPrice: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }),\n  })).default([]),\n  discountPercent: z.number().min(0).max(100).default(0),\n  total: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }).optional().isSummaryField().excludeFromCreate().excludeFromUpdate(),\n  status: z.enum(Quote_Status).default(Quote_Status.DRAFT).isSummaryField().excludeFromCreate().excludeFromUpdate(),\n  sentAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),\n  decidedAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),\n});\n\n/** In `<module>.relationships.ts`: the organization the quote belongs to (its primary scope). */\nexport const quote_ResourceRelationships: ResourceRelationship[] = [\n  createResourcesRelationship(\n    CoreResourceType.ORGANIZATIONS, 'quotes',\n    ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,\n    { nature: RelationshipNature.COMPOSITION, isPrimaryScope: true, foreignKeyField: 'organizationId' },\n  ),\n];\n\nexport enum Quote_Operations {\n  SEND = 'send',\n  ACCEPT = 'accept',\n  DECLINE = 'decline',\n}\n\ntype Quote_CoreOperations = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE;\n\nexport const quote_ResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) =>\n  createResourceConfiguration_Initialization<typeof Quote_Operations, Quote_CoreOperations, typeof Quote_Schema>({\n    mainSchema: Quote_Schema,\n    resourceIdentifier: 'quotes',\n    resourceFieldIdentifier: 'quoteId',\n    resourceRelationships: resourcesRelationships,\n    isSystemResource: false,\n    coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.CREATE, CoreResourceOperation.UPDATE],\n    customOperation: Quote_Operations,\n    operationsConfiguration: {\n      [CoreResourceOperation.READ]: { variants: [{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, roles: [CORE_ORG_ROLES.ORG_MEMBER], riskLevel: ResourceOperationRiskLevel.LOW }] },\n      [CoreResourceOperation.LIST]: { variants: [{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, roles: [CORE_ORG_ROLES.ORG_MEMBER], riskLevel: ResourceOperationRiskLevel.LOW }] },\n      [CoreResourceOperation.CREATE]: { variants: [{ variantType: ResourceOperationVariantType.API_CALL, isDefault: true, roles: [CORE_ORG_ROLES.ORG_MEMBER], riskLevel: ResourceOperationRiskLevel.MEDIUM }] },\n      [CoreResourceOperation.UPDATE]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          // Frozen once sent: the content a customer received does not change under them.\n          enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.DRAFT,\n        }],\n      },\n      [Quote_Operations.SEND]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          // A decision a customer relies on: HIGH puts every transition in the audit trail.\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({}),\n          enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.DRAFT,\n          basicPrefixOperation: () => ({ status: Quote_Status.SENT, sentAt: new Date() }),\n          authoritativeFields: ['status', 'sentAt'],\n        }],\n      },\n      [Quote_Operations.ACCEPT]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          // Only a sent quote can be accepted; accepting a draft is refused.\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({}),\n          enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.SENT,\n          basicPrefixOperation: () => ({ status: Quote_Status.ACCEPTED, decidedAt: new Date() }),\n          authoritativeFields: ['status', 'decidedAt'],\n        }],\n      },\n      [Quote_Operations.DECLINE]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          // Starts from SENT like ACCEPT, so after either has run the other is refused. Two calls arriving at the\n          // same moment are not serialized: see the concurrency note above.\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: z.object({}),\n          enabledCondition: ({ currentObject }) => currentObject.status === Quote_Status.SENT,\n          basicPrefixOperation: () => ({ status: Quote_Status.DECLINED, decidedAt: new Date() }),\n          authoritativeFields: ['status', 'decidedAt'],\n        }],\n      },\n    },\n  });\n/** @wildo_source:part:end example.resource.status-lifecycle.quote */\n"]}

package/dist/esm/resources/resources-config.shared.factory.d.ts

@@ -83,5 +83,29 @@ export declare function createResourceSearchQueryRequestSchema<TFilterFields ext
  * NOTE: TDatabaseSchema has been removed. Backend-only fields are now marked with
  * the isBackendOnly decorator in mainSchema and are stripped at the service layer.
  */
-export declare function createResourceConfiguration_Initialization<TCustomOperationEnum extends EnumLikeType | undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined, TMainSchema extends z.ZodTypeAny>(params: ResourceConfiguration_BuilderParameters<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>): ResourceConfiguration<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;
+/**
+ * What a `retentionPolicy` must be assigned to when the resource's core operations lack one it needs (#2408). Named so
+ * the compile error says the rule: "Type '{ mode: … }' is not assignable to type
+ * 'RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations'". Nothing is assignable to it.
+ */
+export interface RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations {
+    readonly declareReadListAndUpdateManyInTheCoreOperations: never;
+}
+/**
+ * The compile-time half of the retention operation contract (#2408): a `retentionPolicy` is ACCEPTED only when the
+ * resource's core-operation type includes `READ`, `LIST` and `UPDATE_MANY` — the operations
+ * `RETENTION_REQUIRED_SERVICE_RESOLVABLE_OPERATIONS` names, the erasure writer and the see-through reads.
+ *
+ * `app-creation-test-005` landed a `RETAIN_ONLY` resource with `[READ, LIST, CREATE, UPDATE]`; it typechecked, and the
+ * backend then refused every start for four hours. The runtime check stays: this reads the core-operation TYPE, while
+ * the factory still reads the `coreOperations` ARRAY and each operation's variant, which a type cannot see. Checked over
+ * the type rather than the array because the type is what a factory annotation carries, and it is declared beside
+ * the array in every configuration.
+ */
+export type ResourceConfiguration_RetentionPolicyOperationsRequirement<TCoreOperationEnum> = [
+    CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.UPDATE_MANY
+] extends [TCoreOperationEnum] ? unknown : {
+    readonly retentionPolicy?: RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations;
+};
+export declare function createResourceConfiguration_Initialization<TCustomOperationEnum extends EnumLikeType | undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined, TMainSchema extends z.ZodTypeAny>(params: ResourceConfiguration_BuilderParameters<TCustomOperationEnum, TCoreOperationEnum, TMainSchema> & ResourceConfiguration_RetentionPolicyOperationsRequirement<TCoreOperationEnum>): ResourceConfiguration<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;
 //# sourceMappingURL=resources-config.shared.factory.d.ts.map

package/dist/esm/resources/resources-config.shared.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-config.shared.factory.d.ts","sourceRoot":"","sources":["../../../../src/resources/resources-config.shared.factory.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EAEZ,gBAAgB,EAuBjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiFxB,OAAO,EAEL,KAAK,wBAAwB,EAe7B,qBAAqB,EAKrB,uCAAuC,EAKvC,gCAAgC,EAWjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAwD,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEhJ,OAAO,EAUL,oBAAoB,EAarB,MAAM,4BAA4B,CAAC;AAsbpC,wBAAgB,4CAA4C,CAC1D,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAChE,wBAAwB,EAAE,oBAAoB,EAAE,EAChD,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1F,IAAI,CA0BN;AA+gBD,+EAA+E;AAI/E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC1D,UAAU,EAAE,CAAC,EACb,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,CAAC,CAAC,UAAU,CA4Cd;AA8ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACrD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,EACb,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,GACzB,CAAC,CAAC,UAAU,CAqBd;AAiwBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sCAAsC,CACpD,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,EAClE,WAAW,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,EACjD,MAAM,EAAE;IACR,YAAY,EAAE,aAAa,CAAC;IAC5B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;OAUG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,gCAAgC,CAAC,aAAa,EAAE,WAAW,CAAC,CA6F/D;AA4GD;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EACrE,WAAW,SAAS,CAAC,CAAC,UAAU,EAChC,MAAM,EAAE,uCAAuC,CAC/C,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CACtD,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CAAC,CA24F/E"}
+{"version":3,"file":"resources-config.shared.factory.d.ts","sourceRoot":"","sources":["../../../src/resources/resources-config.shared.factory.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EAEZ,gBAAgB,EAuBjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiFxB,OAAO,EAEL,KAAK,wBAAwB,EAe7B,qBAAqB,EAKrB,uCAAuC,EAKvC,gCAAgC,EAWjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAwD,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEhJ,OAAO,EAUL,oBAAoB,EAarB,MAAM,4BAA4B,CAAC;AA4cpC,wBAAgB,4CAA4C,CAC1D,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAChE,wBAAwB,EAAE,oBAAoB,EAAE,EAChD,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1F,IAAI,CA0BN;AA+gBD,+EAA+E;AAI/E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC1D,UAAU,EAAE,CAAC,EACb,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,CAAC,CAAC,UAAU,CA4Cd;AA8ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACrD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,EACb,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,GACzB,CAAC,CAAC,UAAU,CAqBd;AAiwBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sCAAsC,CACpD,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,EAClE,WAAW,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,EACjD,MAAM,EAAE;IACR,YAAY,EAAE,aAAa,CAAC;IAC5B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;OAUG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,gCAAgC,CAAC,aAAa,EAAE,WAAW,CAAC,CA6F/D;AA4GD;;;;GAIG;AACH;;;;GAIG;AACH,MAAM,WAAW,4DAA4D;IAC3E,QAAQ,CAAC,+CAA+C,EAAE,KAAK,CAAC;CACjE;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,0DAA0D,CAAC,kBAAkB,IACvF;IAAC,qBAAqB,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,GAAG,qBAAqB,CAAC,WAAW;CAAC,SAAS,CAAC,kBAAkB,CAAC,GACtH,OAAO,GACP;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,4DAA4D,CAAA;CAAE,CAAC;AAElG,wBAAgB,0CAA0C,CACxD,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EACrE,WAAW,SAAS,CAAC,CAAC,UAAU,EAChC,MAAM,EAAE,uCAAuC,CAC/C,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CACtD,GAAG,0DAA0D,CAAC,kBAAkB,CAAC,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CAAC,CA25FhK"}

package/dist/esm/resources/resources-config.shared.factory.js

@@ -103,6 +103,21 @@ function assertNoNestedImpersonalizeTreatment(schema, resourceIdentifier) {
         }
     }
 }
+/**
+ * A SEARCHABLE variant declares WHAT its search term matches (#2510). With none, the adapters disagreed: MongoDB ran a
+ * `$text` search against an index the framework never creates, PostgreSQL ignored the term and returned every visible
+ * row. A search surface nobody declared is a configuration error, refused where both adapters read from.
+ *
+ * `isSearchable: false` is the other honest answer: the variant filters and sorts, and the repositories refuse a
+ * non-empty search term on it (never the call itself), which is what the frontend's filter-only search sends.
+ */
+function assertSearchableVariantDeclaresFields(input) {
+    if (!input.isSearchable || input.searchableFields.length > 0)
+        return;
+    throw createConfigurationError(`Resource "${input.resourceIdentifier}" ${input.operationLabel} is searchable and declares no searchableFields. `
+        + "Declare the fields its search term matches (searchableFields: ['name', …]), or set isSearchable: false for a "
+        + 'variant that only filters and sorts (a search term is then refused; filters and sort still apply).');
+}
 function createConfigurationError(message) {
     const error = new Error(message);
     error.type = ErrorType.CONFIGURATION;
@@ -1753,14 +1768,6 @@ function isDataModeVariantKeyAllowedForOperation(operation, variant) {
         || effectiveOperation === CoreResourceOperation.LIST
         || effectiveOperation === CoreResourceOperation.SEARCH;
 }
-// --------------------------------
-// Resources Shared Configuration
-// --------------------------------
-/**
- * Creates a resource configuration from builder parameters.
- * NOTE: TDatabaseSchema has been removed. Backend-only fields are now marked with
- * the isBackendOnly decorator in mainSchema and are stripped at the service layer.
- */
 export function createResourceConfiguration_Initialization(params) {
     const { mainSchema, resourceIdentifier, resourceFieldIdentifier, resourceRelationships, inheritenceSchemaDefinition, isSystemResource = false, 
     // Defaulted TRUE — the safe direction. A resource that never considered whether its primary key
@@ -3662,6 +3669,12 @@ export function createResourceConfiguration_Initialization(params) {
                     const pageSize = variantParams.pageSize ?? 20;
                     const isSearchable = variantParams.isSearchable !== false;
                     const searchableFields = variantParams.searchableFields || [];
+                    assertSearchableVariantDeclaresFields({
+                        resourceIdentifier: String(resourceIdentifier),
+                        operationLabel: `operation "${String(operation)}"${apiCallParams.variantKey ? ` (variant "${apiCallParams.variantKey}")` : ''}`,
+                        isSearchable,
+                        searchableFields,
+                    });
                     const searchableOptions = variantParams.searchableOptions || { caseSensitive: false, fullMatchOnly: false };
                     const rawFilterFields = variantParams.filterFields || {};
                     const sortFields = variantParams.sortFields || [];
@@ -3752,6 +3765,16 @@ export function createResourceConfiguration_Initialization(params) {
             else {
                 // Handle other variant types (CronJob, BatchJob, InternalCall, RepositoryOnly)
                 const { variantType, ...specificFields } = variantParams; // Extract variantType and get rest
+                // An internal SEARCH reaches the same repositories, so it owes the same declaration (#2510 review M2). Here an
+                // absent `isSearchable` is NOT searchable (the field is copied through as authored), so only an explicit `true` owes it.
+                if (operation === CoreResourceOperation.SEARCH || variantParams.resourceOperationLike === CoreResourceOperation.SEARCH) {
+                    assertSearchableVariantDeclaresFields({
+                        resourceIdentifier: String(resourceIdentifier),
+                        operationLabel: `operation "${String(operation)}" (${String(variantType)})`,
+                        isSearchable: variantParams.isSearchable === true,
+                        searchableFields: variantParams.searchableFields || [],
+                    });
+                }
                 const nonApiCallOperation = {
                     ...baseOperationFields,
                     ...specificFields,