sos-data-utils-ts 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.1
+
+- Add the shared product-neutral Task artifact schema backed by canonical flat
+  FHIR-like claims from `gdc-common-utils-ts`.
+- Require standard `Task.status` and `Task.intent` instead of making a UI
+  display label mandatory for machine-created jobs.
+
 ## 0.2.0
 
 - Add the shared sector-and-country organization-verification policy for

package/README.md

@@ -1,8 +1,9 @@
 # sos-data-utils-ts
 
 Product-neutral contracts shared outward from SOS channel infrastructure into
-human-health and animal products. This package has no dependency on GW CORE,
-`gdc-*`, `uhc-*` or `vet-*` packages.
+human-health and animal products. It may reuse product-neutral canonical
+vocabulary from `gdc-common-utils-ts`, but has no dependency on GW CORE or any
+`uhc-*` or `vet-*` package.
 
 The first contract defines capability-based BFF route roots. Public products
 use `/api/assistant/*`; `/api/internal/*` is reserved for authenticated
@@ -16,6 +17,11 @@ Sector behavior remains in its owner:
 - `vet-*`: animal/veterinary extensions;
 - the terminology service: international terminology and regional catalogs.
 
+The shared Task authoring schema uses canonical flat FHIR-like claims from
+`gdc-common-utils-ts`. `Task.status` and `Task.intent` are mandatory; display,
+correlation and output claims remain optional so the same contract supports
+human work items and machine-created asynchronous jobs.
+
 The organization-verification contract resolves policy by business sector and
 ISO country. The governed CA/US profiles are:
 

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './bff-api.js';
 export * from './organization-verification-policy.js';
+export * from './task-artifact-schema.js';

package/dist/index.js

@@ -1,2 +1,3 @@
 export * from './bff-api.js';
 export * from './organization-verification-policy.js';
+export * from './task-artifact-schema.js';

package/dist/task-artifact-schema.d.ts

@@ -0,0 +1,13 @@
+export { TaskClaim } from 'gdc-common-utils-ts/models/interoperable-claims/task-claims';
+/** Product-neutral authoring contract for flat FHIR-like Task claims. */
+export type TaskArtifactSchemaContract = Readonly<{
+    resourceType: 'Task';
+    requiredClaims: readonly string[];
+    optionalClaims: readonly string[];
+}>;
+/**
+ * Shared Task contract used by human, animal, service and asynchronous-job
+ * channels. FHIR requires both status and intent; presentation fields remain
+ * optional because a machine-created job need not have a display title.
+ */
+export declare const TaskArtifactSchema: TaskArtifactSchemaContract;

package/dist/task-artifact-schema.js

@@ -0,0 +1,61 @@
+import { TaskClaim } from 'gdc-common-utils-ts/models/interoperable-claims/task-claims';
+export { TaskClaim } from 'gdc-common-utils-ts/models/interoperable-claims/task-claims';
+/**
+ * Shared Task contract used by human, animal, service and asynchronous-job
+ * channels. FHIR requires both status and intent; presentation fields remain
+ * optional because a machine-created job need not have a display title.
+ */
+export const TaskArtifactSchema = Object.freeze({
+    resourceType: 'Task',
+    requiredClaims: Object.freeze([
+        TaskClaim.Status,
+        TaskClaim.Intent,
+    ]),
+    optionalClaims: Object.freeze([
+        TaskClaim.Id,
+        TaskClaim.Identifier,
+        TaskClaim.GroupIdentifier,
+        TaskClaim.StatusReason,
+        TaskClaim.BusinessStatus,
+        TaskClaim.Code,
+        TaskClaim.Description,
+        TaskClaim.Subject,
+        TaskClaim.For,
+        TaskClaim.Requester,
+        TaskClaim.Owner,
+        TaskClaim.Focus,
+        TaskClaim.PartOf,
+        TaskClaim.BasedOn,
+        TaskClaim.BasedOnDisplay,
+        TaskClaim.Language,
+        TaskClaim.Channel,
+        TaskClaim.AuthoredOn,
+        TaskClaim.LastModified,
+        TaskClaim.ScheduledAt,
+        TaskClaim.RetryIntervalMinutes,
+        TaskClaim.MaxAttempts,
+        TaskClaim.TriggerType,
+        TaskClaim.Attempt,
+        TaskClaim.WindowStart,
+        TaskClaim.WindowEnd,
+        TaskClaim.AutoCloseAt,
+        TaskClaim.EscalationRecipient,
+        TaskClaim.Confirmed,
+        TaskClaim.ConfirmedAt,
+        TaskClaim.Repetitions,
+        TaskClaim.DaysOfWeek,
+        TaskClaim.RepeatCount,
+        TaskClaim.RepeatDurationValue,
+        TaskClaim.RepeatDurationUnit,
+        TaskClaim.Modified,
+        TaskClaim.Priority,
+        TaskClaim.RestrictionPeriodStart,
+        TaskClaim.RestrictionPeriodEnd,
+        TaskClaim.ExecutionPeriodStart,
+        TaskClaim.ExecutionPeriodEnd,
+        TaskClaim.OutputType,
+        TaskClaim.OutputValueReference,
+        TaskClaim.OutputValueString,
+        TaskClaim.UserSelected,
+    ]),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sos-data-utils-ts",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Product-neutral SOS channel and BFF contract utilities",
   "license": "Apache-2.0",
   "type": "module",
@@ -18,6 +18,10 @@
     "./organization-verification-policy": {
       "types": "./dist/organization-verification-policy.d.ts",
       "default": "./dist/organization-verification-policy.js"
+    },
+    "./task-artifact-schema": {
+      "types": "./dist/task-artifact-schema.d.ts",
+      "default": "./dist/task-artifact-schema.js"
     }
   },
   "files": [
@@ -41,6 +45,9 @@
     "node": ">=24"
   },
   "private": false,
+  "dependencies": {
+    "gdc-common-utils-ts": "2.9.21"
+  },
   "publishConfig": {
     "access": "public"
   }