# Policy Versioning

1const policy = await api.policies.get('production-policy');
2
3console.log(policy._version);     // 3
4console.log(policy._hash);        // SHA256 hash
5console.log(policy._created_at);  // Timestamp
6
7// List all versions
8const versions = await api.policies.listVersions('production-policy');
9
10// Get a specific version
11const v1 = await api.policies.getVersion('production-policy', 1);

1// Compare versions
2const diff = await api.policies.diff('production-policy', 1, 2);
3
4console.log(diff);
5// {
6//   added: [{ id: 'new-rule', ... }],
7//   removed: [{ id: 'old-rule', ... }],
8//   modified: [{
9//     before: { id: 'rule-1', priority: 50, ... },
10//     after: { id: 'rule-1', priority: 100, ... }
11//   }]
12// }

1// Rollback to a previous version
2// This creates a new version with the old content
3const rolledBack = await api.policies.rollback('production-policy', 1);
4
5console.log(rolledBack._version);  // 4 (new version)
6
7// The policy content matches version 1
8// but version history is preserved

1import { PolicyStore } from '@solongate/sdk';
2
3// Initialize with file-based storage
4const store = new PolicyStore({
5  path: './policies',
6  format: 'json',  // or 'yaml'
7});
8
9// Save a policy (creates new version)
10await store.save(policy);
11
12// List versions
13const versions = store.listVersions('my-policy');
14
15// Get specific version
16const v2 = store.getVersion('my-policy', 2);
17
18// Diff versions
19const diff = store.diff('my-policy', 1, 2);
20
21// Rollback
22store.rollback('my-policy', 1);