@headless-lms/core 0.2.0 → 0.4.0

package/dist/entitlements/events.d.ts

@@ -27,18 +27,18 @@ declare const entitlementEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    orgUserId: import("zod").ZodString;
     createdAt: import("zod").ZodCoercedDate<unknown>;
     updatedAt: import("zod").ZodCoercedDate<unknown>;
+    source: import("zod").ZodString;
     status: import("zod").ZodEnum<{
       active: "active";
       revoked: "revoked";
     }>;
     bundleId: import("zod").ZodNullable<import("zod").ZodString>;
     contentId: import("zod").ZodNullable<import("zod").ZodString>;
-    orgUserId: import("zod").ZodString;
-    source: import("zod").ZodString;
     grantedAt: import("zod").ZodCoercedDate<unknown>;
     expiresAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
   }, import("zod/v4/core").$strip>>;
@@ -67,18 +67,18 @@ declare const entitlementEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    orgUserId: import("zod").ZodString;
     createdAt: import("zod").ZodCoercedDate<unknown>;
     updatedAt: import("zod").ZodCoercedDate<unknown>;
+    source: import("zod").ZodString;
     status: import("zod").ZodEnum<{
       active: "active";
       revoked: "revoked";
     }>;
     bundleId: import("zod").ZodNullable<import("zod").ZodString>;
     contentId: import("zod").ZodNullable<import("zod").ZodString>;
-    orgUserId: import("zod").ZodString;
-    source: import("zod").ZodString;
     grantedAt: import("zod").ZodCoercedDate<unknown>;
     expiresAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
   }, import("zod/v4/core").$strip>>;
@@ -107,18 +107,18 @@ declare const entitlementEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    orgUserId: import("zod").ZodString;
     createdAt: import("zod").ZodCoercedDate<unknown>;
     updatedAt: import("zod").ZodCoercedDate<unknown>;
+    source: import("zod").ZodString;
     status: import("zod").ZodEnum<{
       active: "active";
       revoked: "revoked";
     }>;
     bundleId: import("zod").ZodNullable<import("zod").ZodString>;
     contentId: import("zod").ZodNullable<import("zod").ZodString>;
-    orgUserId: import("zod").ZodString;
-    source: import("zod").ZodString;
     grantedAt: import("zod").ZodCoercedDate<unknown>;
     expiresAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
   }, import("zod/v4/core").$strip>>;
@@ -147,27 +147,194 @@ declare const entitlementEvents: {
     createdAt: unknown;
     updatedAt: unknown;
   }, import("zod").ZodObject<{
-    orgId: import("zod").ZodString;
     id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
+    orgUserId: import("zod").ZodString;
     createdAt: import("zod").ZodCoercedDate<unknown>;
     updatedAt: import("zod").ZodCoercedDate<unknown>;
+    source: import("zod").ZodString;
     status: import("zod").ZodEnum<{
       active: "active";
       revoked: "revoked";
     }>;
     bundleId: import("zod").ZodNullable<import("zod").ZodString>;
     contentId: import("zod").ZodNullable<import("zod").ZodString>;
+    grantedAt: import("zod").ZodCoercedDate<unknown>;
+    expiresAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
+  }, import("zod/v4/core").$strip>>;
+  entitlementEndingSoon: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    bundleId: string | null;
+    contentId: string | null;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: Date;
+    expiresAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+    communityId: string;
+  }, "entitlement.ending_soon", 1>, {
+    orgId: string;
+    id: string;
+    orgUserId: string;
+    bundleId: string | null;
+    contentId: string | null;
+    status: "active" | "revoked";
+    source: string;
+    grantedAt: unknown;
+    expiresAt: unknown;
+    createdAt: unknown;
+    updatedAt: unknown;
+    communityId: string;
+  }, import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    orgId: import("zod").ZodString;
     orgUserId: import("zod").ZodString;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
     source: import("zod").ZodString;
+    status: import("zod").ZodEnum<{
+      active: "active";
+      revoked: "revoked";
+    }>;
+    bundleId: import("zod").ZodNullable<import("zod").ZodString>;
+    contentId: import("zod").ZodNullable<import("zod").ZodString>;
     grantedAt: import("zod").ZodCoercedDate<unknown>;
     expiresAt: import("zod").ZodNullable<import("zod").ZodCoercedDate<unknown>>;
