plumb-fhir 0.6.2 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.7.0 (2026-10-05)
+
+- **`stampProfiled(resource, options?)`** returns the copy `createProfiled`
+  would write, routed and stamped, without writing it: for conditional
+  creates, upserts and batch or transaction entries. It takes the same
+  options, is typed the same way, and throws the same `RoutingError` (#124).
+- The README says `updateProfiled` stamps a record that was unstamped, so
+  edits of stored records that fail the profile start being refused; and to
+  commit `fsh-generated/resources/` but gitignore SUSHI's index files (#125).
+
 ## 0.6.2 (2026-10-05)
 
 `validate` and `push` from an installed Plumb, and on Medplum's `awslambda`

package/README.md

@@ -185,8 +185,11 @@ export default defineConfig({
 ✔ sushi     1 StructureDefinitions, 0 ValueSets   6.8s
 ```
 
-- **Commit `fsh-generated/`** with the FSH. It is the JSON `push` loads into
-  Medplum, and `validateProfiled` reads it without running SUSHI.
+- **Commit `fsh-generated/resources/`** with the FSH. It is the JSON `push`
+  loads into Medplum, and `validateProfiled` reads it without running SUSHI.
+  SUSHI's own `fsh-index.txt` and `data/` are bookkeeping no command reads:
+  gitignore them. Marking the generated folders `linguist-generated` in
+  `.gitattributes` collapses them in review diffs.
 - **`generate --check` in CI** rebuilds the FSH into a temporary folder and
   fails when the committed `fsh-generated/` or the types differ from it.
 - **SUSHI's errors stop `generate`**, with their FSH file and line. Its
@@ -240,6 +243,22 @@ const saved = await createProfiled(medplum, bp); // stamped, then medplum.create
 - They take any client with `createResource` and `updateResource`, such as
   a `MedplumClient`, so the generated code needs nothing from Plumb at run
   time.
+- **`stampProfiled(resource, options?)`** returns the copy `createProfiled`
+  would write, stamped and not written, for the writes it cannot make: a
+  conditional create, an upsert, a batch or transaction entry. It takes the
+  same options and throws the same `RoutingError`:
+
+  ```ts
+  await medplum.createResourceIfNoneExist(
+    stampProfiled(coverage, { profile: USCoreCoverageProfileUrl }),
+    `identifier=${system}|${value}`,
+  );
+  ```
+
+- **Moving an edit path to `updateProfiled` stamps records that were
+  unstamped**, so the server starts holding them to the profile: an edit of a
+  stored record that does not meet it is refused from then on. Run
+  `plumb validate` and fix what fails before moving edit paths.
 
 **Keys come from each profile:** every fixed or pattern value on a required
 first-level element (a pinned `code`), and every required slice's

package/dist/cjs/emit/print.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../../src/emit/print.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAiB,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5E,uFAAuF;AACvF,eAAO,MAAM,MAAM,0BAA0B,CAAC;AAqG9C,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAgD7C;AA8UD,KAAK,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAkR5F,kHAAkH;AAClH,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,EACvC,OAAO,GAAE,YAAiF,GACzF,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBrB"}
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../../src/emit/print.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAiB,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE5E,uFAAuF;AACvF,eAAO,MAAM,MAAM,0BAA0B,CAAC;AAqG9C,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAgD7C;AA+VD,KAAK,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAkR5F,kHAAkH;AAClH,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,EACvC,OAAO,GAAE,YAAiF,GACzF,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBrB"}

package/dist/esm/cli.mjs

@@ -2313,6 +2313,23 @@ export async function createProfiled(
   return medplum.createResource(stamped(resource, options.profile ?? route(resource)));
 }
 
+/**
+ * The copy createProfiled would write, stamped and not written, for the writes
+ * it cannot make: a conditional create, an upsert, a batch or transaction
+ * entry. Options and errors as createProfiled; a RoutingError is thrown.
+ */
+export function stampProfiled<U extends ProfileUrl>(
+  resource: ProfileTypes[U],
+  options: { profile: U },
+): ProfileTypes[U];
+export function stampProfiled<T extends Resource>(resource: T, options?: { profile: false }): T;
+export function stampProfiled(
+  resource: Resource,
+  options: { profile?: ProfileUrl | false } = {},
+): Resource {
+  return stamped(resource, options.profile ?? route(resource));
+}
+
 /**
  * Updates the resource held to the profile its new content selects: the
  * stamps Plumb manages are replaced, and any other URL in \`meta.profile\` is
@@ -2663,7 +2680,7 @@ function printFiles(models, hashOf2, routing = { routes: {}, profiles: [], stamp
   index.appendNoWrap(`${MARKER}. Do not edit.`);
   index.appendNoWrap("export type { Require } from './_plumb.js';");
   index.appendNoWrap(
-    "export { createProfiled, type ProfiledClient, type ProfileTypes, type ProfileUrl, RoutingError, route, updateProfiled } from './_routes.js';"
+    "export { createProfiled, type ProfiledClient, type ProfileTypes, type ProfileUrl, RoutingError, route, stampProfiled, updateProfiled } from './_routes.js';"
   );
   index.appendNoWrap(
     "export { asProfiled, isProfiled, pickProfiled, type ProfiledQuery, type ProfiledReader, ProfileReadError, type ProfileReadFailure, readProfiled, searchProfiled } from './_reads.js';"