@elaraai/e3-cloud-types 1.0.94 → 1.1.0

package/README.md

@@ -5,8 +5,16 @@ shared by its clients (`@elaraai/e3-cloud-client`, the `e3-cloud` CLI and the
 web console).
 
 Every type is an East type (`StructType`, `VariantType`, …), sent as BEAST2,
-with its TypeScript type derived by `ValueTypeOf`. The version is the
-@elaraai lockstep it is built against, the same as east's and e3's.
+with its TypeScript type derived by `ValueTypeOf`. Its version is e3 cloud's
+own, shared by every `@elaraai/e3-cloud-*` package and independent of east's
+and e3's; each release is built with one release of east and e3.
+
+Every time is an East DateTime (`DateTimeType`, a `Date` in TypeScript), never
+text: print one with east's `printFor(DateTimeType)` (`2026-11-02T08:01:52.123`,
+in UTC) and order them with `compareFor(DateTimeType)`. Before 1.1.0 an
+invitation's, a repository user's, a schedule's and Admin › Users' times were
+ISO 8601 Strings: a client of 1.1.0 or later needs a platform of 1.1.0 or
+later, and an older client an older platform.
 
 ## Installation
 
@@ -14,7 +22,9 @@ with its TypeScript type derived by `ValueTypeOf`. The version is the
 npm install @elaraai/e3-cloud-types
 ```
 
-Its peers are `@elaraai/east` and `@elaraai/e3-types` of the same lockstep.
+Its peers are `@elaraai/east` and `@elaraai/e3-types` of the release it is
+built with, which each version pins exactly (`npm view
+@elaraai/e3-cloud-types peerDependencies` names them).
 
 ## Usage
 
@@ -51,7 +61,7 @@ const user: RepoUser = {
   name: some('Alice Smith'),
   role: variant('owner', null),
   addedBy: 'abc123-def456',
-  addedAt: '2025-01-29T10:00:00Z',
+  addedAt: new Date(Date.UTC(2025, 0, 29, 10)),
 };
 ```
 
@@ -82,7 +92,7 @@ A user entry in a repository's ACL:
 - `name` - Optional display name (OptionType)
 - `role` - User's role on the repository (RepoRoleType)
 - `addedBy` - userId of who added this entry
-- `addedAt` - ISO 8601 timestamp
+- `addedAt` - when they were added (a DateTime)
 
 `RepoInvitationType` is a person added who has not signed in yet: their email, the role they will get, and when they were invited.
 
@@ -109,7 +119,7 @@ A workspace schedule for recurring dataflow execution:
 - `enabled` - Whether schedule is active
 - `description` - Optional human-readable description (OptionType)
 - `createdBy` - userId who created the schedule
-- `createdAt` / `updatedAt` - ISO 8601 timestamps
+- `createdAt` / `updatedAt` - when it was created and last changed (DateTimes)
 - `schedulerName` - the schedule's name with the deployment's scheduler
 
 ### ScheduleRequestType / ScheduleRequest

package/dist/src/admin-user-types.d.ts

@@ -11,7 +11,7 @@
  * with no directory record yet is its own row (`status: invited`,
  * `sub: none`).
  */
-import { ArrayType, BooleanType, StructType, StringType, VariantType, NullType, OptionType, type ValueTypeOf } from '@elaraai/east';
+import { ArrayType, BooleanType, DateTimeType, StructType, StringType, VariantType, NullType, OptionType, type ValueTypeOf } from '@elaraai/east';
 /** One repo membership shown on an admin user row. */
 export declare const AdminUserMembershipType: StructType<{
     readonly repo: StringType;
@@ -73,8 +73,8 @@ export declare const AdminUserType: StructType<{
             }>;
         }>>;
         readonly invitedBy: StringType;
-        readonly invitedAt: StringType;
-        readonly expiresAt: StringType;
+        readonly invitedAt: DateTimeType;
+        readonly expiresAt: DateTimeType;
         readonly status: VariantType<{
             readonly pending: NullType;
             readonly claimed: NullType;
@@ -87,15 +87,15 @@ export declare const AdminUserType: StructType<{
                 readonly failed: NullType;
             }>;
             readonly detail: OptionType<StringType>;
-            readonly at: StringType;
+            readonly at: DateTimeType;
         }>>;
         readonly claimedBy: OptionType<StringType>;
-        readonly claimedAt: OptionType<StringType>;
+        readonly claimedAt: OptionType<DateTimeType>;
     }>>;
-    /** ISO timestamp of the user's most recent authenticated request (sampled hourly) */
-    readonly lastSeenAt: OptionType<StringType>;
-    /** ISO timestamp the directory record was created */
-    readonly createdAt: OptionType<StringType>;
+    /** When the user last made an authenticated request (sampled hourly) */
+    readonly lastSeenAt: OptionType<DateTimeType>;
+    /** When the directory record was created */
+    readonly createdAt: OptionType<DateTimeType>;
 }>;
 export type AdminUser = ValueTypeOf<typeof AdminUserType>;
 export declare const AdminUserListType: ArrayType<StructType<{
@@ -133,8 +133,8 @@ export declare const AdminUserListType: ArrayType<StructType<{
             }>;
         }>>;
         readonly invitedBy: StringType;
-        readonly invitedAt: StringType;
-        readonly expiresAt: StringType;
+        readonly invitedAt: DateTimeType;
+        readonly expiresAt: DateTimeType;
         readonly status: VariantType<{
             readonly pending: NullType;
             readonly claimed: NullType;
@@ -147,15 +147,15 @@ export declare const AdminUserListType: ArrayType<StructType<{
                 readonly failed: NullType;
             }>;
             readonly detail: OptionType<StringType>;
-            readonly at: StringType;
+            readonly at: DateTimeType;
         }>>;
         readonly claimedBy: OptionType<StringType>;