+    communityId: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>;
+  spaceMemberCreated: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    communityId: string;
+    spaceId: string;
+    orgUserId: string;
+    status: "active" | "revoked" | "requested" | "invited";
+    source: "request" | "invite" | "manual";
+    createdAt: Date;
+    updatedAt: Date;
+  }, "entitlement.space_member.created", 1>, {
+    orgId: string;
+    id: string;
+    communityId: string;
+    spaceId: string;
+    orgUserId: string;
+    status: "active" | "revoked" | "requested" | "invited";
+    source: "request" | "invite" | "manual";
+    createdAt: unknown;
+    updatedAt: unknown;
+  }, import("zod").ZodObject<{
+    orgId: import("zod").ZodString;
+    id: import("zod").ZodString;
+    communityId: import("zod").ZodString;
+    spaceId: import("zod").ZodString;
+    orgUserId: import("zod").ZodString;
+    status: import("zod").ZodEnum<{
+      active: "active";
+      revoked: "revoked";
+      requested: "requested";
+      invited: "invited";
+    }>;
+    source: import("zod").ZodEnum<{
+      request: "request";
+      invite: "invite";
+      manual: "manual";
+    }>;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
+  }, import("zod/v4/core").$strict>>;
+  spaceMemberUpdated: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    communityId: string;
+    spaceId: string;
+    orgUserId: string;
+    status: "active" | "revoked" | "requested" | "invited";
+    source: "request" | "invite" | "manual";
+    createdAt: Date;
+    updatedAt: Date;
+  }, "entitlement.space_member.updated", 1>, {
+    orgId: string;
+    id: string;
+    communityId: string;
+    spaceId: string;
+    orgUserId: string;
+    status: "active" | "revoked" | "requested" | "invited";
+    source: "request" | "invite" | "manual";
+    createdAt: unknown;
+    updatedAt: unknown;
+  }, import("zod").ZodObject<{
+    orgId: import("zod").ZodString;
+    id: import("zod").ZodString;
+    communityId: import("zod").ZodString;
+    spaceId: import("zod").ZodString;
+    orgUserId: import("zod").ZodString;
+    status: import("zod").ZodEnum<{
+      active: "active";
+      revoked: "revoked";
+      requested: "requested";
+      invited: "invited";
+    }>;
+    source: import("zod").ZodEnum<{
+      request: "request";
+      invite: "invite";
+      manual: "manual";
+    }>;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
+  }, import("zod/v4/core").$strict>>;
+  spaceMemberDeleted: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    communityId: string;
+    spaceId: string;
+    orgUserId: string;
+    status: "active" | "revoked" | "requested" | "invited";
+    source: "request" | "invite" | "manual";
+    createdAt: Date;
+    updatedAt: Date;
+  }, "entitlement.space_member.deleted", 1>, {
+    orgId: string;
+    id: string;
+    communityId: string;
+    spaceId: string;
+    orgUserId: string;
+    status: "active" | "revoked" | "requested" | "invited";
+    source: "request" | "invite" | "manual";
+    createdAt: unknown;
+    updatedAt: unknown;
+  }, import("zod").ZodObject<{
+    orgId: import("zod").ZodString;
+    id: import("zod").ZodString;
+    communityId: import("zod").ZodString;
+    spaceId: import("zod").ZodString;
+    orgUserId: import("zod").ZodString;
+    status: import("zod").ZodEnum<{
+      active: "active";
+      revoked: "revoked";
+      requested: "requested";
+      invited: "invited";
+    }>;
+    source: import("zod").ZodEnum<{
+      request: "request";
+      invite: "invite";
+      manual: "manual";
+    }>;
+    createdAt: import("zod").ZodCoercedDate<unknown>;
+    updatedAt: import("zod").ZodCoercedDate<unknown>;
+  }, import("zod/v4/core").$strict>>;
 };
 type EntitlementCreated = EventOf<typeof entitlementEvents.entitlementCreated>;
 type EntitlementUpdated = EventOf<typeof entitlementEvents.entitlementUpdated>;
 type EntitlementDeleted = EventOf<typeof entitlementEvents.entitlementDeleted>;
 type EntitlementExpired = EventOf<typeof entitlementEvents.entitlementExpired>;
+type EntitlementEndingSoon = EventOf<typeof entitlementEvents.entitlementEndingSoon>;
+type SpaceMemberCreated = EventOf<typeof entitlementEvents.spaceMemberCreated>;
+type SpaceMemberUpdated = EventOf<typeof entitlementEvents.spaceMemberUpdated>;
+type SpaceMemberDeleted = EventOf<typeof entitlementEvents.spaceMemberDeleted>;
 type EntitlementEvent = EventOfValues<typeof entitlementEvents>;
 //#endregion
-export { EntitlementCreated, EntitlementDeleted, EntitlementEvent, EntitlementExpired, EntitlementUpdated, entitlementEvents };
+export { EntitlementCreated, EntitlementDeleted, EntitlementEndingSoon, EntitlementEvent, EntitlementExpired, EntitlementUpdated, SpaceMemberCreated, SpaceMemberDeleted, SpaceMemberUpdated, entitlementEvents };
 //# sourceMappingURL=events.d.ts.map

package/dist/entitlements/events.js

