@stamprally/server 0.19.0 → 0.20.1

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as _stamprally_core from '@stamprally/core';
-import { UserRallyState, AdminRallyConfig } from '@stamprally/core';
-export { UserRallyState } from '@stamprally/core';
+import { UserRallyState, AdminRallyConfig, SyncProgressResponse } from '@stamprally/core';
+export { SyncOperationResult, SyncProgressResponse, UserRallyState } from '@stamprally/core';
 
 /** Authentication already verified by the host application's middleware. */
 interface TrustedAuthContext {
@@ -276,7 +276,7 @@ declare class StampRallyServer {
     checkIn(request: CheckInRequest, authContext?: TrustedAuthContext): Promise<CheckInResponse>;
     claimReward(request: ClaimRewardRequest, authContext?: TrustedAuthContext): Promise<ClaimResponse>;
     sync(rallyId: string, identity: string | TrustedAuthContext): Promise<UserRallyState>;
-    syncProgress(request: SyncProgressRequest, authContext: TrustedAuthContext): Promise<UserRallyState>;
+    syncProgress(request: SyncProgressRequest, authContext: TrustedAuthContext): Promise<SyncProgressResponse>;
 }
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _stamprally_core from '@stamprally/core';
-import { UserRallyState, AdminRallyConfig } from '@stamprally/core';
-export { UserRallyState } from '@stamprally/core';
+import { UserRallyState, AdminRallyConfig, SyncProgressResponse } from '@stamprally/core';
+export { SyncOperationResult, SyncProgressResponse, UserRallyState } from '@stamprally/core';
 
 /** Authentication already verified by the host application's middleware. */
 interface TrustedAuthContext {
@@ -276,7 +276,7 @@ declare class StampRallyServer {
     checkIn(request: CheckInRequest, authContext?: TrustedAuthContext): Promise<CheckInResponse>;
     claimReward(request: ClaimRewardRequest, authContext?: TrustedAuthContext): Promise<ClaimResponse>;
     sync(rallyId: string, identity: string | TrustedAuthContext): Promise<UserRallyState>;
-    syncProgress(request: SyncProgressRequest, authContext: TrustedAuthContext): Promise<UserRallyState>;
+    syncProgress(request: SyncProgressRequest, authContext: TrustedAuthContext): Promise<SyncProgressResponse>;
 }
 
 /**

package/dist/index.js

@@ -661,6 +661,15 @@ function timestampMillis(timestamp) {
   const value = Date.parse(timestamp);
   return Number.isFinite(value) ? value : Date.now();
 }
+function operationTimestamp(operation) {
+  const value = operation.request.now;
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string") {
+    const parsed = Date.parse(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return Number.MAX_SAFE_INTEGER;
+}
 function validationResponse(errors2) {
   return json(
     {
@@ -748,6 +757,38 @@ function operationStatus(result) {
   if (result.ok) return "ACCEPTED";
   return result.code === "CONFLICT" || result.code === "PERSISTENCE_FAILED" ? "RETRYABLE_ERROR" : "REJECTED_PERMANENT";
 }
+function syncOperationId(operation, userId) {
+  return `${operation.kind}:${operation.request.rallyId}:${userId}:${operation.request.idempotencyKey}`;
+}
+function syncOperationResult(operation, userId, result) {
+  const operationId = syncOperationId(operation, userId);
+  const resourceId = operation.kind === "checkIn" ? operation.request.spotId : operation.request.rewardId;
+  const action = operation.kind === "checkIn" ? "CHECK_IN" : "CLAIM_REWARD";
+  const status = operationStatus(result);
+  if (status === "ACCEPTED") {
+    return {
+      operationId,
+      status,
+      resourceId,
+      action,
+      appliedAt: timestampMillis(result.ok ? result.state.updatedAt : "")
+    };
+  }
+  if (status === "RETRYABLE_ERROR")
+    return {
+      operationId,
+      status: "FAILED_RETRYABLE",
+      resourceId,
+      error: result.ok ? "The operation can be retried." : result.message
+    };
+  return {
+    operationId,
+    status,
+    resourceId,
+    errorCode: result.ok ? "REJECTED_PERMANENT" : result.code,
+    reason: result.ok ? "The operation was rejected." : result.message
+  };
+}
 function withDirectIdentity(request, authContext) {
   if (authContext !== void 0) {
     if (authContext.authenticatedUserId.trim() === "")
@@ -880,16 +921,17 @@ var StampRallyServer = class {
       ...sessionId === null ? {} : { isAnonymous: true, sessionId }
     };
     try {
+      const progress = await this.syncProgress(
+        {
+          rallyId: body.data.rallyId,
+          ...body.data.operations === void 0 ? {} : { operations: body.data.operations },
+          ...sessionId === null ? {} : { anonymousSessionId: sessionId }
+        },
+        authContext
+      );
       return json({
         ok: true,
-        state: await this.syncProgress(
-          {
-            rallyId: body.data.rallyId,
-            ...body.data.operations === void 0 ? {} : { operations: body.data.operations },
-            ...sessionId === null ? {} : { anonymousSessionId: sessionId }
-          },
-          authContext
-        )
+        ...progress
       });
     } catch (error) {
       if (error instanceof RequestValidationException) return validationResponse(error.errors);
@@ -1226,11 +1268,39 @@ var StampRallyServer = class {
   async syncProgress(request, authContext) {
     const directRequest = withDirectIdentity(request, authContext);
     assertValidSyncParams(directRequest, this.#config);
-    for (const operation of request.operations ?? []) {
-      if (operation.kind === "checkIn") await this.checkIn(operation.request, authContext);
-      else await this.claimReward(operation.request, authContext);
+    const results = [];
+    const rejectedCheckIns = /* @__PURE__ */ new Set();
+    const operations = [...request.operations ?? []].map((operation, index) => ({ operation, index })).sort(
+      (left, right) => operationTimestamp(left.operation) - operationTimestamp(right.operation) || left.index - right.index
+    ).map(({ operation }) => operation);
+    for (const operation of operations) {
+      const resourceId = operation.kind === "checkIn" ? operation.request.spotId : operation.request.rewardId;
+      if (operation.kind === "checkIn") {
+        const spot = this.#config.spots.find((candidate) => candidate.id === resourceId);
+        if (spot?.prerequisites?.some((prerequisite) => rejectedCheckIns.has(prerequisite))) {
+          results.push({
+            operationId: syncOperationId(operation, directRequest.userId),
+            status: "REJECTED_PERMANENT",
+            resourceId,
+            errorCode: "REJECTED_PREREQUISITE_FAILED",
+            reason: "A prerequisite operation was rejected by the server."
+          });
+          rejectedCheckIns.add(resourceId);
+          continue;
+        }
+      }
+      const result = operation.kind === "checkIn" ? await this.checkIn(operation.request, authContext) : await this.claimReward(operation.request, authContext);
+      const operationResult = syncOperationResult(operation, directRequest.userId, result);
+      results.push(operationResult);
+      if (operation.kind === "checkIn" && operationResult.status === "REJECTED_PERMANENT")
+        rejectedCheckIns.add(resourceId);
     }
-    return this.sync(directRequest.rallyId, authContext);
+    const currentState = await this.sync(directRequest.rallyId, authContext);
+    return {
+      results,
+      currentState,
+      syncTimestamp: timestampMillis(now(this.#options))
+    };
   }
   async #attachInventory(state2) {
     const rewardRemaining = {};