@portalshq/capability-identity 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @portalshq/capability-identity
+
+Cross-channel audience identity. Every other capability that needs to know
+"who is this audience member" depends on this rather than rolling its own
+auth — that's the only way a persistent cross-channel profile is possible.

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@portalshq/capability-identity",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/portalshq/portals-cloud"
+  },
+  "description": "Federated audience identity, persistent across every channel — current and future, platform-provided and developer-created.",
+  "main": "src/index.ts",
+  "dependencies": {
+    "@portalshq/contracts": "*"
+  }
+}

package/src/identity-provider.ts

@@ -0,0 +1,29 @@
+/**
+ * One identity per audience member, scoped to read across every channel
+ * they've ever touched. This is the "Netflix history, but spanning every
+ * developer-built channel" requirement — without this capability, every
+ * channel re-implements its own login and the cross-channel marketplace
+ * vision doesn't work.
+ */
+export interface AudienceIdentity {
+  userId: string;
+  displayName: string;
+}
+
+export interface ChannelHistoryEntry {
+  channelId: string;
+  sessionId: string;
+  lastInteractionAt: string;
+}
+
+export class IdentityProvider {
+  async getIdentity(userId: string): Promise<AudienceIdentity> {
+    throw new Error("IdentityProvider.getIdentity: not yet implemented");
+  }
+  async recordInteraction(entry: ChannelHistoryEntry): Promise<void> {
+    throw new Error("IdentityProvider.recordInteraction: not yet implemented");
+  }
+  async getHistory(userId: string): Promise<ChannelHistoryEntry[]> {
+    throw new Error("IdentityProvider.getHistory: not yet implemented");
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./identity-provider";