@@ -1,4 +1,5 @@
-import { entitlementSchema } from "../types/schemas/entitlements.js";
+import { idSchema } from "../types/schemas/shared.js";
+import { entitlementSchema, spaceMemberSchema } from "../types/schemas/entitlements.js";
 import { defineEvent } from "../shared/events.js";
 //#region src/entitlements/events.ts
 const publicEntitlement = entitlementSchema.pick({
@@ -14,6 +15,8 @@ const publicEntitlement = entitlementSchema.pick({
 	createdAt: true,
 	updatedAt: true
 }).strip();
+const endingSoonSchema = entitlementSchema.extend({ communityId: idSchema }).strict();
+const publicEndingSoon = publicEntitlement.extend({ communityId: idSchema }).strip();
 const entitlementEvents = {
 	entitlementCreated: defineEvent({
 		type: "entitlement.created",
@@ -38,6 +41,30 @@ const entitlementEvents = {
 		version: 1,
 		data: entitlementSchema,
 		publicData: publicEntitlement
+	}),
+	entitlementEndingSoon: defineEvent({
+		type: "entitlement.ending_soon",
+		version: 1,
+		data: endingSoonSchema,
+		publicData: publicEndingSoon
+	}),
+	spaceMemberCreated: defineEvent({
+		type: "entitlement.space_member.created",
+		version: 1,
+		data: spaceMemberSchema,
+		publicData: spaceMemberSchema
+	}),
+	spaceMemberUpdated: defineEvent({
+		type: "entitlement.space_member.updated",
+		version: 1,
+		data: spaceMemberSchema,
+		publicData: spaceMemberSchema
+	}),
+	spaceMemberDeleted: defineEvent({
+		type: "entitlement.space_member.deleted",
+		version: 1,
+		data: spaceMemberSchema,
+		publicData: spaceMemberSchema
 	})
 };
 //#endregion

package/dist/entitlements/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../src/entitlements/events.ts"],"sourcesContent":["import { entitlementSchema } from '../types/schemas/index.js';\nimport { defineEvent, type EventOf, type EventOfValues } from '../shared/ports.js';\n\nconst publicEntitlement = entitlementSchema\n  .pick({\n    orgId: true,\n    id: true,\n    orgUserId: true,\n    bundleId: true,\n    contentId: true,\n    status: true,\n    source: true,\n    grantedAt: true,\n    expiresAt: true,\n    createdAt: true,\n    updatedAt: true,\n  })\n  .strip();\n\nexport const entitlementEvents = {\n  entitlementCreated: defineEvent({\n    type: 'entitlement.created',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n  entitlementUpdated: defineEvent({\n    type: 'entitlement.updated',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n  entitlementDeleted: defineEvent({\n    type: 'entitlement.deleted',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n  entitlementExpired: defineEvent({\n    type: 'entitlement.expired',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n};\n\nexport type EntitlementCreated = EventOf<typeof entitlementEvents.entitlementCreated>;\nexport type EntitlementUpdated = EventOf<typeof entitlementEvents.entitlementUpdated>;\nexport type EntitlementDeleted = EventOf<typeof entitlementEvents.entitlementDeleted>;\nexport type EntitlementExpired = EventOf<typeof entitlementEvents.entitlementExpired>;\nexport type EntitlementEvent = EventOfValues<typeof entitlementEvents>;\n"],"mappings":";;;AAGA,MAAM,oBAAoB,kBACvB,KAAK;CACJ,OAAO;CACP,IAAI;CACJ,WAAW;CACX,UAAU;CACV,WAAW;CACX,QAAQ;CACR,QAAQ;CACR,WAAW;CACX,WAAW;CACX,WAAW;CACX,WAAW;AACb,CAAC,CAAC,CACD,MAAM;AAET,MAAa,oBAAoB;CAC/B,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;AACH"}
+{"version":3,"file":"events.js","names":[],"sources":["../../src/entitlements/events.ts"],"sourcesContent":["import { entitlementSchema, idSchema, spaceMemberSchema } from '../types/schemas/index.js';\nimport { defineEvent, type EventOf, type EventOfValues } from '../shared/ports.js';\n\nconst publicEntitlement = entitlementSchema\n  .pick({\n    orgId: true,\n    id: true,\n    orgUserId: true,\n    bundleId: true,\n    contentId: true,\n    status: true,\n    source: true,\n    grantedAt: true,\n    expiresAt: true,\n    createdAt: true,\n    updatedAt: true,\n  })\n  .strip();\n\nconst endingSoonSchema = entitlementSchema.extend({ communityId: idSchema }).strict();\nconst publicEndingSoon = publicEntitlement.extend({ communityId: idSchema }).strip();\n\nexport const entitlementEvents = {\n  entitlementCreated: defineEvent({\n    type: 'entitlement.created',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n  entitlementUpdated: defineEvent({\n    type: 'entitlement.updated',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n  entitlementDeleted: defineEvent({\n    type: 'entitlement.deleted',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n  entitlementExpired: defineEvent({\n    type: 'entitlement.expired',\n    version: 1,\n    data: entitlementSchema,\n    publicData: publicEntitlement,\n  }),\n  entitlementEndingSoon: defineEvent({\n    type: 'entitlement.ending_soon',\n    version: 1,\n    data: endingSoonSchema,\n    publicData: publicEndingSoon,\n  }),\n  spaceMemberCreated: defineEvent({\n    type: 'entitlement.space_member.created',\n    version: 1,\n    data: spaceMemberSchema,\n    publicData: spaceMemberSchema,\n  }),\n  spaceMemberUpdated: defineEvent({\n    type: 'entitlement.space_member.updated',\n    version: 1,\n    data: spaceMemberSchema,\n    publicData: spaceMemberSchema,\n  }),\n  spaceMemberDeleted: defineEvent({\n    type: 'entitlement.space_member.deleted',\n    version: 1,\n    data: spaceMemberSchema,\n    publicData: spaceMemberSchema,\n  }),\n};\n\nexport type EntitlementCreated = EventOf<typeof entitlementEvents.entitlementCreated>;\nexport type EntitlementUpdated = EventOf<typeof entitlementEvents.entitlementUpdated>;\nexport type EntitlementDeleted = EventOf<typeof entitlementEvents.entitlementDeleted>;\nexport type EntitlementExpired = EventOf<typeof entitlementEvents.entitlementExpired>;\nexport type EntitlementEndingSoon = EventOf<typeof entitlementEvents.entitlementEndingSoon>;\nexport type SpaceMemberCreated = EventOf<typeof entitlementEvents.spaceMemberCreated>;\nexport type SpaceMemberUpdated = EventOf<typeof entitlementEvents.spaceMemberUpdated>;\nexport type SpaceMemberDeleted = EventOf<typeof entitlementEvents.spaceMemberDeleted>;\nexport type EntitlementEvent = EventOfValues<typeof entitlementEvents>;\n"],"mappings":";;;;AAGA,MAAM,oBAAoB,kBACvB,KAAK;CACJ,OAAO;CACP,IAAI;CACJ,WAAW;CACX,UAAU;CACV,WAAW;CACX,QAAQ;CACR,QAAQ;CACR,WAAW;CACX,WAAW;CACX,WAAW;CACX,WAAW;AACb,CAAC,CAAC,CACD,MAAM;AAET,MAAM,mBAAmB,kBAAkB,OAAO,EAAE,aAAa,SAAS,CAAC,CAAC,CAAC,OAAO;AACpF,MAAM,mBAAmB,kBAAkB,OAAO,EAAE,aAAa,SAAS,CAAC,CAAC,CAAC,MAAM;AAEnF,MAAa,oBAAoB;CAC/B,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,uBAAuB,YAAY;EACjC,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;CACD,oBAAoB,YAAY;EAC9B,MAAM;EACN,SAAS;EACT,MAAM;EACN,YAAY;CACd,CAAC;AACH"}

package/dist/entitlements/index.d.ts

@@ -1,7 +1,9 @@
 import { Page } from "../types/shared.js";
-import { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput } from "../types/schemas/entitlements.js";
-import { EntitlementCreated, EntitlementDeleted, EntitlementEvent, EntitlementExpired, EntitlementUpdated, entitlementEvents } from "./events.js";
+import { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput, SpaceMember, SpaceMemberSource, SpaceMemberStatus } from "../types/schemas/entitlements.js";
 import "./model.js";
-import { EntitlementsRepository, EntitlementsService } from "./ports.js";
+import { AccessFacts, CommunityAccessReader, EndingGrant, EndingGrantKey, EntitlementNotice, EntitlementsRepository, EntitlementsService, GrantKey, GrantTarget, InsertSpaceMemberInput, OpenableSpace, SpaceAccessRule, SpaceMembersQuery } from "./ports.js";
 import { EntitlementsServiceImpl } from "./service.js";
-export { type Entitlement, type EntitlementCreated, type EntitlementDeleted, type EntitlementEvent, type EntitlementExpired, type EntitlementStatus, type EntitlementUpdated, type EntitlementsQuery, type EntitlementsRepository, type EntitlementsService, EntitlementsServiceImpl, type GrantEntitlementInput, type Page, entitlementEvents };
+import { EntitlementCreated, EntitlementDeleted, EntitlementEndingSoon, EntitlementEvent, EntitlementExpired, EntitlementUpdated, SpaceMemberCreated, SpaceMemberDeleted, SpaceMemberUpdated, entitlementEvents } from "./events.js";
+import { seesSpace } from "./rules.js";
+import { GRANTS_EXPIRE_JOB, entitlementsJobs, entitlementsRecurringJobs } from "./jobs.js";
+export { type AccessFacts, type CommunityAccessReader, type EndingGrant, type EndingGrantKey, type Entitlement, type EntitlementCreated, type EntitlementDeleted, type EntitlementEndingSoon, type EntitlementEvent, type EntitlementExpired, type EntitlementNotice, type EntitlementStatus, type EntitlementUpdated, type EntitlementsQuery, type EntitlementsRepository, type EntitlementsService, EntitlementsServiceImpl, GRANTS_EXPIRE_JOB, type GrantEntitlementInput, type GrantKey, type GrantTarget, type InsertSpaceMemberInput, type OpenableSpace, type Page, type SpaceAccessRule, type SpaceMember, type SpaceMemberCreated, type SpaceMemberDeleted, type SpaceMemberSource, type SpaceMemberStatus, type SpaceMemberUpdated, type SpaceMembersQuery, entitlementEvents, entitlementsJobs, entitlementsRecurringJobs, seesSpace };

package/dist/entitlements/index.js

@@ -1,3 +1,5 @@
 import { entitlementEvents } from "./events.js";
+import { seesSpace } from "./rules.js";
 import { EntitlementsServiceImpl } from "./service.js";
-export { EntitlementsServiceImpl, entitlementEvents };
+import { GRANTS_EXPIRE_JOB, entitlementsJobs, entitlementsRecurringJobs } from "./jobs.js";
+export { EntitlementsServiceImpl, GRANTS_EXPIRE_JOB, entitlementEvents, entitlementsJobs, entitlementsRecurringJobs, seesSpace };

package/dist/entitlements/jobs.d.ts

@@ -0,0 +1,12 @@
+import { RecurringJob, ScheduledJob } from "../shared/ports.js";
+import { EntitlementsService } from "./ports.js";
+//#region src/entitlements/jobs.d.ts
+declare const GRANTS_EXPIRE_JOB = "entitlements.grants.expire";
+interface EntitlementsJobDeps {
+  grants: Pick<EntitlementsService, 'expireDueGrants'>;
+}
+declare function entitlementsJobs(deps: EntitlementsJobDeps): ScheduledJob[];
+declare const entitlementsRecurringJobs: RecurringJob[];
+//#endregion
+export { EntitlementsJobDeps, GRANTS_EXPIRE_JOB, entitlementsJobs, entitlementsRecurringJobs };
+//# sourceMappingURL=jobs.d.ts.map

package/dist/entitlements/jobs.js

@@ -0,0 +1,18 @@
+//#region src/entitlements/jobs.ts
+const GRANTS_EXPIRE_JOB = "entitlements.grants.expire";
+function entitlementsJobs(deps) {
+	return [{
+		job: GRANTS_EXPIRE_JOB,
+		async run(_payload, fire) {
+			await deps.grants.expireDueGrants(fire.startedAt);
+		}
+	}];
+}
+const entitlementsRecurringJobs = [{
+	job: GRANTS_EXPIRE_JOB,
+	cron: "0 * * * *"
+}];
+//#endregion
+export { GRANTS_EXPIRE_JOB, entitlementsJobs, entitlementsRecurringJobs };
+
+//# sourceMappingURL=jobs.js.map

package/dist/entitlements/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","names":[],"sources":["../../src/entitlements/jobs.ts"],"sourcesContent":["import type { RecurringJob, ScheduledJob } from '../shared/ports.js';\nimport type { EntitlementsService } from './ports.js';\n\nexport const GRANTS_EXPIRE_JOB = 'entitlements.grants.expire';\n\nexport interface EntitlementsJobDeps {\n  grants: Pick<EntitlementsService, 'expireDueGrants'>;\n}\n\nexport function entitlementsJobs(deps: EntitlementsJobDeps): ScheduledJob[] {\n  return [\n    {\n      job: GRANTS_EXPIRE_JOB,\n      async run(_payload, fire) {\n        await deps.grants.expireDueGrants(fire.startedAt);\n      },\n    },\n  ];\n}\n\nexport const entitlementsRecurringJobs: RecurringJob[] = [\n  { job: GRANTS_EXPIRE_JOB, cron: '0 * * * *' },\n];\n"],"mappings":";AAGA,MAAa,oBAAoB;AAMjC,SAAgB,iBAAiB,MAA2C;CAC1E,OAAO,CACL;EACE,KAAK;EACL,MAAM,IAAI,UAAU,MAAM;GACxB,MAAM,KAAK,OAAO,gBAAgB,KAAK,SAAS;EAClD;CACF,CACF;AACF;AAEA,MAAa,4BAA4C,CACvD;CAAE,KAAK;CAAmB,MAAM;AAAY,CAC9C"}

package/dist/entitlements/model.d.ts

@@ -1,4 +1,5 @@
 import { Page } from "../types/shared.js";
-import { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput } from "../types/schemas/entitlements.js";
+import { ContentType } from "../types/schemas/content.js";
+import { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput, SpaceMember, SpaceMemberSource, SpaceMemberStatus } from "../types/schemas/entitlements.js";
 import "../types/index.js";
-export type { Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput, Page };
+export type { ContentType, Entitlement, EntitlementStatus, EntitlementsQuery, GrantEntitlementInput, Page, SpaceMember, SpaceMemberSource, SpaceMemberStatus };

package/dist/entitlements/ports.d.ts

@@ -1,34 +1,151 @@
 import { Page } from "../types/shared.js";
-import { Entitlement, EntitlementsQuery, GrantEntitlementInput } from "../types/schemas/entitlements.js";
+import { ContentType, Space } from "../types/schemas/content.js";
+import { Role } from "../types/schemas/organizations.js";
+import { Entitlement, EntitlementsQuery, GrantEntitlementInput, SpaceMember, SpaceMemberSource, SpaceMemberStatus } from "../types/schemas/entitlements.js";
 import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
+import { Actor } from "../shared/actor.js";
+import { SpaceRowLock } from "../content/ports.js";
+import "../content/index.js";
 import "./model.js";
+import "../organizations/index.js";
 //#region src/entitlements/ports.d.ts
-interface EntitlementsService {
+interface GrantTarget {
+  contentId: string | null;
+  bundleId: string | null;
+}
+type SpaceAccessRule = 'all_members' | 'by_request' | 'by_invite';
+interface OpenableSpace {
+  id: string;
+  communityId: string;
+  accessRule: SpaceAccessRule;
+}
+interface CommunityAccessReader {
+  isCommunityMember(orgId: string, actor: Actor, communityId: string): Promise<boolean>;
+  canOpenSpace(orgId: string, actor: Actor, spaceId: string): Promise<boolean>;
+  canOpen(orgId: string, actor: Actor, space: OpenableSpace): Promise<boolean>;
+  openSpaceIds(orgId: string, actor: Actor, communityId: string): Promise<string[]>;
+  openSpacesFor(orgId: string, actor: Actor, communityId: string): Promise<Space[]>;
+  spaceStandings(orgId: string, actor: Actor, communityId: string): Promise<Record<string, SpaceMember['status']>>;
+  communityMembersAmong(orgId: string, communityId: string, orgUserIds: string[]): Promise<string[]>;
+  spaceOpenersAmong(orgId: string, spaceId: string, orgUserIds: string[]): Promise<string[]>;
+  spaceOpeners(orgId: string, spaceId: string): Promise<string[]>;
+}
+type EntitlementNotice = {
+  kind: 'expired';
+  entitlementId: string;
+  expiresAt: Date;
+} | {
+  kind: 'ending_soon';
+  entitlementId: string;
+  communityId: string;
+  expiresAt: Date;
+};
+interface EndingGrant {
+  grant: Entitlement;
+  communityId: string;
+}
+interface EndingGrantKey {
+  entitlementId: string;
+  communityId: string;
+}
+interface AccessFacts {
+  orgUserId: string;
+  role: Role;
+  member: boolean;
+  activeInSpace: boolean;
+}
+interface GrantKey {
+  orgUserId: string;
+  contentId?: string | null;
+  bundleId?: string | null;
+}
+interface SpaceMembersQuery {
+  page: number;
+  pageSize: number;
+  statuses?: SpaceMemberStatus[];
+}
+interface InsertSpaceMemberInput {
+  communityId: string;
+  spaceId: string;
+  orgUserId: string;
+  status: SpaceMemberStatus;
+  source: SpaceMemberSource;
+}
+interface EntitlementsService extends CommunityAccessReader {
   list(orgId: string, query: EntitlementsQuery): Promise<Page<Entitlement>>;
   grant(orgId: string, input: GrantEntitlementInput): Promise<Entitlement>;
+  ensureGrant(orgId: string, input: GrantEntitlementInput): Promise<Entitlement>;
   setStatus(orgId: string, id: string, status: 'active' | 'revoked'): Promise<Entitlement | null>;
-  /** Whether this org user currently holds active access to the course.
-   *  The authority for course access — a reporting read must never be used to
-   *  infer it. */
-  hasCourseAccess(orgId: string, orgUserId: string, courseId: string): Promise<boolean>;
+  /** Whether this org user can open the content right now, through a grant to
+   *  it or to a bundle holding it. The only access check — nothing else may
+   *  derive access from grants. */
+  hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;
+  /** Ids of the content this org user can open right now, optionally of one type. */
+  listAccessibleContent(orgId: string, orgUserId: string, type?: ContentType): Promise<string[]>;
+  requestJoin(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceMember>;
+  invite(orgId: string, actor: Actor, communityId: string, spaceId: string, orgUserId: string): Promise<SpaceMember>;
+  addSpaceMember(orgId: string, actor: Actor, communityId: string, spaceId: string, orgUserId: string): Promise<SpaceMember>;
+  accept(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceMember>;
+  approve(orgId: string, actor: Actor, communityId: string, spaceId: string, orgUserId: string): Promise<SpaceMember>;
+  decline(orgId: string, actor: Actor, communityId: string, spaceId: string, orgUserId: string): Promise<SpaceMember>;
+  refuse(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceMember>;
+  leave(orgId: string, actor: Actor, communityId: string, spaceId: string): Promise<SpaceMember>;
+  remove(orgId: string, actor: Actor, communityId: string, spaceId: string, orgUserId: string): Promise<SpaceMember>;
+  listSpaceMembers(orgId: string, actor: Actor, communityId: string, spaceId: string, query: {
+    page: number;
+    pageSize: number;
+  }): Promise<Page<SpaceMember>>;
+  expireDueGrants(now: Date): Promise<void>;
+  communitiesOpenedBy(orgId: string, grant: GrantTarget): Promise<string[]>;
+  communityModeratorIds(orgId: string, communityId: string): Promise<string[]>;
+  communityIdsOpenedFor(orgId: string, orgUserId: string): Promise<string[]>;
+  openCommunityIds(orgId: string, actor: Actor): Promise<string[]>;
+  communityMemberIds(orgId: string, communityId: string): Promise<string[]>;
+  contentHolderIds(orgId: string, contentId: string): Promise<string[]>;
+  countActiveSpaceMembers(orgId: string, spaceId: string): Promise<number>;
 }
 interface EntitlementsRepository {
   list(orgId: string, query: EntitlementsQuery): Promise<Page<Entitlement>>;
   insert(orgId: string, input: GrantEntitlementInput): Promise<Entitlement>;
+  insertIfAbsent(orgId: string, input: GrantEntitlementInput): Promise<Entitlement | null>;
+  lockGrant(orgId: string, key: GrantKey): Promise<Entitlement | null>;
+  setExpiresAt(orgId: string, id: string, expiresAt: Date | null): Promise<Entitlement | null>;
   setStatus(orgId: string, id: string, status: 'active' | 'revoked'): Promise<Entitlement | null>;
-  /** Whether this org user currently holds active access to the course.
-   *  The authority for course access — a reporting read must never be used to
-   *  infer it. */
-  hasCourseAccess(orgId: string, orgUserId: string, courseId: string): Promise<boolean>;
+  hasAccess(orgId: string, orgUserId: string, contentId: string): Promise<boolean>;
+  listAccessibleContent(orgId: string, orgUserId: string, type?: ContentType): Promise<string[]>;
+  hasCommunityAccess(orgId: string, orgUserId: string, communityId: string): Promise<boolean>;
+  communitiesOpenedBy(orgId: string, grant: GrantTarget): Promise<string[]>;
+  accessAmong(orgId: string, communityId: string, spaceId: string | null, orgUserIds: string[]): Promise<AccessFacts[]>;
+  findSpaceMember(orgId: string, spaceId: string, orgUserId: string): Promise<SpaceMember | null>;
+  listSpaceMembersFor(orgId: string, orgUserId: string, communityId: string): Promise<SpaceMember[]>;
+  lockSpaceMember(orgId: string, spaceId: string, orgUserId: string): Promise<SpaceMember | null>;
+  listSpaceMembers(orgId: string, spaceId: string, query: SpaceMembersQuery): Promise<Page<SpaceMember>>;
+  insertSpaceMember(orgId: string, input: InsertSpaceMemberInput): Promise<SpaceMember>;
+  updateSpaceMemberStatus(orgId: string, id: string, status: SpaceMemberStatus): Promise<SpaceMember | null>;
+  deleteSpaceMember(orgId: string, id: string): Promise<void>;
+  countActiveSpaceMembers(orgId: string, spaceId: string): Promise<number>;
+  activeSpaceIds(orgId: string, orgUserId: string, communityId: string): Promise<string[]>;
+  /** Expired grants with no expiry notice, in id order, after `afterId` when given. */
+  listGrantsExpiredBy(orgId: string, now: Date, limit: number, afterId?: string): Promise<Entitlement[]>;
+  /** Grants ending in the window with no notice, in (grant id, community id) order, after `afterKey`. */
+  listGrantsEndingBetween(orgId: string, after: Date, until: Date, limit: number, afterKey?: EndingGrantKey): Promise<EndingGrant[]>;
+  orgIdsWithDueNotices(now: Date, until: Date): Promise<string[]>;
+  claimNotice(orgId: string, notice: EntitlementNotice, now: Date): Promise<boolean>;
+  communityModeratorIds(orgId: string, communityId: string): Promise<string[]>;
+  communityMemberIds(orgId: string, communityId: string): Promise<string[]>;
+  communityIdsOpenedFor(orgId: string, orgUserId: string): Promise<string[]>;
+  openCommunityIds(orgId: string, orgUserId: string): Promise<string[]>;
+  contentHolderIds(orgId: string, contentId: string): Promise<string[]>;
 }
 /** Tx-scoped port bundle for this context's mutating use cases — every member
  *  is bound to the UnitOfWork's transaction, so the write and the event append
  *  commit or roll back as one. */
 interface EntitlementsTxScope {
   entitlements: EntitlementsRepository;
+  spaces: SpaceRowLock;
   outbox: OutboxAppender;
 }
 type EntitlementsUnitOfWork = UnitOfWork<EntitlementsTxScope>;
 //#endregion
-export { EntitlementsRepository, EntitlementsService, EntitlementsTxScope, EntitlementsUnitOfWork };
+export { AccessFacts, CommunityAccessReader, EndingGrant, EndingGrantKey, EntitlementNotice, EntitlementsRepository, EntitlementsService, EntitlementsTxScope, EntitlementsUnitOfWork, GrantKey, GrantTarget, InsertSpaceMemberInput, OpenableSpace, SpaceAccessRule, SpaceMembersQuery };
 //# sourceMappingURL=ports.d.ts.map

package/dist/entitlements/rules.d.ts

@@ -0,0 +1,12 @@
+import { Role } from "../types/schemas/organizations.js";
+import { SpaceMemberStatus } from "../types/schemas/entitlements.js";
+import "./model.js";
+import "../organizations/index.js";
+import { SpaceAccessRule } from "./ports.js";
+//#region src/entitlements/rules.d.ts
+declare function opensSpace(role: Role, member: boolean, accessRule: SpaceAccessRule, activeInSpace: boolean): boolean;
+declare function seesSpace(role: Role, accessRule: SpaceAccessRule, status: SpaceMemberStatus | undefined): boolean;
+declare function laterExpiry(a: Date | null, b: Date | null): Date | null;
+//#endregion
+export { laterExpiry, opensSpace, seesSpace };
+//# sourceMappingURL=rules.d.ts.map

package/dist/entitlements/rules.js

@@ -0,0 +1,17 @@
+import { canModerate } from "../organizations/roles.js";
+//#region src/entitlements/rules.ts
+function opensSpace(role, member, accessRule, activeInSpace) {
+	if (!member) return false;
+	return canModerate(role) || accessRule === "all_members" || activeInSpace;
+}
+function seesSpace(role, accessRule, status) {
+	return canModerate(role) || accessRule !== "by_invite" || status !== void 0 && status !== "revoked";
+}
+function laterExpiry(a, b) {
+	if (a === null || b === null) return null;
+	return a.getTime() >= b.getTime() ? a : b;
+}
+//#endregion
+export { laterExpiry, opensSpace, seesSpace };
+
+//# sourceMappingURL=rules.js.map

package/dist/entitlements/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","names":[],"sources":["../../src/entitlements/rules.ts"],"sourcesContent":["import { canModerate, type Role } from '../organizations/index.js';\nimport type { SpaceAccessRule } from './ports.js';\nimport type { SpaceMemberStatus } from './model.js';\n\nexport function opensSpace(\n  role: Role,\n  member: boolean,\n  accessRule: SpaceAccessRule,\n  activeInSpace: boolean,\n): boolean {\n  if (!member) {\n    return false;\n  }\n  return canModerate(role) || accessRule === 'all_members' || activeInSpace;\n}\n\nexport function seesSpace(\n  role: Role,\n  accessRule: SpaceAccessRule,\n  status: SpaceMemberStatus | undefined,\n): boolean {\n  return (\n    canModerate(role) ||\n    accessRule !== 'by_invite' ||\n    (status !== undefined && status !== 'revoked')\n  );\n}\n\nexport function laterExpiry(a: Date | null, b: Date | null): Date | null {\n  if (a === null || b === null) {\n    return null;\n  }\n  return a.getTime() >= b.getTime() ? a : b;\n}\n"],"mappings":";;AAIA,SAAgB,WACd,MACA,QACA,YACA,eACS;CACT,IAAI,CAAC,QACH,OAAO;CAET,OAAO,YAAY,IAAI,KAAK,eAAe,iBAAiB;AAC9D;AAEA,SAAgB,UACd,MACA,YACA,QACS;CACT,OACE,YAAY,IAAI,KAChB,eAAe,eACd,WAAW,KAAA,KAAa,WAAW;AAExC;AAEA,SAAgB,YAAY,GAAgB,GAA6B;CACvE,IAAI,MAAM,QAAQ,MAAM,MACtB,OAAO;CAET,OAAO,EAAE,QAAQ,KAAK,EAAE,QAAQ,IAAI,IAAI;AAC1C"}