@stardeck-customer-apps/testing 0.5.1 → 0.6.0

package/dist/setup.mjs

@@ -63,6 +63,14 @@ var TEST_ENV_DEFAULTS = {
 // src/simulator/hmac.ts
 import crypto from "crypto";
 var TIMESTAMP_TOLERANCE_SECONDS = 300;
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function isDeploymentAuthPayload(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const payload = value;
+  return payload.type === "deployment-request" && isNonEmptyString(payload.organizationId) && isNonEmptyString(payload.projectId) && isNonEmptyString(payload.deploymentId) && typeof payload.timestamp === "number" && Number.isSafeInteger(payload.timestamp) && isNonEmptyString(payload.nonce);
+}
 function verifyDeploymentAuthHeader(secret, header) {
   const dotIndex = header.lastIndexOf(".");
   if (dotIndex === -1) return null;
@@ -80,16 +88,16 @@ function verifyDeploymentAuthHeader(secret, header) {
   if (expectedBuf.length !== actualBuf.length || !crypto.timingSafeEqual(expectedBuf, actualBuf)) {
     return null;
   }
-  let payload;
+  let parsed;
   try {
-    payload = JSON.parse(payloadJson);
+    parsed = JSON.parse(payloadJson);
   } catch {
     return null;
   }
-  if (payload.type !== "deployment-request") return null;
+  if (!isDeploymentAuthPayload(parsed)) return null;
   const now3 = Math.floor(Date.now() / 1e3);
-  if (Math.abs(now3 - payload.timestamp) > TIMESTAMP_TOLERANCE_SECONDS) return null;
-  return payload;
+  if (Math.abs(now3 - parsed.timestamp) > TIMESTAMP_TOLERANCE_SECONDS) return null;
+  return parsed;
 }
 
 // src/simulator/http.ts
@@ -586,16 +594,118 @@ var LINK_KINDS = /* @__PURE__ */ new Set([
   "project_auth_user",
   "dashboard_user"
 ]);
+var RESOLVE_KINDS = /* @__PURE__ */ new Set(["phone", "email", "line"]);
+var E164_PHONE = /^\+[1-9]\d{1,14}$/;
+var SEARCH_DEFAULT_LIMIT = 50;
+var SEARCH_MAX_LIMIT = 100;
+var IdentityGraphError = class extends Error {
+};
 function now() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
 function linksFor(identityId) {
   return state.identityLinks.filter((l) => l.identityId === identityId);
 }
+function comparableExternalId(kind, externalId) {
+  if (kind === "email") return externalId.trim().toLowerCase();
+  return externalId;
+}
+function normalizeExternalId(kind, externalId) {
+  if (kind === "email") {
+    const normalized = externalId.trim().toLowerCase();
+    return normalized.length > 0 ? { externalId: normalized } : { error: "externalId is required" };
+  }
+  if (kind === "phone" && !E164_PHONE.test(externalId)) {
+    return { error: "phone externalId must be an E.164 number" };
+  }
+  return { externalId };
+}
+function normalizeLinkInput(kind, externalId, allowedKinds, kindError) {
+  if (typeof kind !== "string" || !allowedKinds.has(kind)) {
+    return { error: kindError };
+  }
+  if (typeof externalId !== "string" || externalId.length === 0) {
+    return { error: "externalId is required" };
+  }
+  const normalized = normalizeExternalId(kind, externalId);
+  if ("error" in normalized) return normalized;
+  return { kind, externalId: normalized.externalId };
+}
+function normalizeResolveInput(kind, externalId) {
+  const normalized = normalizeLinkInput(
+    kind,
+    externalId,
+    RESOLVE_KINDS,
+    "kind must be one of: phone, email, line"
+  );
+  if ("error" in normalized) return normalized;
+  return { kind: normalized.kind, externalId: normalized.externalId };
+}
+function canonicalIdentity(identityId) {
+  const visited = /* @__PURE__ */ new Set();
+  let identity = state.identities.get(identityId);
+  while (identity) {
+    if (visited.has(identity.id)) {
+      throw new IdentityGraphError("identity merge chain contains a cycle");
+    }
+    visited.add(identity.id);
+    if (identity.status === "archived") {
+      throw new IdentityGraphError("identity is archived");
+    }
+    if (identity.status === "active" && !identity.mergedIntoId) {
+      return identity;
+    }
+    if (!identity.mergedIntoId) {
+      throw new IdentityGraphError("identity merge chain has no active canonical target");
+    }
+    identity = state.identities.get(identity.mergedIntoId);
+  }
+  throw new IdentityGraphError("identity merge chain references a missing identity");
+}
+function matchingLinks(kind, externalId) {
+  const comparable = comparableExternalId(kind, externalId);
+  return state.identityLinks.filter(
+    (link) => link.kind === kind && comparableExternalId(link.kind, link.externalId) === comparable
+  );
+}
+function createPerson(displayName) {
+  const createdAt = now();
+  const identity = {
+    id: crypto3.randomUUID(),
+    type: "person",
+    parentId: null,
+    displayName,
+    profile: {},
+    status: "active",
+    mergedIntoId: null,
+    externalRef: null,
+    createdAt,
+    updatedAt: createdAt
+  };
+  state.identities.set(identity.id, identity);
+  return identity;
+}
+function createUnverifiedLink(identityId, kind, externalId) {
+  const link = {
+    id: crypto3.randomUUID(),
+    identityId,
+    kind,
+    externalId,
+    // Deployment credentials can attest provenance, but cannot manufacture a
+    // platform-verified fact. Trusted channel/control-plane setup uses the
+    // directory's test-only seedVerifiedLink helper instead.
+    verified: false,
+    createdAt: now()
+  };
+  state.identityLinks.push(link);
+  return link;
+}
 function handleList(request) {
   const typeParam = new URL(request.url).searchParams.get("type");
   const type = typeParam === "person" || typeParam === "account" ? typeParam : void 0;
-  const identities = [...state.identities.values()];
+  const identities = [...state.identities.values()].filter(
+    (identity) => identity.status !== "merged"
+  );
   return success({ identities: type ? identities.filter((i) => i.type === type) : identities });
 }
 async function handleCreate(request) {
@@ -613,6 +723,7 @@ async function handleCreate(request) {
     }
     parentId = parent.id;
   }
+  const createdAt = now();
   const identity = {
     id: crypto3.randomUUID(),
     type,
@@ -622,8 +733,8 @@ async function handleCreate(request) {
     status: "active",
     mergedIntoId: null,
     externalRef: body.externalRef ?? null,
-    createdAt: now(),
-    updatedAt: now()
+    createdAt,
+    updatedAt: createdAt
   };
   state.identities.set(identity.id, identity);
   return success({ identity });
@@ -659,36 +770,166 @@ async function handleAttachLink(identityId, request) {
     return failure("links attach only to active persons");
   }
   const body = await readJsonBody(request);
-  const kind = body.kind;
-  const externalId = body.externalId;
-  if (typeof kind !== "string" || !LINK_KINDS.has(kind)) {
-    return failure(`kind must be one of: ${[...LINK_KINDS].join(", ")}`);
-  }
-  if (typeof externalId !== "string" || !externalId) {
-    return failure("externalId is required");
-  }
-  const existing = state.identityLinks.find((l) => l.kind === kind && l.externalId === externalId);
+  const normalized = normalizeLinkInput(
+    body.kind,
+    body.externalId,
+    LINK_KINDS,
+    `kind must be one of: ${[...LINK_KINDS].join(", ")}`
+  );
+  if ("error" in normalized) return failure(normalized.error);
+  const { kind, externalId } = normalized;
+  const [existing] = matchingLinks(kind, externalId);
   if (existing) {
     if (existing.identityId === identityId) return success({ link: existing });
     return failure("identifier already linked to another identity", 409);
   }
-  const link = {
-    id: crypto3.randomUUID(),
-    identityId,
-    kind,
-    externalId,
-    verified: body.verified === true,
-    createdAt: now()
-  };
-  state.identityLinks.push(link);
+  const link = createUnverifiedLink(identityId, kind, externalId);
   return success({ link });
 }
+async function handleResolve(request) {
+  const body = await readJsonBody(request);
+  const normalized = normalizeResolveInput(body.kind, body.externalId);
+  if ("error" in normalized) return failure(normalized.error);
+  const provenance = body.provenance;
+  if (provenance !== "guest" && provenance !== "staff") {
+    return failure("provenance must be 'guest' or 'staff'");
+  }
+  if (body.displayName !== void 0 && typeof body.displayName !== "string") {
+    return failure("displayName must be a string");
+  }
+  const links = matchingLinks(normalized.kind, normalized.externalId);
+  if (links.length > 0) {
+    const canonicalIds = /* @__PURE__ */ new Set();
+    for (const link of links) {
+      try {
+        canonicalIds.add(canonicalIdentity(link.identityId).id);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "invalid identity merge chain";
+        return failure(`cannot resolve identity link: ${message}`, 409);
+      }
+    }
+    if (canonicalIds.size !== 1) {
+      return failure("identifier is linked to multiple identities", 409);
+    }
+    const canonicalId = [...canonicalIds][0];
+    const hasVerifiedLink = links.some((link) => link.verified);
+    if (provenance === "guest" && hasVerifiedLink) {
+      return success({ identityId: null, reason: "verified_conflict" });
+    }
+    return success({ identityId: canonicalId, created: false });
+  }
+  const displayName = body.displayName ?? null;
+  const identity = createPerson(displayName);
+  createUnverifiedLink(identity.id, normalized.kind, normalized.externalId);
+  return success({ identityId: identity.id, created: true });
+}
+function encodeSearchCursor(cursor) {
+  return Buffer.from(JSON.stringify(cursor), "utf8").toString("base64url");
+}
+function decodeSearchCursor(raw, query) {
+  try {
+    const rawParsed = JSON.parse(Buffer.from(raw, "base64url").toString("utf8"));
+    if (!rawParsed || typeof rawParsed !== "object" || Array.isArray(rawParsed)) return null;
+    const parsed = rawParsed;
+    if (typeof parsed.createdAt !== "string" || typeof parsed.id !== "string" || typeof parsed.query !== "string" || parsed.query !== query) {
+      return null;
+    }
+    return { createdAt: parsed.createdAt, id: parsed.id, query: parsed.query };
+  } catch {
+    return null;
+  }
+}
+function compareIdentityOrder(left, right) {
+  const byCreatedAt = left.createdAt.localeCompare(right.createdAt);
+  return byCreatedAt !== 0 ? byCreatedAt : left.id.localeCompare(right.id);
+}
+function identityMatchesQuery(identity, query) {
+  if (!query) return true;
+  if (identity.displayName?.toLowerCase().includes(query)) return true;
+  return state.identityLinks.some(
+    (link) => link.identityId === identity.id && comparableExternalId(link.kind, link.externalId).toLowerCase().includes(query)
+  );
+}
+function handleSearch(request) {
+  const url = new URL(request.url);
+  const query = (url.searchParams.get("query") ?? "").trim().toLowerCase();
+  const rawLimit = url.searchParams.get("limit");
+  let limit = SEARCH_DEFAULT_LIMIT;
+  if (rawLimit !== null) {
+    if (!/^\d+$/.test(rawLimit)) return failure("limit must be a positive integer");
+    limit = Number(rawLimit);
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > SEARCH_MAX_LIMIT) {
+      return failure(`limit must be between 1 and ${SEARCH_MAX_LIMIT}`);
+    }
+  }
+  const rawCursor = url.searchParams.get("cursor");
+  const cursor = rawCursor ? decodeSearchCursor(rawCursor, query) : null;
+  if (rawCursor && !cursor) return failure("cursor is invalid");
+  const identities = [...state.identities.values()].filter((identity) => identity.status === "active" && identity.mergedIntoId === null).filter((identity) => identityMatchesQuery(identity, query)).sort(compareIdentityOrder);
+  const start = cursor ? identities.findIndex((identity) => compareIdentityOrder(identity, cursor) > 0) : 0;
+  const pageStart = start < 0 ? identities.length : start;
+  const items = identities.slice(pageStart, pageStart + limit);
+  const hasMore = pageStart + items.length < identities.length;
+  const nextCursor = hasMore ? encodeSearchCursor({
+    createdAt: items[items.length - 1].createdAt,
+    id: items[items.length - 1].id,
+    query
+  }) : null;
+  return success({ items, nextCursor });
+}
+function aliasesForCanonical(canonicalId) {
+  const aliases = [canonicalId];
+  for (const identity of state.identities.values()) {
+    if (identity.id === canonicalId || identity.status !== "merged") continue;
+    try {
+      if (canonicalIdentity(identity.id).id === canonicalId) aliases.push(identity.id);
+    } catch {
+    }
+  }
+  return aliases;
+}
+async function handleAliases(request) {
+  const body = await readJsonBody(request);
+  if (!Array.isArray(body.identityIds)) {
+    return failure("identityIds must be an array");
+  }
+  if (body.identityIds.length === 0) {
+    return failure("identityIds must not be empty");
+  }
+  if (body.identityIds.length > 200) {
+    return failure("A maximum of 200 identity ids may be requested");
+  }
+  if (body.identityIds.some((identityId) => typeof identityId !== "string" || identityId.length === 0)) {
+    return failure("identityIds must contain non-empty strings");
+  }
+  const aliases = {};
+  for (const identityId of body.identityIds) {
+    let canonical;
+    try {
+      canonical = canonicalIdentity(identityId);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "invalid identity merge chain";
+      return failure(`cannot expand identity aliases: ${message}`, 409);
+    }
+    aliases[canonical.id] ??= aliasesForCanonical(canonical.id);
+  }
+  return success({ aliases });
+}
 async function handleIdentitiesRequest(request, subPath) {
   const method = request.method;
   if (subPath === "" || subPath === "/") {
     if (method === "GET") return handleList(request);
     if (method === "POST") return handleCreate(request);
   }
+  if (subPath === "/resolve" && method === "POST") {
+    return handleResolve(request);
+  }
+  if (subPath === "/aliases" && method === "POST") {
+    return handleAliases(request);
+  }
+  if (subPath === "/search" && method === "GET") {
+    return handleSearch(request);
+  }
   const linksMatch = subPath.match(/^\/([^/]+)\/links$/);
   if (linksMatch && method === "POST") {
     return handleAttachLink(linksMatch[1], request);
@@ -1337,13 +1578,24 @@ function requiresDeploymentHmac(request, url) {
   const edgeMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/edge(\/.*)?$/);
   return !!(dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
 }
+function deploymentIdFromPath(url) {
+  const match = url.pathname.match(/\/api\/deployments\/([^/]+)(?:\/|$)/);
+  if (!match) return null;
+  try {
+    return decodeURIComponent(match[1]);
+  } catch {
+    return match[1];
+  }
+}
 async function handleSimulatedRequest(request, url) {
   if (url.pathname === "/sql") {
     return handleNeonSql(requireDb(), request);
   }
-  const authMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/auth\/(verify|refresh)$/);
+  const authMatch = url.pathname.match(
+    /^\/api\/deployments\/[^/]+\/auth\/(v2\/verify|verify|refresh)$/
+  );
   if (authMatch) {
-    return authMatch[1] === "verify" ? handleAuthVerify(request) : handleAuthRefresh(request);
+    return authMatch[1].endsWith("verify") ? handleAuthVerify(request) : handleAuthRefresh(request);
   }
   const dataStoreMatch = url.pathname.match(/^\/api\/data-stores\/[^/]+(\/.*)?$/);
   const isEmail = url.pathname === "/api/email/send";
@@ -1360,7 +1612,9 @@ async function handleSimulatedRequest(request, url) {
       return failure("Missing authentication header", 401);
     }
     const secret = process.env.DEPLOYMENT_SECRET;
-    if (!secret || !verifyDeploymentAuthHeader(secret, authHeader)) {
+    const authPayload = secret ? verifyDeploymentAuthHeader(secret, authHeader) : null;
+    const pathDeploymentId = deploymentIdFromPath(url);
+    if (!authPayload || pathDeploymentId !== null && authPayload.deploymentId !== pathDeploymentId) {
       return failure("Invalid authentication", 401);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/testing",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Vitest test harness for Stardeck customer apps — in-process Postgres (PGlite) plus a control-plane simulator so the real Stardeck SDKs run unmodified in tests",
   "main": "dist/index.js",
   "module": "dist/index.mjs",