@serve.zone/interfaces 27.3.0 → 27.4.0

package/ts/runtime.cloudlylegacydeploymentsettlement.ts

@@ -740,14 +740,14 @@ const finalize = <T>(
 };
 
 const encodeNormalized = (valueArg: unknown, pathArg: string): Uint8Array => (
-  new Uint8Array(Buffer.from(canonicalize(valueArg, pathArg), 'utf8'))
+  Buffer.from(canonicalize(valueArg, pathArg), 'utf8')
 );
 
 const frame = (domainArg: string, payloadArg: Uint8Array): Uint8Array => {
   const domain = Buffer.from(domainArg, 'utf8');
   const output = new Uint8Array(domain.byteLength + payloadArg.byteLength);
   output.set(domain, 0);
-  output.set(new Uint8Array(payloadArg), domain.byteLength);
+  output.set(payloadArg, domain.byteLength);
   return output;
 };
 
@@ -3901,8 +3901,8 @@ const assertProductionAuthorizationArtifacts = (
       !== digestCloudlyLegacyDeploymentSettlementRequestBundle(requestBundleArg)
     || authorizationArg.scratchReceiptSha256
       !== digestCloudlyLegacyDeploymentSettlementScratchReceipt(scratchReceiptArg)
-    || productionMetadataArg.issuedAt < scratchReceiptArg.completedAt
-    || authorizationArg.requestedAt < scratchReceiptArg.completedAt
+    || productionMetadataArg.issuedAt <= scratchReceiptArg.completedAt
+    || authorizationArg.requestedAt <= scratchReceiptArg.completedAt
     || authorizationArg.requestedAt < productionMetadataArg.issuedAt
     || authorizationArg.approvedAt < authorizationArg.requestedAt) {
     fail('CROSS_FIELD_MISMATCH', 'productionExecutionAuthorization.sourceProof');
@@ -6128,8 +6128,8 @@ export const normalizeCloudlyLegacyDeploymentSettlementStdioRequest = (
     const approvedAt = readInteger(input.approvedAt, `${payloadPath}.approvedAt`, requestedAt);
     assertAuthorityTimestamp(requestedAt, metadata.productionMetadata, `${payloadPath}.requestedAt`);
     assertAuthorityTimestamp(approvedAt, metadata.productionMetadata, `${payloadPath}.approvedAt`);
-    if (metadata.productionMetadata.issuedAt < scratchReceipt.completedAt
-      || requestedAt < scratchReceipt.completedAt) {
+    if (metadata.productionMetadata.issuedAt <= scratchReceipt.completedAt
+      || requestedAt <= scratchReceipt.completedAt) {
       fail('CROSS_FIELD_MISMATCH', `${payloadPath}.requestedAt`);
     }
     payload = {
@@ -6538,11 +6538,15 @@ const encodeStdioFrame = (
   pathArg: string,
 ): Uint8Array => {
   const payload = encodeNormalized(valueArg, pathArg);
-  if (payload.byteLength + 1 > maximumBytesArg) fail('LIMIT_EXCEEDED', pathArg);
-  const output = new Uint8Array(payload.byteLength + 1);
-  output.set(payload);
-  output[payload.byteLength] = 0x0a;
-  return output;
+  try {
+    if (payload.byteLength + 1 > maximumBytesArg) fail('LIMIT_EXCEEDED', pathArg);
+    const output = new Uint8Array(payload.byteLength + 1);
+    output.set(payload);
+    output[payload.byteLength] = 0x0a;
+    return output;
+  } finally {
+    payload.fill(0);
+  }
 };
 
 export const encodeCloudlyLegacyDeploymentSettlementStdioRequestFrame = (
@@ -6576,24 +6580,31 @@ const decodeStdioFrame = <T>(
     fail('INVALID_DATA', pathArg);
   }
   const payloadBytes = new Uint8Array(frameArg.subarray(0, -1));
-  let text: string;
+  let canonicalFrame: Uint8Array | undefined;
   try {
-    text = new TextDecoder('utf-8', { fatal: true }).decode(payloadBytes);
-  } catch {
-    return fail('INVALID_DATA', pathArg);
-  }
-  let value: unknown;
-  try {
-    value = JSON.parse(text) as unknown;
-  } catch {
-    return fail('INVALID_DATA', pathArg);
-  }
-  const normalized = normalizeArg(value);
-  const canonicalFrame = encodeArg(normalized);
-  if (!Buffer.from(canonicalFrame).equals(Buffer.from(frameArg))) {
-    fail('INVALID_DATA', pathArg);
+    let text: string;
+    try {
+      text = new TextDecoder('utf-8', { fatal: true }).decode(payloadBytes);
+    } catch {
+      return fail('INVALID_DATA', pathArg);
+    }
+    let value: unknown;
+    try {
+      value = JSON.parse(text) as unknown;
+    } catch {
+      return fail('INVALID_DATA', pathArg);
+    }
+    const normalized = normalizeArg(value);
+    canonicalFrame = encodeArg(normalized);
+    if (canonicalFrame.byteLength !== frameArg.byteLength
+      || canonicalFrame.some((byteArg, indexArg) => byteArg !== frameArg[indexArg])) {
+      fail('INVALID_DATA', pathArg);
+    }
+    return normalized;
+  } finally {
+    payloadBytes.fill(0);
+    canonicalFrame?.fill(0);
   }
-  return normalized;
 };
 
 export const decodeCloudlyLegacyDeploymentSettlementStdioRequestFrame = (

package/ts/runtime.corestore.databaseexportpackage.golden.ts

@@ -0,0 +1,323 @@
+import { deepFreezeValue } from './private/canonicaljson.js';
+import type {
+  ICorestoreDatabaseBackupReceipt,
+} from './runtime.corestore.js';
+import type {
+  ICorestoreDatabaseExportPackageCompletionV1,
+  ICorestoreDatabaseExportPackageReleaseCompletionV1,
+  ICorestoreDatabaseExportPackageReleaseRequestV1,
+  ICorestoreDatabaseExportPackageReleaseResponseV1,
+  ICorestoreDatabaseExportPackageRequestV1,
+  ICorestoreDatabaseExportPackageResponseV1,
+} from './runtime.corestore.databaseexportpackage.js';
+
+interface ICorestoreDatabaseExportPackageGoldenArtifact<TValue> {
+  input: TValue;
+  canonical: string;
+  byteLength: number;
+  sha256: string;
+}
+
+interface ICorestoreDatabaseExportPackageGoldenVectorsV1 {
+  version: 1;
+  request: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageRequestV1
+  >;
+  receipt: ICorestoreDatabaseExportPackageGoldenArtifact<ICorestoreDatabaseBackupReceipt>;
+  completion: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageCompletionV1
+  >;
+  response: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageResponseV1
+  >;
+  replayResponse: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageResponseV1
+  >;
+  releaseRequest: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageReleaseRequestV1
+  >;
+  releaseCompletion: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageReleaseCompletionV1
+  >;
+  releaseResponse: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageReleaseResponseV1
+  >;
+  replayReleaseResponse: ICorestoreDatabaseExportPackageGoldenArtifact<
+    ICorestoreDatabaseExportPackageReleaseResponseV1
+  >;
+}
+
+const allocation = {
+  purpose: 'scratch-rehearsal' as const,
+  rehearsalId: 'offline-rehearsal-1',
+  allocationId: '3'.repeat(64),
+  generation: 2,
+  bindingSha256: '4'.repeat(64),
+  receiptSha256: '5'.repeat(64),
+};
+
+const request: ICorestoreDatabaseExportPackageRequestV1 = {
+  schemaVersion: 1,
+  kind: 'corestore-database-export-package-request',
+  packageAttemptId: 'offline-package-attempt-1',
+  packageBackupId: 'package-cloudly-offline-1',
+  input: {
+    format: 'smartdb.database.export.v1',
+    databaseName: 'cloudly',
+    byteLength: 4249,
+    sha256: '9321522806fa2957c169940990a4bb7072cec52fa65243eb5b4b570f9dbe9677',
+    lineFeedTerminator: 'single-lf',
+  },
+  approvedSourceBackup: {
+    backupId: 'backup-cloudly-approved-1',
+    sourceServiceId: 'service-cloudly',
+    snapshotId: 'snapshot-cloudly-approved-1',
+    backupReceiptSha256:
+      '1111111111111111111111111111111111111111111111111111111111111111',
+  },
+  completeOutputReceiptSha256:
+    '47eea07082fa86f8bac5af82397321cffc55924f4487866a7b147d9c256e39f5',
+  allocationExpectation: {
+    expectation: 'exact',
+    allocation,
+  },
+};
+
+const receipt: ICorestoreDatabaseBackupReceipt = {
+  schemaVersion: 1,
+  format: 'corestore.database.backup.v1',
+  backupId: request.packageBackupId,
+  sourceServiceId: 'service-cloudly',
+  createdAt: 1_700_000_201_000,
+  snapshot: {
+    capability: 'database',
+    resourceName: 'cloudly',
+    snapshotId: 'snapshot-packaged-cloudly-1',
+    snapshotName: request.packageBackupId,
+    originalSize: request.input.byteLength,
+    storedSize: 2048,
+    createdAt: 1_700_000_201_000,
+    tags: {
+      corestore: 'resource',
+      serviceId: 'service-cloudly',
+      serviceName: 'cloudly',
+      capability: 'database',
+      resourceName: 'cloudly',
+      snapshotName: request.packageBackupId,
+      backupId: request.packageBackupId,
+    },
+    databaseName: 'cloudly',
+    databaseAllocation: allocation,
+  },
+  closure: {
+    formatVersion: 1,
+    snapshotIds: ['snapshot-packaged-cloudly-1'],
+    objectCount: 2,
+    packCount: 1,
+    chunkCount: 3,
+    payloadBytes: request.input.byteLength,
+    archiveBytes: 2048,
+    sha256: '7'.repeat(64),
+  },
+};
+
+const completion: ICorestoreDatabaseExportPackageCompletionV1 = {
+  schemaVersion: 1,
+  kind: 'corestore-database-export-package-completion',
+  packageAttemptId: request.packageAttemptId,
+  requestSha256: 'd9e63a397c066aaaec2904d20c1a12240e0a1a902ab388cdff2cebde6c9e1cec',
+  completedAt: 1_700_000_201_000,
+  receipt,
+  receiptSha256: '081fc6e6cca7ab6c25a4583a6689821a01f1807942ac0259ba3394b8f34ef580',
+  closureByteLength: receipt.closure.archiveBytes,
+  closureSha256: receipt.closure.sha256,
+};
+
+const response: ICorestoreDatabaseExportPackageResponseV1 = {
+  schemaVersion: 1,
+  kind: 'corestore-database-export-package-response',
+  completion,
+  replayed: false,
+};
+
+const replayResponse: ICorestoreDatabaseExportPackageResponseV1 = {
+  ...response,
+  replayed: true,
+};
+
+const releaseRequest: ICorestoreDatabaseExportPackageReleaseRequestV1 = {
+  schemaVersion: 1,
+  kind: 'corestore-database-export-package-release-request',
+  packageAttemptId: request.packageAttemptId,
+  requestSha256: completion.requestSha256,
+  completionSha256: 'e771f6f674bc6b00295a38b191aa43cd731e2811f149d54d1fd6b7f14fbc81ce',
+  callerFsyncedClosureByteLength: completion.closureByteLength,
+  callerFsyncedClosureSha256: completion.closureSha256,
+  callerFsyncedReceiptByteLength: 1203,
+  callerFsyncedReceiptSha256: completion.receiptSha256,
+  callerFsyncedAt: 1_700_000_201_001,
+};
+
+const releaseCompletion: ICorestoreDatabaseExportPackageReleaseCompletionV1 = {
+  schemaVersion: 1,
+  kind: 'corestore-database-export-package-release-completion',
+  packageAttemptId: request.packageAttemptId,
+  requestSha256: completion.requestSha256,
+  completionSha256: releaseRequest.completionSha256,
+  releaseRequestSha256:
+    '4dc5b3a803aa1e56fdeb74d45ccfa123781c6162a300333c31a85006d9a2d460',
+  releasedAt: 1_700_000_201_002,
+};
+
+const releaseResponse: ICorestoreDatabaseExportPackageReleaseResponseV1 = {
+  schemaVersion: 1,
+  kind: 'corestore-database-export-package-release-response',
+  release: releaseCompletion,
+  replayed: false,
+};
+
+const replayReleaseResponse: ICorestoreDatabaseExportPackageReleaseResponseV1 = {
+  ...releaseResponse,
+  replayed: true,
+};
+
+const allocationCanonical =
+  '{"allocationId":"3333333333333333333333333333333333333333333333333333333333333333",'
+  + '"bindingSha256":"4444444444444444444444444444444444444444444444444444444444444444",'
+  + '"generation":2,"purpose":"scratch-rehearsal",'
+  + '"receiptSha256":"5555555555555555555555555555555555555555555555555555555555555555",'
+  + '"rehearsalId":"offline-rehearsal-1"}';
+
+const requestCanonical =
+  `{"allocationExpectation":{"allocation":${allocationCanonical},"expectation":"exact"},`
+  + '"approvedSourceBackup":{"backupId":"backup-cloudly-approved-1",'
+  + '"backupReceiptSha256":"1111111111111111111111111111111111111111111111111111111111111111",'
+  + '"snapshotId":"snapshot-cloudly-approved-1","sourceServiceId":"service-cloudly"},'
+  + '"completeOutputReceiptSha256":"47eea07082fa86f8bac5af82397321cffc55924f4487866a7b147d9c256e39f5",'
+  + '"input":{"byteLength":4249,"databaseName":"cloudly",'
+  + '"format":"smartdb.database.export.v1","lineFeedTerminator":"single-lf",'
+  + '"sha256":"9321522806fa2957c169940990a4bb7072cec52fa65243eb5b4b570f9dbe9677"},'
+  + '"kind":"corestore-database-export-package-request",'
+  + '"packageAttemptId":"offline-package-attempt-1",'
+  + '"packageBackupId":"package-cloudly-offline-1","schemaVersion":1}';
+
+const receiptCanonical =
+  '{"backupId":"package-cloudly-offline-1","closure":{"archiveBytes":2048,'
+  + '"chunkCount":3,"formatVersion":1,"objectCount":2,"packCount":1,"payloadBytes":4249,'
+  + '"sha256":"7777777777777777777777777777777777777777777777777777777777777777",'
+  + '"snapshotIds":["snapshot-packaged-cloudly-1"]},"createdAt":1700000201000,'
+  + '"format":"corestore.database.backup.v1","schemaVersion":1,'
+  + '"snapshot":{"capability":"database","createdAt":1700000201000,'
+  + `"databaseAllocation":${allocationCanonical},`
+  + '"databaseName":"cloudly","originalSize":4249,"resourceName":"cloudly",'
+  + '"snapshotId":"snapshot-packaged-cloudly-1",'
+  + '"snapshotName":"package-cloudly-offline-1","storedSize":2048,'
+  + '"tags":{"backupId":"package-cloudly-offline-1","capability":"database",'
+  + '"corestore":"resource","resourceName":"cloudly","serviceId":"service-cloudly",'
+  + '"serviceName":"cloudly","snapshotName":"package-cloudly-offline-1"}},'
+  + '"sourceServiceId":"service-cloudly"}';
+
+const completionCanonical =
+  '{"closureByteLength":2048,'
+  + '"closureSha256":"7777777777777777777777777777777777777777777777777777777777777777",'
+  + '"completedAt":1700000201000,"kind":"corestore-database-export-package-completion",'
+  + '"packageAttemptId":"offline-package-attempt-1",'
+  + `"receipt":${receiptCanonical},`
+  + '"receiptSha256":"081fc6e6cca7ab6c25a4583a6689821a01f1807942ac0259ba3394b8f34ef580",'
+  + '"requestSha256":"d9e63a397c066aaaec2904d20c1a12240e0a1a902ab388cdff2cebde6c9e1cec",'
+  + '"schemaVersion":1}';
+
+const responseCanonical =
+  `{"completion":${completionCanonical},`
+  + '"kind":"corestore-database-export-package-response","replayed":false,"schemaVersion":1}';
+
+const replayResponseCanonical =
+  `{"completion":${completionCanonical},`
+  + '"kind":"corestore-database-export-package-response","replayed":true,"schemaVersion":1}';
+
+const releaseRequestCanonical =
+  '{"callerFsyncedAt":1700000201001,"callerFsyncedClosureByteLength":2048,'
+  + '"callerFsyncedClosureSha256":"7777777777777777777777777777777777777777777777777777777777777777",'
+  + '"callerFsyncedReceiptByteLength":1203,'
+  + '"callerFsyncedReceiptSha256":"081fc6e6cca7ab6c25a4583a6689821a01f1807942ac0259ba3394b8f34ef580",'
+  + '"completionSha256":"e771f6f674bc6b00295a38b191aa43cd731e2811f149d54d1fd6b7f14fbc81ce",'
+  + '"kind":"corestore-database-export-package-release-request",'
+  + '"packageAttemptId":"offline-package-attempt-1",'
+  + '"requestSha256":"d9e63a397c066aaaec2904d20c1a12240e0a1a902ab388cdff2cebde6c9e1cec",'
+  + '"schemaVersion":1}';
+
+const releaseCompletionCanonical =
+  '{"completionSha256":"e771f6f674bc6b00295a38b191aa43cd731e2811f149d54d1fd6b7f14fbc81ce",'
+  + '"kind":"corestore-database-export-package-release-completion",'
+  + '"packageAttemptId":"offline-package-attempt-1",'
+  + '"releaseRequestSha256":"4dc5b3a803aa1e56fdeb74d45ccfa123781c6162a300333c31a85006d9a2d460",'
+  + '"releasedAt":1700000201002,'
+  + '"requestSha256":"d9e63a397c066aaaec2904d20c1a12240e0a1a902ab388cdff2cebde6c9e1cec",'
+  + '"schemaVersion":1}';
+
+const releaseResponseCanonical =
+  '{"kind":"corestore-database-export-package-release-response",'
+  + `"release":${releaseCompletionCanonical},"replayed":false,"schemaVersion":1}`;
+
+const replayReleaseResponseCanonical =
+  '{"kind":"corestore-database-export-package-release-response",'
+  + `"release":${releaseCompletionCanonical},"replayed":true,"schemaVersion":1}`;
+
+export const corestoreDatabaseExportPackageGoldenVectors:
+Readonly<ICorestoreDatabaseExportPackageGoldenVectorsV1> = deepFreezeValue({
+  version: 1,
+  request: {
+    input: request,
+    canonical: requestCanonical,
+    byteLength: 1084,
+    sha256: 'd9e63a397c066aaaec2904d20c1a12240e0a1a902ab388cdff2cebde6c9e1cec',
+  },
+  receipt: {
+    input: receipt,
+    canonical: receiptCanonical,
+    byteLength: 1203,
+    sha256: '081fc6e6cca7ab6c25a4583a6689821a01f1807942ac0259ba3394b8f34ef580',
+  },
+  completion: {
+    input: completion,
+    canonical: completionCanonical,
+    byteLength: 1636,
+    sha256: 'e771f6f674bc6b00295a38b191aa43cd731e2811f149d54d1fd6b7f14fbc81ce',
+  },
+  response: {
+    input: response,
+    canonical: responseCanonical,
+    byteLength: 1738,
+    sha256: 'b119c4c7b8747ac4ebadf8858be4cde362cf99be66d30a537148a3dcb25171c1',
+  },
+  replayResponse: {
+    input: replayResponse,
+    canonical: replayResponseCanonical,
+    byteLength: 1737,
+    sha256: '3666c3ff9e9da23617c810dc86f27787909b487fd836045c50250c566379ddd2',
+  },
+  releaseRequest: {
+    input: releaseRequest,
+    canonical: releaseRequestCanonical,
+    byteLength: 594,
+    sha256: '4dc5b3a803aa1e56fdeb74d45ccfa123781c6162a300333c31a85006d9a2d460',
+  },
+  releaseCompletion: {
+    input: releaseCompletion,
+    canonical: releaseCompletionCanonical,
+    byteLength: 414,
+    sha256: '7a06c6a571586a94c363880b68aa59d144ba75a3bfaeb6137725183c5b99a19c',
+  },
+  releaseResponse: {
+    input: releaseResponse,
+    canonical: releaseResponseCanonical,
+    byteLength: 521,
+    sha256: '1529914cb60ac561f09bfcc5d0a123d4e676515789ec3859b3e2e84ef6c19afc',
+  },
+  replayReleaseResponse: {
+    input: replayReleaseResponse,
+    canonical: replayReleaseResponseCanonical,
+    byteLength: 520,
+    sha256: 'fa4413657a3ee9f77ca4d1852a6627faa0282712113a07cf6a57e7dd3d0266e9',
+  },
+});