@tinyburg/pocket-trains-sdk 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @tinyburg/pocket-trains-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Pocket Trains api, for the authproxy.
+
+Pocket Trains speaks Nimblebit's NBSync protocol under the game code `pt`. Requests
+are signed with `NimblebitAuth` from `@tinyburg/nimblebit-sdk`, using the
+game's own secret salt, and the endpoints carry the `pockettrains` scope tree
+built by `defineGame`. Game-specific save and meta payloads are still
+`Schema.Unknown`.

package/dist/Endpoints.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Pocket Trains (game code `pt`) NBSync api endpoints.
+ *
+ * Signing: a random `salt` (signed int32) goes in the path, and `hash` is
+ * `md5(<preimage> + <game secret salt>)` with the preimage
+ * `pt/<playerId>/<salt><playerAuthKey>` (variants noted per endpoint). The
+ * secret salt is the value extracted from `NBSync._ss`.
+ *
+ * Verification (live server + Frida DTO inspection of the game, 2026-08-26):
+ * - Signing is MD5, server-validated (same scheme as Tiny Tower / Pocket
+ *   Planes; the game computes SHA-256 only for the unauthenticated `register`).
+ * - Response envelopes VERIFIED by reading the game's DTO classes at runtime:
+ *   register, player_details, sync/pull (NBSyncGameSaveResponse), current_version,
+ *   verify_device, friend/pull_game, friend/pull_meta (meta is a flat
+ *   Dictionary<String,Object> on pt), send_item (NBSyncItemsSendResponse),
+ *   get_items (NBSyncItemsGetResponse: success/gifts, NO `total` unlike pp).
+ *   `get_items` was also exercised live with a burnbot.
+ * - pt-specific gifting: `get_gifts_pt` -> NBSyncGetPTGiftResponse with
+ *   NBSyncGetPTGift elements, plus a gift-id flow (NBSyncGetGiftIDResponse,
+ *   `friend/pull_meta_gift_id`). The get_gifts_pt REQUEST params are UNCONFIRMED
+ *   (the tried `/get_gifts_pt/pt/:playerId/:salt/:hash` form was rejected), so
+ *   that endpoint is marked accordingly.
+ *
+ * Game-specific save/meta schemas are left as `Schema.Unknown` placeholders.
+ *
+ * @since 1.0.0
+ * @category Endpoints
+ */
+import { HttpApi, HttpApiEndpoint, HttpApiError, HttpApiGroup } from "effect/http-api";
+import * as Schema from "effect/Schema";
+/**
+ * A gift/item in the general item channel (get_items / send_item). Verified DTO
+ * NBSyncItemsGift on pt: `{gift_id, gift_to, gift_from, gift_type, item_type,
+ * gift_str, h}` (no `c`, unlike pp). Left open for the data-schema work.
+ *
+ * @since 1.0.0
+ * @category Schemas
+ */
+export declare const Gift: Schema.Unknown;
+/**
+ * A Pocket Trains gift (get_gifts_pt channel). Verified DTO NBSyncGetPTGift:
+ * `{gift_id, gift_to, gift_from, alt_id, gift_type, gift_str: int, gift_quantity:
+ * int, h}`. Left open for the data-schema work.
+ *
+ * @since 1.0.0
+ * @category Schemas
+ */
+export declare const PTGift: Schema.Unknown;
+/**
+ * The Pocket Trains NBSync api.
+ *
+ * @since 1.0.0
+ * @category Api
+ */
+export declare const Api: HttpApi.HttpApi<"PocketTrainsApi", HttpApiGroup.HttpApiGroup<"DeviceManagementGroup", HttpApiEndpoint.HttpApiEndpoint<"DeviceNewPlayer", "GET", "/register/pt/:salt1/:salt2/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    salt1: Schema.Int;
+    salt2: Schema.Int;
+    hash: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.encodeKeys<Schema.Struct<{
+    readonly playerId: Schema.brand<Schema.String, "PlayerId">;
+    readonly playerSs: Schema.brand<Schema.RedactedFromValue<Schema.String>, "PlayerAuthKey">;
+}>, {
+    readonly playerId: "player_id";
+    readonly playerSs: "player_ss";
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"DevicePlayerDetails", "GET", "/player_details/pt/:playerId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"Found">;
+    readonly player: Schema.encodeKeys<Schema.Struct<{
+        readonly playerId: Schema.brand<Schema.String, "PlayerId">;
+        readonly playerEmail: Schema.brand<Schema.RedactedFromValue<Schema.String>, "PlayerEmail">;
+        readonly registered: Schema.compose<Schema.BooleanFromBit, Schema.NumberFromString>;
+        readonly blacklisted: Schema.compose<Schema.BooleanFromBit, Schema.NumberFromString>;
+        readonly saveVersion: Schema.compose<Schema.Int, Schema.NumberFromString>;
+        readonly checksum: Schema.String;
+    }>, {
+        readonly playerId: "player_id";
+        readonly playerEmail: "email";
+        readonly checksum: "h";
+    }>;
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"DeviceVerifyDevice", "GET", "/verify_device/pt/:playerId/:verificationCode", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    verificationCode: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.encodeKeys<Schema.Struct<{
+    readonly success: Schema.Literal<"NewDevice">;
+    readonly playerId: Schema.brand<Schema.String, "PlayerId">;
+    readonly playerAuthKey: Schema.brand<Schema.RedactedFromValue<Schema.String>, "PlayerAuthKey">;
+    readonly playerEmail: Schema.brand<Schema.RedactedFromValue<Schema.String>, "PlayerEmail">;
+}>, {
+    readonly playerId: "player_id";
+    readonly playerAuthKey: "player_ss";
+    readonly playerEmail: "player_email";
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never>, false> | HttpApiGroup.HttpApiGroup<"SocialGroup", HttpApiEndpoint.HttpApiEndpoint<"SocialGetGiftsPt", "GET", "/get_gifts_pt/pt/:playerId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"NotFound">;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"Found">;
+    readonly gifts: Schema.$Array<Schema.Unknown>;
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"SocialGetItems", "GET", "/get_items/pt/:playerId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"NotFound">;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"Found">;
+    readonly gifts: Schema.$Array<Schema.Unknown>;
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"SocialPullFriendGame", "GET", "/friend/pull_game/pt/:playerId/:friendId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    friendId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"NotFound">;
+}> | Schema.encodeKeys<Schema.Struct<{
+    readonly success: Schema.Literal<"Found">;
+    readonly data: Schema.Uint8ArrayFromBase64;
+    readonly checksum: Schema.String;
+    readonly saveId: Schema.NumberFromString;
+    readonly playerId: Schema.brand<Schema.String, "PlayerId">;
+}>, {
+    readonly checksum: "h";
+    readonly saveId: "id";
+    readonly playerId: "player_id";
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"SocialPullFriendMeta", "POST", "/friend/pull_meta/pt/:playerId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly friends: Schema.brand<Schema.String, "PlayerId">;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"NotFound">;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"Found">;
+    readonly meta: Schema.$Record<Schema.brand<Schema.String, "PlayerId">, Schema.Unknown>;
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"SocialSendItem", "POST", "/send_item/pt/:itemType/:playerId/:friendId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    itemType: Schema.String;
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    friendId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly itemStr: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"Sent">;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"NotSent">;
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never>, false> | HttpApiGroup.HttpApiGroup<"SyncManagementGroup", HttpApiEndpoint.HttpApiEndpoint<"SyncCheckForNewerSave", "GET", "/sync/current_version/pt/:playerId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"NotFound">;
+}> | Schema.encodeKeys<Schema.Struct<{
+    readonly success: Schema.Literal<"Found">;
+    readonly checksum: Schema.String;
+    readonly saveId: Schema.NumberFromString;
+}>, {
+    readonly checksum: "h";
+    readonly saveId: "id";
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"SyncPullSave", "GET", "/sync/pull/pt/:playerId/:salt/:hash", Schema.toCodecStringTree<Schema.Struct<{
+    playerId: Schema.brand<Schema.String, "PlayerId">;
+    salt: Schema.Int;
+    hash: Schema.String;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly error: Schema.String;
+}> | Schema.Struct<{
+    readonly success: Schema.Literal<"NotFound">;
+}> | Schema.encodeKeys<Schema.Struct<{
+    readonly success: Schema.Literal<"Found">;
+    readonly data: Schema.Uint8ArrayFromBase64;
+    readonly checksum: Schema.String;
+    readonly saveId: Schema.NumberFromString;
+}>, {
+    readonly checksum: "h";
+    readonly saveId: "id";
+}>>, Schema.toCodecJson<typeof HttpApiError.BadRequest | typeof HttpApiError.Unauthorized | typeof HttpApiError.Forbidden | typeof HttpApiError.InternalServerError>, never, never>, false>>;
+//# sourceMappingURL=Endpoints.d.ts.map

package/dist/Endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Endpoints.d.ts","sourceRoot":"","sources":["../src/Endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AA8BxC;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,gBAAiB,CAAC;AAEnC;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,gBAAiB,CAAC;AAgPrC;;;;;GAKG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4LAAuG,CAAC"}

package/dist/Endpoints.js

@@ -0,0 +1,293 @@
+/**
+ * Pocket Trains (game code `pt`) NBSync api endpoints.
+ *
+ * Signing: a random `salt` (signed int32) goes in the path, and `hash` is
+ * `md5(<preimage> + <game secret salt>)` with the preimage
+ * `pt/<playerId>/<salt><playerAuthKey>` (variants noted per endpoint). The
+ * secret salt is the value extracted from `NBSync._ss`.
+ *
+ * Verification (live server + Frida DTO inspection of the game, 2026-08-26):
+ * - Signing is MD5, server-validated (same scheme as Tiny Tower / Pocket
+ *   Planes; the game computes SHA-256 only for the unauthenticated `register`).
+ * - Response envelopes VERIFIED by reading the game's DTO classes at runtime:
+ *   register, player_details, sync/pull (NBSyncGameSaveResponse), current_version,
+ *   verify_device, friend/pull_game, friend/pull_meta (meta is a flat
+ *   Dictionary<String,Object> on pt), send_item (NBSyncItemsSendResponse),
+ *   get_items (NBSyncItemsGetResponse: success/gifts, NO `total` unlike pp).
+ *   `get_items` was also exercised live with a burnbot.
+ * - pt-specific gifting: `get_gifts_pt` -> NBSyncGetPTGiftResponse with
+ *   NBSyncGetPTGift elements, plus a gift-id flow (NBSyncGetGiftIDResponse,
+ *   `friend/pull_meta_gift_id`). The get_gifts_pt REQUEST params are UNCONFIRMED
+ *   (the tried `/get_gifts_pt/pt/:playerId/:salt/:hash` form was rejected), so
+ *   that endpoint is marked accordingly.
+ *
+ * Game-specific save/meta schemas are left as `Schema.Unknown` placeholders.
+ *
+ * @since 1.0.0
+ * @category Endpoints
+ */
+import { HttpApi, HttpApiEndpoint, HttpApiError, HttpApiGroup } from "effect/http-api";
+import * as Schema from "effect/Schema";
+import * as NimblebitConfig from "@tinyburg/nimblebit-sdk/NimblebitConfig";
+import * as OAuthScope from "@yielded/auth/OAuthScope";
+import * as Scopes from "./Scopes.js";
+/** @internal */
+export const U32 = /*#__PURE__*/Schema.Int.check(/*#__PURE__*/Schema.isUint32());
+/** @internal */
+export const ApiErrors = [HttpApiError.Forbidden, HttpApiError.BadRequest, HttpApiError.Unauthorized, HttpApiError.InternalServerError];
+/** @internal */
+export const ErrorResponse = /*#__PURE__*/Schema.Struct({
+  error: Schema.String
+});
+/** @internal */
+export const NotFoundResponse = /*#__PURE__*/Schema.Struct({
+  success: /*#__PURE__*/Schema.Literal("NotFound")
+});
+/** @internal */
+export const SentResponse = /*#__PURE__*/Schema.Struct({
+  success: /*#__PURE__*/Schema.Literal("Sent")
+});
+/** @internal */
+export const NotSentResponse = /*#__PURE__*/Schema.Struct({
+  success: /*#__PURE__*/Schema.Literal("NotSent")
+});
+/**
+ * A gift/item in the general item channel (get_items / send_item). Verified DTO
+ * NBSyncItemsGift on pt: `{gift_id, gift_to, gift_from, gift_type, item_type,
+ * gift_str, h}` (no `c`, unlike pp). Left open for the data-schema work.
+ *
+ * @since 1.0.0
+ * @category Schemas
+ */
+export const Gift = Schema.Unknown;
+/**
+ * A Pocket Trains gift (get_gifts_pt channel). Verified DTO NBSyncGetPTGift:
+ * `{gift_id, gift_to, gift_from, alt_id, gift_type, gift_str: int, gift_quantity:
+ * int, h}`. Left open for the data-schema work.
+ *
+ * @since 1.0.0
+ * @category Schemas
+ */
+export const PTGift = Schema.Unknown;
+/** @internal */
+export const DeviceNewPlayerEndpoint = /*#__PURE__*/HttpApiEndpoint.get("DeviceNewPlayer", "/register/pt/:salt1/:salt2/:hash", {
+  params: {
+    salt1: U32,
+    salt2: U32,
+    hash: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, /*#__PURE__*/Schema.Struct({
+    playerId: NimblebitConfig.PlayerIdSchema,
+    playerSs: NimblebitConfig.PlayerAuthKeySchema
+  }).pipe(/*#__PURE__*/Schema.encodeKeys({
+    playerId: "player_id",
+    playerSs: "player_ss"
+  }))]
+});
+/** @internal */
+export const DevicePlayerDetailsEndpoint = /*#__PURE__*/HttpApiEndpoint.get("DevicePlayerDetails", "/player_details/pt/:playerId/:salt/:hash", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, Schema.Struct({
+    success: Schema.Literal("Found"),
+    player: Schema.Struct({
+      playerId: NimblebitConfig.PlayerIdSchema,
+      playerEmail: NimblebitConfig.PlayerEmailSchema,
+      registered: Schema.NumberFromString.pipe(Schema.decodeTo(Schema.BooleanFromBit)),
+      blacklisted: Schema.NumberFromString.pipe(Schema.decodeTo(Schema.BooleanFromBit)),
+      saveVersion: Schema.NumberFromString.pipe(Schema.decodeTo(Schema.Int)),
+      checksum: Schema.String
+    }).pipe(Schema.encodeKeys({
+      playerId: "player_id",
+      playerEmail: "email",
+      checksum: "h"
+    }))
+  })]
+}).annotate(OAuthScope.Required, Scopes.Device.read.player_details.required);
+/** @internal */
+export const DeviceVerifyDeviceEndpoint = /*#__PURE__*/HttpApiEndpoint.get("DeviceVerifyDevice", "/verify_device/pt/:playerId/:verificationCode", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    verificationCode: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, Schema.Struct({
+    success: Schema.Literal("NewDevice"),
+    playerId: NimblebitConfig.PlayerIdSchema,
+    playerAuthKey: NimblebitConfig.PlayerAuthKeySchema,
+    playerEmail: NimblebitConfig.PlayerEmailSchema
+  }).pipe(Schema.encodeKeys({
+    playerId: "player_id",
+    playerAuthKey: "player_ss",
+    playerEmail: "player_email"
+  }))]
+}).annotate(OAuthScope.Required, Scopes.Device.write.verify_device.required);
+/**
+ * Pull the player's cloud save. VERIFIED envelope (NBSyncGameSaveResponse). No-save
+ * case returns `{ error: "SaveNotFound" }`. `data` is base64 pako-deflated bytes.
+ *
+ * @internal
+ */
+export const SyncPullSaveEndpoint = /*#__PURE__*/HttpApiEndpoint.get("SyncPullSave", "/sync/pull/pt/:playerId/:salt/:hash", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, NotFoundResponse, /*#__PURE__*/Schema.Struct({
+    success: Schema.Literal("Found"),
+    data: Schema.Uint8ArrayFromBase64,
+    checksum: Schema.String,
+    saveId: Schema.NumberFromString
+  }).pipe(/*#__PURE__*/Schema.encodeKeys({
+    checksum: "h",
+    saveId: "id"
+  }))]
+});
+/**
+ * VERIFIED envelope (NBSyncCurrentCheckResponse); no-save returns `{ error: "NoSave" }`.
+ *
+ * @internal
+ */
+export const SyncCheckForNewerSaveEndpoint = /*#__PURE__*/HttpApiEndpoint.get("SyncCheckForNewerSave", "/sync/current_version/pt/:playerId/:salt/:hash", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, NotFoundResponse, /*#__PURE__*/Schema.Struct({
+    success: Schema.Literal("Found"),
+    checksum: Schema.String,
+    saveId: Schema.NumberFromString
+  }).pipe(/*#__PURE__*/Schema.encodeKeys({
+    checksum: "h",
+    saveId: "id"
+  }))]
+});
+/**
+ * VERIFIED live: `/get_items/pt/:playerId/:salt/:hash` -> `{ success:"Found",
+ * gifts:[...] }` (NBSyncItemsGetResponse; no `total` on pt).
+ *
+ * @internal
+ */
+export const SocialGetItemsEndpoint = /*#__PURE__*/HttpApiEndpoint.get("SocialGetItems", "/get_items/pt/:playerId/:salt/:hash", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, NotFoundResponse, Schema.Struct({
+    success: Schema.Literal("Found"),
+    gifts: Schema.Array(Gift)
+  })]
+}).annotate(OAuthScope.Required, Scopes.Social.read.get_items.required);
+/**
+ * Pocket Trains gift channel. Response VERIFIED (NBSyncGetPTGiftResponse) but the
+ * REQUEST params are UNCONFIRMED - the `/get_gifts_pt/pt/:playerId/:salt/:hash`
+ * form was rejected with "Invalid Request", so pt's gift request likely needs a
+ * gift-id (see NBSyncGetGiftIDResponse / `friend/pull_meta_gift_id`). Path/params
+ * below are a placeholder to be confirmed by capturing the live request.
+ *
+ * @internal
+ */
+export const SocialGetGiftsPtEndpoint = /*#__PURE__*/HttpApiEndpoint.get("SocialGetGiftsPt", "/get_gifts_pt/pt/:playerId/:salt/:hash", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, NotFoundResponse, Schema.Struct({
+    success: Schema.Literal("Found"),
+    gifts: Schema.Array(PTGift)
+  })]
+}).annotate(OAuthScope.Required, Scopes.Social.read.get_gifts_pt.required);
+/**
+ * DERIVED from Tiny Tower. Sends an item to a friend. Response VERIFIED
+ * (NBSyncItemsSendResponse: success/error). pt also has a `/send_pt/` variant.
+ *
+ * @internal
+ */
+export const SocialSendItemEndpoint = /*#__PURE__*/HttpApiEndpoint.post("SocialSendItem", "/send_item/pt/:itemType/:playerId/:friendId/:salt/:hash", {
+  params: {
+    itemType: Schema.String,
+    playerId: NimblebitConfig.PlayerIdSchema,
+    friendId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  payload: Schema.Struct({
+    itemStr: Schema.String
+  }),
+  error: ApiErrors,
+  success: [ErrorResponse, SentResponse, NotSentResponse]
+}).annotate(OAuthScope.Required, Scopes.Social.write.send_item.required);
+/**
+ * VERIFIED envelope (NBSyncFriendGameSaveResponse); preimage
+ * `pt/<playerId>/<friendId>/<salt><playerAuthKey>`.
+ *
+ * @internal
+ */
+export const SocialPullFriendGameEndpoint = /*#__PURE__*/HttpApiEndpoint.get("SocialPullFriendGame", "/friend/pull_game/pt/:playerId/:friendId/:salt/:hash", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    friendId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  error: ApiErrors,
+  success: [ErrorResponse, NotFoundResponse, Schema.Struct({
+    success: Schema.Literal("Found"),
+    data: Schema.Uint8ArrayFromBase64,
+    checksum: Schema.String,
+    saveId: Schema.NumberFromString,
+    playerId: NimblebitConfig.PlayerIdSchema
+  }).pipe(Schema.encodeKeys({
+    checksum: "h",
+    saveId: "id",
+    playerId: "player_id"
+  }))]
+}).annotate(OAuthScope.Required, Scopes.Social.read.pull_friend_game.required);
+/**
+ * VERIFIED envelope (NBSyncFriendGameMetaResponse; `meta` is a flat
+ * Dictionary<String,Object> on pt). Preimage `pt/<playerId>/<salt><friendId><playerAuthKey>`.
+ *
+ * @internal
+ */
+export const SocialPullFriendMetaEndpoint = /*#__PURE__*/HttpApiEndpoint.post("SocialPullFriendMeta", "/friend/pull_meta/pt/:playerId/:salt/:hash", {
+  params: {
+    playerId: NimblebitConfig.PlayerIdSchema,
+    salt: U32,
+    hash: Schema.String
+  },
+  payload: Schema.Struct({
+    friends: NimblebitConfig.PlayerIdSchema
+  }),
+  error: ApiErrors,
+  success: [ErrorResponse, NotFoundResponse, Schema.Struct({
+    success: Schema.Literal("Found"),
+    meta: Schema.Record(NimblebitConfig.PlayerIdSchema, Schema.Unknown)
+  })]
+}).annotate(OAuthScope.Required, Scopes.Social.read.pull_friend_meta.required);
+/** @internal */
+export const DeviceManagementGroup = /*#__PURE__*/HttpApiGroup.make("DeviceManagementGroup").add(DeviceNewPlayerEndpoint).add(DevicePlayerDetailsEndpoint).add(DeviceVerifyDeviceEndpoint);
+/** @internal */
+export const SyncManagementGroup = /*#__PURE__*/HttpApiGroup.make("SyncManagementGroup").add(SyncPullSaveEndpoint).add(SyncCheckForNewerSaveEndpoint);
+/** @internal */
+export const SocialGroup = /*#__PURE__*/HttpApiGroup.make("SocialGroup").add(SocialGetItemsEndpoint).add(SocialGetGiftsPtEndpoint).add(SocialSendItemEndpoint).add(SocialPullFriendGameEndpoint).add(SocialPullFriendMetaEndpoint);
+/**
+ * The Pocket Trains NBSync api.
+ *
+ * @since 1.0.0
+ * @category Api
+ */
+export const Api = /*#__PURE__*/HttpApi.make("PocketTrainsApi").add(DeviceManagementGroup).add(SyncManagementGroup).add(SocialGroup);
+//# sourceMappingURL=Endpoints.js.map