-        readonly claimedAt: OptionType<StringType>;
+        readonly claimedAt: OptionType<DateTimeType>;
     }>>;
-    /** ISO timestamp of the user's most recent authenticated request (sampled hourly) */
-    readonly lastSeenAt: OptionType<StringType>;
-    /** ISO timestamp the directory record was created */
-    readonly createdAt: OptionType<StringType>;
+    /** When the user last made an authenticated request (sampled hourly) */
+    readonly lastSeenAt: OptionType<DateTimeType>;
+    /** When the directory record was created */
+    readonly createdAt: OptionType<DateTimeType>;
 }>>;
 export type AdminUserList = ValueTypeOf<typeof AdminUserListType>;
 /**

package/dist/src/admin-user-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-user-types.d.ts","sourceRoot":"","sources":["../../src/admin-user-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAIvB,sDAAsD;AACtD,eAAO,MAAM,uBAAuB;;;;;;;;EAGlC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,0EAA0E;;IAE1E,6CAA6C;;IAE7C,+CAA+C;;;;;;;IAG/C,qFAAqF;;;;;;;;;;IAErF,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElE,qFAAqF;;IAErF,qDAAqD;;EAErD,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;IAlB5B,0EAA0E;;IAE1E,6CAA6C;;IAE7C,+CAA+C;;;;;;;IAG/C,qFAAqF;;;;;;;;;;IAErF,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElE,qFAAqF;;IAErF,qDAAqD;;GAKE,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;IAIrB,+BAA+B;;EAE/B,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;IALzB,+BAA+B;;GAKkB,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,MAAM,CAAC"}
+{"version":3,"file":"admin-user-types.d.ts","sourceRoot":"","sources":["../../src/admin-user-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAIvB,sDAAsD;AACtD,eAAO,MAAM,uBAAuB;;;;;;;;EAGlC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,0EAA0E;;IAE1E,6CAA6C;;IAE7C,+CAA+C;;;;;;;IAG/C,qFAAqF;;;;;;;;;;IAErF,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElE,wEAAwE;;IAExE,4CAA4C;;EAE5C,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;IAlB5B,0EAA0E;;IAE1E,6CAA6C;;IAE7C,+CAA+C;;;;;;;IAG/C,qFAAqF;;;;;;;;;;IAErF,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElE,wEAAwE;;IAExE,4CAA4C;;GAKW,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;IAIrB,+BAA+B;;EAE/B,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;;;IALzB,+BAA+B;;GAKkB,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,MAAM,CAAC"}

package/dist/src/admin-user-types.js

@@ -11,7 +11,7 @@
  * with no directory record yet is its own row (`status: invited`,
  * `sub: none`).
  */
-import { ArrayType, BooleanType, StructType, StringType, VariantType, NullType, OptionType, } from '@elaraai/east';
+import { ArrayType, BooleanType, DateTimeType, StructType, StringType, VariantType, NullType, OptionType, } from '@elaraai/east';
 import { RepoRoleType } from './repo-role.js';
 import { InvitationType } from './invitation-types.js';
 /** One repo membership shown on an admin user row. */
@@ -45,10 +45,10 @@ export const AdminUserType = StructType({
     memberships: ArrayType(AdminUserMembershipType),
     /** The invitation for this email (any status), when one exists */
     invitation: OptionType(InvitationType),
-    /** ISO timestamp of the user's most recent authenticated request (sampled hourly) */
-    lastSeenAt: OptionType(StringType),
-    /** ISO timestamp the directory record was created */
-    createdAt: OptionType(StringType),
+    /** When the user last made an authenticated request (sampled hourly) */
+    lastSeenAt: OptionType(DateTimeType),
+    /** When the directory record was created */
+    createdAt: OptionType(DateTimeType),
 });
 export const AdminUserListType = ArrayType(AdminUserType);
 /**

package/dist/src/admin-user-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-user-types.js","sourceRoot":"","sources":["../../src/admin-user-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,GAEX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,sDAAsD;AACtD,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;IAChD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,YAAY;CACnB,CAAC,CAAC;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,0EAA0E;IAC1E,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC;IAC3B,6CAA6C;IAC7C,KAAK,EAAE,UAAU;IACjB,+CAA+C;IAC/C,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,mBAAmB;IAC3B,qFAAqF;IACrF,WAAW,EAAE,SAAS,CAAC,uBAAuB,CAAC;IAC/C,kEAAkE;IAClE,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC;IACtC,qFAAqF;IACrF,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;IAClC,qDAAqD;IACrD,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CAClC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;AAG1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACnC,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,WAAW;CACrB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAGpD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"admin-user-types.js","sourceRoot":"","sources":["../../src/admin-user-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,GAEX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,sDAAsD;AACtD,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;IAChD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,YAAY;CACnB,CAAC,CAAC;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,0EAA0E;IAC1E,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC;IAC3B,6CAA6C;IAC7C,KAAK,EAAE,UAAU;IACjB,+CAA+C;IAC/C,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,mBAAmB;IAC3B,qFAAqF;IACrF,WAAW,EAAE,SAAS,CAAC,uBAAuB,CAAC;IAC/C,kEAAkE;IAClE,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC;IACtC,wEAAwE;IACxE,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC;IACpC,4CAA4C;IAC5C,SAAS,EAAE,UAAU,CAAC,YAAY,CAAC;CACpC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;AAG1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;IACnC,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,WAAW;CACrB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAGpD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC"}