@sandbox-kit/sandbox 0.1.0 → 0.1.2

package/dist/contracts/sandbox_data_contracts.d.ts

@@ -22,13 +22,16 @@ export type SecretReference = StripProto<ProtoSecretReference>;
 export type ObservabilityConfig = StripProto<ProtoObservabilityConfig>;
 export type SandboxInfo = StripProto<ProtoSandboxInfo>;
 export type CreateResult = StripProto<ProtoCreateResult>;
-/** Wire lifecycle options (Duration timeouts) for providers / Backend. */
-export type StartOptions = StripProto<ProtoStartOptions>;
-export type StopOptions = StripProto<ProtoStopOptions>;
-export type PauseOptions = StripProto<ProtoPauseOptions>;
-export type TerminateOptions = StripProto<ProtoTerminateOptions>;
-export type ArchiveOptions = StripProto<ProtoArchiveOptions>;
-export type DeleteOptions = StripProto<ProtoDeleteOptions>;
+/**
+ * Public lifecycle options for `Backend` and provider adapters (ms timeouts).
+ * Same duration remapping as {@link CreateOptions}; wire `Duration` stays private.
+ */
+export type StartOptions = DurationFieldsToMs<StripProto<ProtoStartOptions>>;
+export type StopOptions = DurationFieldsToMs<StripProto<ProtoStopOptions>>;
+export type PauseOptions = DurationFieldsToMs<StripProto<ProtoPauseOptions>>;
+export type TerminateOptions = DurationFieldsToMs<StripProto<ProtoTerminateOptions>>;
+export type ArchiveOptions = DurationFieldsToMs<StripProto<ProtoArchiveOptions>>;
+export type DeleteOptions = DurationFieldsToMs<StripProto<ProtoDeleteOptions>>;
 export type ExitResult = StripProto<ProtoExitResult>;
 export type MetadataValue = StripProto<ProtoMetadataValue>;
 export type MetadataList = StripProto<ProtoMetadataList>;

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export * from "#contracts/field_paths.js";
 export * from "#contracts/config_paths.js";
 export * from "#metadata/metadata_object.js";
 export * from "#client/client.js";
+export { validCidr, validDomain, validEnvName, } from "#internal/net_validate.js";

package/dist/index.js

@@ -3,3 +3,4 @@ export * from "#contracts/field_paths.js";
 export * from "#contracts/config_paths.js";
 export * from "#metadata/metadata_object.js";
 export * from "#client/client.js";
+export { validCidr, validDomain, validEnvName, } from "#internal/net_validate.js";

package/dist/internal/net_validate.d.ts

@@ -0,0 +1,4 @@
+/** Shared network / env name validators used by provider create checks. */
+export declare function validEnvName(value: string): boolean;
+export declare function validDomain(value: string): boolean;
+export declare function validCidr(value: string): boolean;

package/dist/internal/net_validate.js

@@ -0,0 +1,53 @@
+/** Shared network / env name validators used by provider create checks. */
+export function validEnvName(value) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(value);
+}
+export function validDomain(value) {
+    const domain = value.startsWith("*.") ? value.slice(2) : value;
+    return (domain.length <= 253 &&
+        /^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.?$/i.test(domain));
+}
+export function validCidr(value) {
+    const separator = value.lastIndexOf("/");
+    if (separator <= 0)
+        return false;
+    const address = value.slice(0, separator);
+    const prefix = Number(value.slice(separator + 1));
+    if (!Number.isInteger(prefix))
+        return false;
+    return address.includes(":")
+        ? prefix >= 0 && prefix <= 128 && validIpv6(address)
+        : prefix >= 0 && prefix <= 32 && validIpv4(address);
+}
+function validIpv4(value) {
+    const parts = value.split(".");
+    return (parts.length === 4 &&
+        parts.every((part) => /^(0|[1-9][0-9]{0,2})$/.test(part) && Number(part) <= 255));
+}
+function validIpv6(value) {
+    if ((value.match(/::/g)?.length ?? 0) > 1)
+        return false;
+    const halves = value.split("::");
+    if (halves.length > 2)
+        return false;
+    const count = (part) => {
+        if (part === "")
+            return 0;
+        const groups = part.split(":");
+        let total = 0;
+        for (const group of groups) {
+            if (/^[0-9a-f]{1,4}$/i.test(group))
+                total++;
+            else if (validIpv4(group))
+                total += 2;
+            else
+                return undefined;
+        }
+        return total;
+    };
+    const left = count(halves[0] ?? "");
+    const right = count(halves[1] ?? "");
+    return (left !== undefined &&
+        right !== undefined &&
+        (halves.length === 2 ? left + right < 8 : left === 8));
+}

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@sandbox-kit/sandbox",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "one pluggable sdk for all your sandbox providers",
+  "keywords": [
+    "sandbox-kit",
+    "sandbox",
+    "sdk"
+  ],
   "license": "MIT",
   "type": "module",
   "packageManager": "npm@11.19.0",
@@ -54,11 +59,12 @@
   "dependencies": {
     "@bufbuild/protobuf": "2.16.0",
     "@bufbuild/protovalidate": "1.3.0",
-    "@sandbox-kit/contracts": "0.1.0"
+    "@sandbox-kit/contracts": "0.1.2"
   },
   "scripts": {
+    "clean": "rm -rf dist",
     "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "npm run clean && npm run build",
     "test": "vitest run"
   },
   "devDependencies": {