package/dist/Endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Endpoints.js","names":[],"sources":["../src/Endpoints.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/PocketTrains.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Pocket Trains SDK: signed calls against Nimblebit's NBSync service.
+ *
+ * Signing reuses `@tinyburg/nimblebit-sdk` (`NimblebitAuth`): the game secret
+ * salt (from `NBSync._ss`) is provided as the auth key, and each request is
+ * `md5(<preimage> + <secret salt>)` with a random uint32 `salt` in the path.
+ * All method preimages below are the Tiny Tower formula with the `pt` game code.
+ *
+ * The methods that were exercised live against sync.nimblebit.com are marked
+ * VERIFIED; save-bearing / write paths follow the same pattern but were not
+ * exercised. Save bytes are returned raw (base64-decoded); inflating (pako) and
+ * parsing into a save schema is left to the caller.
+ *
+ * @since 1.0.0
+ * @category SDK
+ */
+import type * as Schema from "effect/Schema";
+import * as Effect from "effect/Effect";
+import { HttpClient } from "effect/http";
+import * as Redacted from "effect/Redacted";
+import { NimblebitAuth } from "@tinyburg/nimblebit-sdk";
+/**
+ * Requests a new player ("burnbot") from the Nimblebit servers. VERIFIED.
+ *
+ * @since 1.0.0
+ * @category SDK
+ */
+export declare const device_newPlayer: Effect.Effect<{
+    readonly playerId: string & import("effect/Brand").Brand<"PlayerId">;
+    readonly playerSs: Redacted.Redacted<string> & import("effect/Brand").Brand<"PlayerAuthKey">;
+}, import("effect/http-api/HttpApiError").BadRequest | import("effect/http-api/HttpApiError").Forbidden | import("effect/http/HttpClientError").HttpClientError | import("effect/http-api/HttpApiError").InternalServerError | import("@tinyburg/nimblebit-sdk/internal/Error").NimblebitError | import("effect/PlatformError").PlatformError | Schema.SchemaError | import("effect/http-api/HttpApiError").Unauthorized, HttpClient.HttpClient | NimblebitAuth.NimblebitAuth>;
+/**
+ * Retrieves player details. VERIFIED.
+ *
+ * @since 1.0.0
+ * @category SDK
+ */
+export declare const device_playerDetails: (args_0: {
+    readonly playerAuthKey: Redacted.Redacted<string> & import("effect/Brand").Brand<"PlayerAuthKey">;
+    readonly playerId: string & import("effect/Brand").Brand<"PlayerId">;
+}) => Effect.Effect<{
+    readonly playerId: string & import("effect/Brand").Brand<"PlayerId">;
+    readonly playerEmail: Redacted.Redacted<string> & import("effect/Brand").Brand<"PlayerEmail">;
+    readonly registered: boolean;
+    readonly blacklisted: boolean;
+    readonly saveVersion: number;
+    readonly checksum: string;
+}, import("effect/http-api/HttpApiError").BadRequest | import("effect/http-api/HttpApiError").Forbidden | import("effect/http/HttpClientError").HttpClientError | import("effect/http-api/HttpApiError").InternalServerError | import("@tinyburg/nimblebit-sdk/internal/Error").NimblebitError | import("effect/PlatformError").PlatformError | Schema.SchemaError | import("effect/http-api/HttpApiError").Unauthorized, HttpClient.HttpClient | NimblebitAuth.NimblebitAuth>;
+/**
+ * Pulls the player's cloud save. Returns raw base64-decoded bytes (inflate +
+ * parse separately). Success envelope DERIVED from Tiny Tower.
+ *
+ * @since 1.0.0
+ * @category SDK
+ */
+export declare const sync_pullSave: (args_0: {
+    readonly playerAuthKey: Redacted.Redacted<string> & import("effect/Brand").Brand<"PlayerAuthKey">;
+    readonly playerId: string & import("effect/Brand").Brand<"PlayerId">;
+}) => Effect.Effect<{
+    readonly success: "NotFound";
+} | {
+    readonly success: "Found";
+    readonly data: Uint8Array<ArrayBufferLike>;
+    readonly checksum: string;
+    readonly saveId: number;
+}, import("effect/http-api/HttpApiError").BadRequest | import("effect/http-api/HttpApiError").Forbidden | import("effect/http/HttpClientError").HttpClientError | import("effect/http-api/HttpApiError").InternalServerError | import("@tinyburg/nimblebit-sdk/internal/Error").NimblebitError | import("effect/PlatformError").PlatformError | Schema.SchemaError | import("effect/http-api/HttpApiError").Unauthorized, HttpClient.HttpClient | NimblebitAuth.NimblebitAuth>;
+/**
+ * Lists items (parts/gifts) waiting for the player. VERIFIED
+ * (`/get_items/pt/...` -> `{ success:"Found", gifts:[...] }`, no total).
+ *
+ * @since 1.0.0
+ * @category SDK
+ */
+export declare const social_getItems: (args_0: {
+    readonly playerAuthKey: Redacted.Redacted<string> & import("effect/Brand").Brand<"PlayerAuthKey">;
+    readonly playerId: string & import("effect/Brand").Brand<"PlayerId">;
+}) => Effect.Effect<{
+    readonly success: "NotFound";
+} | {
+    readonly success: "Found";
+    readonly gifts: readonly unknown[];
+}, import("effect/http-api/HttpApiError").BadRequest | import("effect/http-api/HttpApiError").Forbidden | import("effect/http/HttpClientError").HttpClientError | import("effect/http-api/HttpApiError").InternalServerError | import("@tinyburg/nimblebit-sdk/internal/Error").NimblebitError | import("effect/PlatformError").PlatformError | Schema.SchemaError | import("effect/http-api/HttpApiError").Unauthorized, HttpClient.HttpClient | NimblebitAuth.NimblebitAuth>;
+//# sourceMappingURL=PocketTrains.d.ts.map

package/dist/PocketTrains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PocketTrains.d.ts","sourceRoot":"","sources":["../src/PocketTrains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAE,aAAa,EAAkB,MAAM,yBAAyB,CAAC;AAIxE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;8cA6B3B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;8cA+B/B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;8cA+BxB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;8cA+B1B,CAAC"}