@particle/esim-tooling 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,230 @@
+export declare enum ProfileState {
+    Disabled = 0,
+    Enabled = 1
+}
+export declare enum ProfileClass {
+    Test = 0,
+    Provisioning = 1,
+    Operational = 2
+}
+export declare enum NotificationEvent {
+    Install = 128,
+    Enable = 64,
+    Disable = 32,
+    Delete = 16
+}
+export declare enum DeleteNotificationStatus {
+    Ok = 0,
+    NothingToDelete = 1,
+    UndefinedError = 127
+}
+export declare enum CancelSessionReason {
+    EndUserRejection = 0,
+    Postponed = 1,
+    Timeout = 2,
+    PprNotAllowed = 3,
+    MetadataMismatch = 4,
+    LoadBppExecutionError = 5,
+    SessionAborted = 16,
+    EnterpriseProfilesNotSupported = 17,
+    EnterpriseRulesNotAllowed = 18,
+    EnterpriseProfileNotAllowed = 19,
+    EnterpriseOidMismatch = 20,
+    EnterpriseRulesError = 21,
+    EnterpriseProfilesOnly = 22,
+    LprNotSupported = 23,
+    LprNetworkDataNotAllowed = 24,
+    EmptyProfileOrSpName = 25,
+    RpmDisabled = 27,
+    InvalidRpmPackage = 28,
+    LoadRpmPackageError = 29,
+    OperationAbandoned = 30,
+    UndefinedReason = 127
+}
+export declare enum EnableProfileResult {
+    Ok = 0,
+    IccidOrAidNotFound = 1,
+    ProfileNotInDisabledState = 2,
+    DisallowedByPolicy = 3,
+    WrongProfileReenabling = 4,
+    CatBusy = 5,
+    DisallowedByEnterpriseRule = 6,
+    CommandError = 7,
+    DisallowedForRpm = 9,
+    NoEsimPortAvailable = 10,
+    UndefinedError = 127
+}
+export declare enum DisableProfileResult {
+    Ok = 0,
+    IccidOrAidNotFound = 1,
+    ProfileNotInEnabledState = 2,
+    DisallowedByPolicy = 3,
+    CatBusy = 5,
+    DisallowedByEnterpriseRule = 6,
+    CommandError = 7,
+    DisallowedForRpm = 9,
+    UndefinedError = 127
+}
+export declare enum DeleteProfileResult {
+    Ok = 0,
+    IccidOrAidNotFound = 1,
+    ProfileNotInDisabledState = 2,
+    DisallowedByPolicy = 3,
+    DisallowedInTestMode = 4,
+    CommandError = 7,
+    UndefinedError = 127
+}
+/**
+ * Error codes from ProfileInstallationResult errorResult (reasonCode).
+ * Per SGP.22 Section 5.7.7.
+ */
+export declare enum BppInstallErrorCode {
+    IncorrectInputValues = 1,
+    InvalidSignature = 2,
+    InvalidTransactionId = 3,
+    UnsupportedCrtValues = 4,
+    UnsupportedRemoteOperationType = 5,
+    UnsupportedProfileClass = 6,
+    Scp03tStructureError = 7,
+    Scp03tSecurityError = 8,
+    IccidAlreadyExistsOnEuicc = 9,
+    InsufficientMemoryForProfile = 10,
+    InstallInterrupted = 11,
+    PeProcessingError = 12,
+    DataMismatch = 13,
+    TestProfileInvalidNaaKey = 14,
+    PprNotAllowed = 15,
+    UnknownError = 127
+}
+export interface DeviceAdapter {
+    sendApdu(apdu: Uint8Array): Promise<Uint8Array>;
+}
+export interface ServerAdapter {
+    sendRsp(smdpAddress: string, endpoint: string, requestData: Uint8Array): Promise<ServerResponse>;
+}
+export interface ServerResponse {
+    statusCode: number;
+    responseData?: Uint8Array;
+}
+export interface Profile {
+    iccid: string;
+    isdpAid?: string;
+    state: ProfileState;
+    nickname?: string;
+    serviceProviderName?: string;
+    profileName?: string;
+    profileClass?: ProfileClass;
+}
+export interface NotificationMetadata {
+    seqNumber: number;
+    operation: NotificationEvent;
+    notificationAddress: string;
+    iccid?: string;
+}
+/**
+ * Full notification data from RetrieveNotificationsList.
+ * Includes installation result for install notifications.
+ */
+export interface Notification extends NotificationMetadata {
+    /**
+     * For install notifications: whether the installation succeeded.
+     * For other notifications (enable/disable/delete): always true (operation completed).
+     */
+    success: boolean;
+    /**
+     * Error subject code (only if success=false).
+     * See SGP.22 Section 5.7.9 for subject codes.
+     */
+    errorSubjectCode?: number;
+    /**
+     * Error reason code (only if success=false).
+     * See BppInstallErrorCode enum for common values.
+     */
+    errorReasonCode?: number;
+}
+/**
+ * Result of BPP loading from the eUICC.
+ * Returned after the last STORE DATA command during profile installation.
+ */
+export interface ProfileInstallationResult {
+    success: boolean;
+    /** ICCID of the installed profile (only if success=true) */
+    iccid?: string;
+    /** Error subject code (only if success=false) */
+    errorSubjectCode?: number;
+    /** Error reason code (only if success=false) */
+    errorReasonCode?: number;
+}
+/**
+ * Result of sending a notification to SM-DP+.
+ */
+export interface SendResult {
+    /** Whether the notification was successfully sent to SM-DP+ */
+    sent: boolean;
+    /** Whether the notification was removed from the eUICC (only attempted if sent=true) */
+    removed: boolean;
+    /** Error message if sending failed */
+    error?: string;
+}
+/**
+ * Notification with optional send result.
+ */
+export interface NotificationWithResult extends Notification {
+    /** Result of sending to SM-DP+. null if send option was false. */
+    sendResult: SendResult | null;
+}
+/**
+ * Options for processNotifications.
+ */
+export interface ProcessNotificationsOptions {
+    /** If true, only list notifications without sending to SM-DP+. Default: false (process and send) */
+    listOnly?: boolean;
+    /** If true, remove notifications from eUICC even if sending fails. Default: false */
+    forceRemove?: boolean;
+}
+/**
+ * Result of processNotifications.
+ */
+export interface ProcessNotificationsResult {
+    /** All notifications with their details and optional send results */
+    notifications: NotificationWithResult[];
+    /** Number of notifications successfully sent (only present when send=true) */
+    sent?: number;
+    /** Number of notifications that failed to send (only present when send=true) */
+    failed?: number;
+}
+export interface ActivationCode {
+    format: number;
+    smdpAddress: string;
+    matchingId: string;
+    smdpOid?: string;
+    confirmationCodeRequired: boolean;
+}
+export type DownloadStep = 'parseActivationCode' | 'getEuiccChallenge' | 'getEuiccInfo' | 'initiateAuth' | 'authenticateServer' | 'authenticateClient' | 'prepareDownload' | 'getBoundProfilePackage' | 'loadProfile' | 'complete';
+export interface DownloadProgress {
+    step: DownloadStep;
+    detail?: string;
+}
+export interface DownloadResult {
+    success: boolean;
+    error?: string;
+    /** Error subject code from ProfileInstallationResult (only if success=false) */
+    errorSubjectCode?: number;
+    /** Error reason code from ProfileInstallationResult (only if success=false) */
+    errorReasonCode?: number;
+    iccid?: string;
+    profileMetadata?: {
+        serviceProviderName?: string;
+        profileName?: string;
+    };
+}
+export interface InstallProfileOptions {
+    activationCode: string;
+    confirmationCode?: string;
+    onProgress?: (progress: DownloadProgress) => void;
+}
+export interface EsimLpaOptions {
+    device: DeviceAdapter;
+    server: ServerAdapter;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,108 @@
+export var ProfileState;
+(function (ProfileState) {
+    ProfileState[ProfileState["Disabled"] = 0] = "Disabled";
+    ProfileState[ProfileState["Enabled"] = 1] = "Enabled";
+})(ProfileState || (ProfileState = {}));
+export var ProfileClass;
+(function (ProfileClass) {
+    ProfileClass[ProfileClass["Test"] = 0] = "Test";
+    ProfileClass[ProfileClass["Provisioning"] = 1] = "Provisioning";
+    ProfileClass[ProfileClass["Operational"] = 2] = "Operational";
+})(ProfileClass || (ProfileClass = {}));
+export var NotificationEvent;
+(function (NotificationEvent) {
+    NotificationEvent[NotificationEvent["Install"] = 128] = "Install";
+    NotificationEvent[NotificationEvent["Enable"] = 64] = "Enable";
+    NotificationEvent[NotificationEvent["Disable"] = 32] = "Disable";
+    NotificationEvent[NotificationEvent["Delete"] = 16] = "Delete";
+})(NotificationEvent || (NotificationEvent = {}));
+export var DeleteNotificationStatus;
+(function (DeleteNotificationStatus) {
+    DeleteNotificationStatus[DeleteNotificationStatus["Ok"] = 0] = "Ok";
+    DeleteNotificationStatus[DeleteNotificationStatus["NothingToDelete"] = 1] = "NothingToDelete";
+    DeleteNotificationStatus[DeleteNotificationStatus["UndefinedError"] = 127] = "UndefinedError";
+})(DeleteNotificationStatus || (DeleteNotificationStatus = {}));
+export var CancelSessionReason;
+(function (CancelSessionReason) {
+    CancelSessionReason[CancelSessionReason["EndUserRejection"] = 0] = "EndUserRejection";
+    CancelSessionReason[CancelSessionReason["Postponed"] = 1] = "Postponed";
+    CancelSessionReason[CancelSessionReason["Timeout"] = 2] = "Timeout";
+    CancelSessionReason[CancelSessionReason["PprNotAllowed"] = 3] = "PprNotAllowed";
+    CancelSessionReason[CancelSessionReason["MetadataMismatch"] = 4] = "MetadataMismatch";
+    CancelSessionReason[CancelSessionReason["LoadBppExecutionError"] = 5] = "LoadBppExecutionError";
+    CancelSessionReason[CancelSessionReason["SessionAborted"] = 16] = "SessionAborted";
+    CancelSessionReason[CancelSessionReason["EnterpriseProfilesNotSupported"] = 17] = "EnterpriseProfilesNotSupported";
+    CancelSessionReason[CancelSessionReason["EnterpriseRulesNotAllowed"] = 18] = "EnterpriseRulesNotAllowed";
+    CancelSessionReason[CancelSessionReason["EnterpriseProfileNotAllowed"] = 19] = "EnterpriseProfileNotAllowed";
+    CancelSessionReason[CancelSessionReason["EnterpriseOidMismatch"] = 20] = "EnterpriseOidMismatch";
+    CancelSessionReason[CancelSessionReason["EnterpriseRulesError"] = 21] = "EnterpriseRulesError";
+    CancelSessionReason[CancelSessionReason["EnterpriseProfilesOnly"] = 22] = "EnterpriseProfilesOnly";
+    CancelSessionReason[CancelSessionReason["LprNotSupported"] = 23] = "LprNotSupported";
+    CancelSessionReason[CancelSessionReason["LprNetworkDataNotAllowed"] = 24] = "LprNetworkDataNotAllowed";
+    CancelSessionReason[CancelSessionReason["EmptyProfileOrSpName"] = 25] = "EmptyProfileOrSpName";
+    CancelSessionReason[CancelSessionReason["RpmDisabled"] = 27] = "RpmDisabled";
+    CancelSessionReason[CancelSessionReason["InvalidRpmPackage"] = 28] = "InvalidRpmPackage";
+    CancelSessionReason[CancelSessionReason["LoadRpmPackageError"] = 29] = "LoadRpmPackageError";
+    CancelSessionReason[CancelSessionReason["OperationAbandoned"] = 30] = "OperationAbandoned";
+    CancelSessionReason[CancelSessionReason["UndefinedReason"] = 127] = "UndefinedReason";
+})(CancelSessionReason || (CancelSessionReason = {}));
+export var EnableProfileResult;
+(function (EnableProfileResult) {
+    EnableProfileResult[EnableProfileResult["Ok"] = 0] = "Ok";
+    EnableProfileResult[EnableProfileResult["IccidOrAidNotFound"] = 1] = "IccidOrAidNotFound";
+    EnableProfileResult[EnableProfileResult["ProfileNotInDisabledState"] = 2] = "ProfileNotInDisabledState";
+    EnableProfileResult[EnableProfileResult["DisallowedByPolicy"] = 3] = "DisallowedByPolicy";
+    EnableProfileResult[EnableProfileResult["WrongProfileReenabling"] = 4] = "WrongProfileReenabling";
+    EnableProfileResult[EnableProfileResult["CatBusy"] = 5] = "CatBusy";
+    EnableProfileResult[EnableProfileResult["DisallowedByEnterpriseRule"] = 6] = "DisallowedByEnterpriseRule";
+    EnableProfileResult[EnableProfileResult["CommandError"] = 7] = "CommandError";
+    EnableProfileResult[EnableProfileResult["DisallowedForRpm"] = 9] = "DisallowedForRpm";
+    EnableProfileResult[EnableProfileResult["NoEsimPortAvailable"] = 10] = "NoEsimPortAvailable";
+    EnableProfileResult[EnableProfileResult["UndefinedError"] = 127] = "UndefinedError";
+})(EnableProfileResult || (EnableProfileResult = {}));
+export var DisableProfileResult;
+(function (DisableProfileResult) {
+    DisableProfileResult[DisableProfileResult["Ok"] = 0] = "Ok";
+    DisableProfileResult[DisableProfileResult["IccidOrAidNotFound"] = 1] = "IccidOrAidNotFound";
+    DisableProfileResult[DisableProfileResult["ProfileNotInEnabledState"] = 2] = "ProfileNotInEnabledState";
+    DisableProfileResult[DisableProfileResult["DisallowedByPolicy"] = 3] = "DisallowedByPolicy";
+    DisableProfileResult[DisableProfileResult["CatBusy"] = 5] = "CatBusy";
+    DisableProfileResult[DisableProfileResult["DisallowedByEnterpriseRule"] = 6] = "DisallowedByEnterpriseRule";
+    DisableProfileResult[DisableProfileResult["CommandError"] = 7] = "CommandError";
+    DisableProfileResult[DisableProfileResult["DisallowedForRpm"] = 9] = "DisallowedForRpm";
+    DisableProfileResult[DisableProfileResult["UndefinedError"] = 127] = "UndefinedError";
+})(DisableProfileResult || (DisableProfileResult = {}));
+export var DeleteProfileResult;
+(function (DeleteProfileResult) {
+    DeleteProfileResult[DeleteProfileResult["Ok"] = 0] = "Ok";
+    DeleteProfileResult[DeleteProfileResult["IccidOrAidNotFound"] = 1] = "IccidOrAidNotFound";
+    DeleteProfileResult[DeleteProfileResult["ProfileNotInDisabledState"] = 2] = "ProfileNotInDisabledState";
+    DeleteProfileResult[DeleteProfileResult["DisallowedByPolicy"] = 3] = "DisallowedByPolicy";
+    DeleteProfileResult[DeleteProfileResult["DisallowedInTestMode"] = 4] = "DisallowedInTestMode";
+    DeleteProfileResult[DeleteProfileResult["CommandError"] = 7] = "CommandError";
+    DeleteProfileResult[DeleteProfileResult["UndefinedError"] = 127] = "UndefinedError";
+})(DeleteProfileResult || (DeleteProfileResult = {}));
+/**
+ * Error codes from ProfileInstallationResult errorResult (reasonCode).
+ * Per SGP.22 Section 5.7.7.
+ */
+export var BppInstallErrorCode;
+(function (BppInstallErrorCode) {
+    BppInstallErrorCode[BppInstallErrorCode["IncorrectInputValues"] = 1] = "IncorrectInputValues";
+    BppInstallErrorCode[BppInstallErrorCode["InvalidSignature"] = 2] = "InvalidSignature";
+    BppInstallErrorCode[BppInstallErrorCode["InvalidTransactionId"] = 3] = "InvalidTransactionId";
+    BppInstallErrorCode[BppInstallErrorCode["UnsupportedCrtValues"] = 4] = "UnsupportedCrtValues";
+    BppInstallErrorCode[BppInstallErrorCode["UnsupportedRemoteOperationType"] = 5] = "UnsupportedRemoteOperationType";
+    BppInstallErrorCode[BppInstallErrorCode["UnsupportedProfileClass"] = 6] = "UnsupportedProfileClass";
+    BppInstallErrorCode[BppInstallErrorCode["Scp03tStructureError"] = 7] = "Scp03tStructureError";
+    BppInstallErrorCode[BppInstallErrorCode["Scp03tSecurityError"] = 8] = "Scp03tSecurityError";
+    BppInstallErrorCode[BppInstallErrorCode["IccidAlreadyExistsOnEuicc"] = 9] = "IccidAlreadyExistsOnEuicc";
+    BppInstallErrorCode[BppInstallErrorCode["InsufficientMemoryForProfile"] = 10] = "InsufficientMemoryForProfile";
+    BppInstallErrorCode[BppInstallErrorCode["InstallInterrupted"] = 11] = "InstallInterrupted";
+    BppInstallErrorCode[BppInstallErrorCode["PeProcessingError"] = 12] = "PeProcessingError";
+    BppInstallErrorCode[BppInstallErrorCode["DataMismatch"] = 13] = "DataMismatch";
+    BppInstallErrorCode[BppInstallErrorCode["TestProfileInvalidNaaKey"] = 14] = "TestProfileInvalidNaaKey";
+    BppInstallErrorCode[BppInstallErrorCode["PprNotAllowed"] = 15] = "PprNotAllowed";
+    BppInstallErrorCode[BppInstallErrorCode["UnknownError"] = 127] = "UnknownError";
+})(BppInstallErrorCode || (BppInstallErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@particle/esim-tooling",
+  "version": "1.0.0",
+  "description": "TypeScript library for eSIM profile provisioning (SGP.22)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/particle-iot/esim-tooling"
+  },
+  "author": "Julien Vanier <julien@particle.io>",
+  "keywords": [
+    "esim",
+    "lpa",
+    "sgp22",
+    "euicc",
+    "profile",
+    "provisioning",
+    "cellular",
+    "iot"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.x"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {}
+}

package/src/activation-code.ts

@@ -0,0 +1,64 @@
+import { ActivationCodeError } from './errors.js';
+import type { ActivationCode } from './types.js';
+
+/**
+ * Parse an RSP activation code string per SGP.22 Section 4.1.
+ * Format: LPA:1$<smdpAddress>$<matchingId>[$<smdpOid>][$<ccRequired>]
+ * Per spec, the parser SHALL ignore a delimiter and any further parameters
+ * beyond those it recognizes.
+ */
+export function parseActivationCode(code: string): ActivationCode {
+  // Strip optional "LPA:" prefix
+  let input = code;
+  if (input.startsWith('LPA:')) {
+    input = input.substring(4);
+  }
+
+  const parts = input.split('$');
+  if (parts.length < 3) {
+    throw new ActivationCodeError('Activation code must have at least format, address, and matching ID');
+  }
+
+  const format = parseInt(parts[0], 10);
+  if (format !== 1) {
+    throw new ActivationCodeError(`Unsupported activation code format: ${format}`);
+  }
+
+  const smdpAddress = parts[1];
+  if (!smdpAddress) {
+    throw new ActivationCodeError('SM-DP+ address is required');
+  }
+
+  const matchingId = parts[2];
+
+  const smdpOid = parts.length > 3 && parts[3] ? parts[3] : undefined;
+  const confirmationCodeRequired = parts.length > 4 && parts[4] === '1';
+
+  return {
+    format,
+    smdpAddress,
+    matchingId,
+    smdpOid,
+    confirmationCodeRequired,
+  };
+}
+
+export function isValidActivationCode(code: string): boolean {
+  try {
+    parseActivationCode(code);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function formatActivationCode(params: Omit<ActivationCode, 'format'>): string {
+  let code = `1$${params.smdpAddress}$${params.matchingId}`;
+  if (params.smdpOid || params.confirmationCodeRequired) {
+    code += `$${params.smdpOid ?? ''}`;
+  }
+  if (params.confirmationCodeRequired) {
+    code += '$1';
+  }
+  return code;
+}