@stamprally/server 0.18.0 → 0.19.0

package/dist/index.d.cts

@@ -248,6 +248,7 @@ declare function validateSyncRequest(value: unknown): RequestValidationResult<{
     readonly rallyId: string;
     readonly userId?: string;
     readonly anonymousSessionId?: string;
+    readonly operations?: SyncProgressRequest["operations"];
 }>;
 
 type ErrorResponse = {
@@ -275,11 +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: {
-        readonly rallyId: string;
-        readonly userId?: string;
-        readonly anonymousSessionId?: string;
-    }, authContext: TrustedAuthContext): Promise<UserRallyState>;
+    syncProgress(request: SyncProgressRequest, authContext: TrustedAuthContext): Promise<UserRallyState>;
 }
 
 /**
@@ -319,6 +316,19 @@ interface ClaimRewardRequest {
     readonly staffId?: string;
     readonly now?: string | number;
 }
+type SyncProgressOperation = {
+    readonly kind: "checkIn";
+    readonly request: CheckInRequest;
+} | {
+    readonly kind: "claimReward";
+    readonly request: ClaimRewardRequest;
+};
+interface SyncProgressRequest {
+    readonly rallyId: string;
+    readonly userId?: string;
+    readonly anonymousSessionId?: string;
+    readonly operations?: ReadonlyArray<SyncProgressOperation>;
+}
 type CheckInResponse = {
     readonly ok: true;
     readonly state: UserRallyState;
@@ -338,4 +348,4 @@ interface ServerOptions {
     readonly anonymousPolicy?: "session_scoped" | "reject" | "shared_global_opt_in_insecure";
 }
 
-export { type AuditLog, type AuthenticationContext, type CheckInRequest, type CheckInResponse, type CheckInTransactionMutation, type CheckInTransactionParams, type ClaimRewardMutationContext, type ClaimRewardRequest, type ClaimRewardTransactionMutation, type ClaimRewardTransactionParams, InMemoryServerPersistenceAdapter, type InMemoryServerPersistenceOptions, type RedisMultiExecutor, type RequestValidationError, RequestValidationException, type RequestValidationResult, type ServerOptions, type ServerPersistenceAdapter, type SqlCheckInStore, type SqlClaimRewardStore, type SqlTransactionDatabase, StampRallyServer, type SyncOperationStatus, type TrustedAuthContext, type UserClaimRecord, assertValidCheckInParams, assertValidClaimParams, assertValidSyncParams, executeCheckInTransaction, executeClaimRewardTransaction, executeRedisTransaction, runPersistenceAdapterComplianceTests, validateCheckInRequest, validateClaimRewardRequest, validateSyncRequest };
+export { type AuditLog, type AuthenticationContext, type CheckInRequest, type CheckInResponse, type CheckInTransactionMutation, type CheckInTransactionParams, type ClaimRewardMutationContext, type ClaimRewardRequest, type ClaimRewardTransactionMutation, type ClaimRewardTransactionParams, InMemoryServerPersistenceAdapter, type InMemoryServerPersistenceOptions, type RedisMultiExecutor, type RequestValidationError, RequestValidationException, type RequestValidationResult, type ServerOptions, type ServerPersistenceAdapter, type SqlCheckInStore, type SqlClaimRewardStore, type SqlTransactionDatabase, StampRallyServer, type SyncOperationStatus, type SyncProgressOperation, type SyncProgressRequest, type TrustedAuthContext, type UserClaimRecord, assertValidCheckInParams, assertValidClaimParams, assertValidSyncParams, executeCheckInTransaction, executeClaimRewardTransaction, executeRedisTransaction, runPersistenceAdapterComplianceTests, validateCheckInRequest, validateClaimRewardRequest, validateSyncRequest };

package/dist/index.d.ts

@@ -248,6 +248,7 @@ declare function validateSyncRequest(value: unknown): RequestValidationResult<{
     readonly rallyId: string;
     readonly userId?: string;
     readonly anonymousSessionId?: string;
+    readonly operations?: SyncProgressRequest["operations"];
 }>;
 
 type ErrorResponse = {
@@ -275,11 +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: {
-        readonly rallyId: string;
-        readonly userId?: string;
-        readonly anonymousSessionId?: string;
-    }, authContext: TrustedAuthContext): Promise<UserRallyState>;
+    syncProgress(request: SyncProgressRequest, authContext: TrustedAuthContext): Promise<UserRallyState>;
 }
 
 /**
@@ -319,6 +316,19 @@ interface ClaimRewardRequest {
     readonly staffId?: string;
     readonly now?: string | number;
 }
+type SyncProgressOperation = {
+    readonly kind: "checkIn";
+    readonly request: CheckInRequest;
+} | {
+    readonly kind: "claimReward";
+    readonly request: ClaimRewardRequest;
+};
+interface SyncProgressRequest {
+    readonly rallyId: string;
+    readonly userId?: string;
+    readonly anonymousSessionId?: string;
+    readonly operations?: ReadonlyArray<SyncProgressOperation>;
+}
 type CheckInResponse = {
     readonly ok: true;
     readonly state: UserRallyState;
@@ -338,4 +348,4 @@ interface ServerOptions {
     readonly anonymousPolicy?: "session_scoped" | "reject" | "shared_global_opt_in_insecure";
 }
 
-export { type AuditLog, type AuthenticationContext, type CheckInRequest, type CheckInResponse, type CheckInTransactionMutation, type CheckInTransactionParams, type ClaimRewardMutationContext, type ClaimRewardRequest, type ClaimRewardTransactionMutation, type ClaimRewardTransactionParams, InMemoryServerPersistenceAdapter, type InMemoryServerPersistenceOptions, type RedisMultiExecutor, type RequestValidationError, RequestValidationException, type RequestValidationResult, type ServerOptions, type ServerPersistenceAdapter, type SqlCheckInStore, type SqlClaimRewardStore, type SqlTransactionDatabase, StampRallyServer, type SyncOperationStatus, type TrustedAuthContext, type UserClaimRecord, assertValidCheckInParams, assertValidClaimParams, assertValidSyncParams, executeCheckInTransaction, executeClaimRewardTransaction, executeRedisTransaction, runPersistenceAdapterComplianceTests, validateCheckInRequest, validateClaimRewardRequest, validateSyncRequest };
+export { type AuditLog, type AuthenticationContext, type CheckInRequest, type CheckInResponse, type CheckInTransactionMutation, type CheckInTransactionParams, type ClaimRewardMutationContext, type ClaimRewardRequest, type ClaimRewardTransactionMutation, type ClaimRewardTransactionParams, InMemoryServerPersistenceAdapter, type InMemoryServerPersistenceOptions, type RedisMultiExecutor, type RequestValidationError, RequestValidationException, type RequestValidationResult, type ServerOptions, type ServerPersistenceAdapter, type SqlCheckInStore, type SqlClaimRewardStore, type SqlTransactionDatabase, StampRallyServer, type SyncOperationStatus, type SyncProgressOperation, type SyncProgressRequest, type TrustedAuthContext, type UserClaimRecord, assertValidCheckInParams, assertValidClaimParams, assertValidSyncParams, executeCheckInTransaction, executeClaimRewardTransaction, executeRedisTransaction, runPersistenceAdapterComplianceTests, validateCheckInRequest, validateClaimRewardRequest, validateSyncRequest };

package/dist/index.js

@@ -2,9 +2,13 @@ import { reconcileRewardStates, consumeReward, evaluateConditionDetailed } from
 
 // src/examples/transaction.ts
 async function executeClaimRewardTransaction(database, store, params2, mutation2) {
+  if (params2.secondaryStockKey !== void 0 && store.writeSecondaryStock === void 0)
+    return { success: false, error: "SECONDARY_STOCK_UNSUPPORTED" };
   try {
     return await database.transaction(async (transaction) => {
       const current = await store.readContext(transaction, params2);
+      if (params2.secondaryStockKey !== void 0 && current.secondaryStock === void 0)
+        return { success: false, error: "SECONDARY_STOCK_UNSUPPORTED" };
       const secondaryStock = current.secondaryStock ?? null;
       const rewardStock2 = params2.stockKey === "__shared__" ? secondaryStock : current.stock;
       const next = mutation2({
@@ -596,6 +600,40 @@ function validateSyncRequest(value) {
     return errors({ path: "$", message: "Expected an object.", code: "INVALID_TYPE" });
   if (value.userId !== void 0 && !nonEmpty(value.userId))
     return errors({ path: "userId", message: "userId must be non-empty.", code: "INVALID_TYPE" });
+  if (value.operations !== void 0) {
+    if (!Array.isArray(value.operations))
+      return errors({
+        path: "operations",
+        message: "operations must be an array.",
+        code: "INVALID_TYPE"
+      });
+    const operationErrors = [];
+    value.operations.forEach((operation, index) => {
+      const path = `operations[${index}]`;
+      if (!record(operation)) {
+        operationErrors.push({
+          path,
+          message: "Expected an operation object.",
+          code: "INVALID_TYPE"
+        });
+        return;
+      }
+      if (operation.kind !== "checkIn" && operation.kind !== "claimReward") {
+        operationErrors.push({
+          path: `${path}.kind`,
+          message: "Unknown sync operation.",
+          code: "INVALID_ENUM"
+        });
+        return;
+      }
+      const result = operation.kind === "checkIn" ? validateCheckInRequest(operation.request) : validateClaimRewardRequest(operation.request);
+      if (!result.success)
+        operationErrors.push(
+          ...result.errors.map((error) => ({ ...error, path: `${path}.request.${error.path}` }))
+        );
+    });
+    if (operationErrors.length > 0) return errors(...operationErrors);
+  }
   return {
     success: true,
     data: value
@@ -847,6 +885,7 @@ var StampRallyServer = class {
         state: await this.syncProgress(
           {
             rallyId: body.data.rallyId,
+            ...body.data.operations === void 0 ? {} : { operations: body.data.operations },
             ...sessionId === null ? {} : { anonymousSessionId: sessionId }
           },
           authContext
@@ -1187,6 +1226,10 @@ 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);
+    }
     return this.sync(directRequest.rallyId, authContext);
   }
   async #attachInventory(state2) {